本地 AI API 代理软件
支持多平台 AI API 监控与调试的跨平台桌面应用
| 首页 | 调用日志 | 请求详情 |
|---|---|---|
 |
 |
 |
cc-look.mp4
如果视频无法播放，请直接查看 resources/cc-look.mp4
CC Look 是一个本地 AI API 代理软件，帮助开发者更方便地调用、监控和调试各平台的 AI API。
在调用 AI API 时，经常会遇到以下问题：
- 🤔 界面卡住，不确定是在输出还是真的卡住了
- 🔍 无法实时查看 API 调用的状态和内容
- 📝 缺乏统一的日志记录和调试工具
- 🔑 多个平台需要分别管理 API Key
CC Look 通过提供本地代理服务，让您可以：
- ✅ 实时监控 AI API 的输出内容
- ✅ 查看完整的请求/响应日志
- ✅ 统一管理多个 AI 平台配置
- ✅ 支持 OpenAI 和 Anthropic Claude 协议
- 支持添加多个 AI 平台配置
- 支持 OpenAI 协议和 Anthropic Claude 协议
- 自定义 API Base URL（支持代理/中转服务）
- 统一代理端口，通过路径前缀区分不同平台
- 一键启动/停止代理
- 自动处理 API 认证头
- 支持 SSE 流式响应
- 请求/响应自动记录
- 实时显示流式响应内容
- 连接状态指示器
- 输出速度监控（Token/s）
- 首 Token 时间统计
- 完整的请求/响应记录
- 支持按平台筛选
- 日志导出（JSON/CSV）
- 调用统计
- 主题切换（浅色/深色/跟随系统）
- 日志保留策略与存储大小查看
- 清空日志功能
- 代理端口配置
- 开机自启动
- 动态浮动窗口
- macOS 10.15+ 或 Windows 10+
- Node.js 18+
从 Releases 页面下载对应平台的安装包。
# 克隆仓库
git clone https://github.com/onekb/cc-look.git
cd cc-look
# 安装依赖
npm install
# 开发模式运行
npm run dev
# 构建生产版本
npm run build:mac # macOS
npm run build:win # Windows-
添加平台
- 点击「添加平台」按钮
- 填写平台名称、协议类型、API URL 和路径前缀
- 例如：智谱 AI，路径前缀
/bigmodel
-
启动代理
- 点击「启动服务」按钮
- 代理服务将在
http://localhost:5005启动
-
配置应用
OpenClaw 用户：
- 修改
~/.openclaw/agents/main/agent/models.json中的baseUrl配置 - 将 baseUrl 改为
http://localhost:5005/{路径前缀}
Claude Code / CC Switch 用户：
- 配合 CC Switch 使用，30秒完成配置！
- 操作视频：
- 修改
cc-look-used.mp4
CC Look HTTP Proxy（通用 HTTP/HTTPS 代理）
如果你不想逐个修改各平台的 baseUrl，可以直接将 CC Look 作为 HTTP 代理使用：
- 在 CC Look 中启动代理服务（默认端口
5005） - 在你的客户端工具（如 CC Switch、自定义脚本、IDE 插件等）中配置 HTTP Proxy 为
http://localhost:5005 - 无需修改原本的任何 API 请求地址，CC Look 会自动拦截并代理所有经过的流量
- 同时支持 CONNECT 隧道，可代理 HTTPS 请求（CC Look 会使用内置的 MITM CA 证书自动解密并记录请求内容）
这种方式适合需要代理大量已有配置、统一通过 CC Look 做监控和调试的场景。
CC Switch 代理配置方法：
- 打开 CC Switch，点击「设置 → 代理 → 本地代理」
- 将以下选项全部启用：
- 「在主页显示本地代理开关」
- 「代理总开关」
- 「代理启用」下的所有可开启选项
- 服务地址的端口号不要和 CC Look 的代理端口（默认
5005）冲突 - 页面最下方的「全局出库代理」配置为 CC Look 的代理地址，例如
http://127.0.0.1:5005/，然后点击保存
其他工具 用户：
- 酌情修改
baseUrl，或配置 HTTP Proxy 为http://localhost:5005
- 监控调用
- 在「调用日志」页面查看实时请求和历史记录
- 支持复制 curl 命令、导出日志等功能
cc-look/
├── src/
│ ├── main/ # Electron 主进程
│ │ ├── index.ts # 主进程入口
│ │ ├── ipc/ # IPC 通信处理
│ │ │ └── index.ts
│ │ ├── database/ # 数据存储层
│ │ │ └── index.ts
│ │ └── proxy/ # 代理服务
│ │ └── index.ts
│ │
│ ├── renderer/ # React 前端
│ │ ├── index.html
│ │ ├── main.tsx
│ │ ├── App.tsx
│ │ ├── pages/ # 页面组件
│ │ │ ├── Platforms.tsx
│ │ │ ├── Logs.tsx
│ │ │ └── Settings.tsx
│ │ ├── components/ # UI 组件
│ │ │ └── Sidebar.tsx
│ │ ├── stores/ # 状态管理
│ │ │ └── platform.ts
│ │ └── styles/ # 样式文件
│ │ └── index.css
│ │
│ ├── preload/ # 预加载脚本
│ │ └── index.ts
│ │
│ └── shared/ # 共享代码
│ └── types.ts # 类型定义
│
├── resources/ # 资源文件
│ ├── icon.png # 应用图标
│ ├── logo.svg # Logo
│ └── *.jpg # 截图
│
├── package.json
├── electron.vite.config.ts
├── tailwind.config.cjs
└── tsconfig.json
| 技术 | 用途 |
|---|---|
| Electron | 跨平台桌面应用框架 |
| React | 前端 UI 框架 |
| TypeScript | 类型安全 |
| Vite | 构建工具 |
| TailwindCSS | 样式方案 |
| Zustand | 状态管理 |
| Express | 本地代理服务器 |
| sql.js | 本地数据库 |
# 开发模式
npm run dev
# 类型检查
npm run typecheck
# 构建
npm run build
# 打包 macOS
npm run build:mac
# 打包 Windows
npm run build:win- 在
src/shared/types.ts中添加新的协议类型 - 在
src/main/proxy/index.ts中实现代理逻辑 - 更新前端表单以支持新协议选项
- 主进程日志：在终端查看
- 渲染进程日志：打开 DevTools (开发模式下自动打开)
- 数据库文件：
~/Library/Application Support/cc-look/cc-look.db(macOS)
- API Key 存储：API Key 存储在本地 SQLite 数据库中，不会上传到任何服务器
- 本地通信：所有代理通信都在本地进行，不经过第三方服务器
- 日志数据：请求/响应日志仅存储在本地，可随时清除
这是 macOS 的安全机制导致的，执行以下命令即可解决：
sudo xattr -dr com.apple.quarantine /Applications/CC\ Look.app欢迎贡献代码、报告问题或提出建议！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
本项目采用 MIT 许可证 - 详见 LICENSE 文件
- 所有开源项目的贡献者
- Breadbot86 这是我家龙虾，它会帮我宣传。同时它自己维护的项目会在它的账号里更新，欢迎拜访。