**CC Models** 名称取自 Claude Code 缩写拼接 Models,寓意依托代码能力,可自由调度、适配多款 AI 模型,实现多模型灵活调用使用。
**CC Models** 由 DeepSeek + Claude Code 全自动编码开发,全程无人工代码编写。作为开源 AI 模型代理网关与桌面管理应用,以本地 HTTP 代理形式转发各类 AI 命令行工具请求,可对接多模型服务商,兼具用量统计、会话管理、预算告警等功能。简单说:一个应用管理所有 AI 工具。
- 统一代理 — 本地
127.0.0.1:15721,接收 Claude Code、Codex、Gemini CLI、OpenClaw、Hermes、OpenCode 等工具的请求 - 智能路由 — 按 CLI 工具将请求转发到不同供应商,支持故障自动切换
- 格式转换 — Anthropic Messages → OpenAI Chat Completions、Google Gemini → OpenAI 格式互转
- 实时流式转发 — SSE 流透传,保持低延迟
- 供应商管理 — 添加/编辑/启停供应商(OpenAI、Anthropic、DeepSeek、SiliconFlow 等 30+ 预设)
- 一键配置 — 自动写入各 CLI 工具的配置文件,无需手动编辑
- 会话历史 — 记录所有 CLI 工具的会话,回放对话内容
- 使用统计 — 每日/每月 Token 消耗和费用图表
- 预算告警 — 设置月度预算上限,超阈值通知
- 模型对比 — 同一个问题发送给多模型,并列对比输出
- 速度测试 — 测试各供应商的响应延迟
- 智能推荐 — 根据使用习惯推荐最佳模型
- MCP 管理 — 添加/启停 MCP 服务器
- Skills & Prompts — 自定义技能和提示词模板
- 广告位 — 可配置的展示广告
- 多主题 — 浅色/深色主题切换
- 国际化 — 中英文界面
- Web 管理面板 — 浏览器访问的后台管理界面
- 系统供应商管理 — 增删改查系统级供应商
- 系统设置 — 网站信息、版本号等配置
- 数据同步 — 桌面端可选将使用数据同步到服务端
- 广告推送 — 管理端配置广告,推送到桌面客户端
| 仪表盘 | 供应商管理 |
|---|---|
| Dashboard | Providers |
| 会话历史 | 使用统计 |
从 Releases 下载对应系统安装包(GitHub Actions 构建产物)。
| 平台 | 格式 |
|---|---|
| Windows | MSI 安装包 |
| macOS | DMG (Intel + Apple Silicon) |
| Linux | AppImage / deb / rpm |
- 安装后启动 CC Models
- 在「供应商」页面添加 API 供应商(如 DeepSeek、OpenAI)
- 点击「配置」按钮,自动配置你使用的 CLI 工具
- 正常使用你的 CLI 工具即可 — 所有请求会经过代理路由到对应供应商
| 工具 | 配置路径 |
|---|---|
| Claude Code | ~/.claude/settings.json |
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Codex | ~/.codex/config.toml |
| Gemini CLI | ~/.gemini/.env |
| OpenClaw | ~/.openclaw/openclaw.json |
| OpenCode | ~/.config/opencode/opencode.jsonc |
| Hermes Agent | ~/.hermes/config.yaml |
后端服务主要用于 Web 管理面板和广告同步,桌面端核心功能完全离线可用。
# 使用 Docker Compose 一键部署
docker compose up -d
# 初始化管理员账号(首次部署执行)
docker compose exec server npx prisma db seed
# 访问 http://你的服务器IP:3000
# 管理员账号: admin / 通过 ADMIN_PASSWORD 环境变量设置详细部署说明见 docs/deploy-linux.md。
cc-models/
├── apps/
│ ├── desktop/ # Electron 桌面应用
│ │ ├── src/
│ │ │ ├── main/ # 主进程
│ │ │ │ ├── proxy/ # 代理网关核心
│ │ │ │ │ ├── index.ts # 代理入口 + 请求/响应转换
│ │ │ │ │ ├── router.ts # 路由解析
│ │ │ │ │ ├── failover.ts # 故障切换
│ │ │ │ │ └── logger.ts # 日志记录
│ │ │ │ ├── config-manager/ # CLI 工具配置管理
│ │ │ │ ├── database/ # SQLite 数据库模块
│ │ │ │ ├── mcp-manager/ # MCP 进程管理
│ │ │ │ ├── speed-test/ # 速度测试
│ │ │ │ ├── sync/ # 云端同步
│ │ │ │ └── ... # 窗口、托盘、更新器等
│ │ │ └── renderer/ # 渲染进程(React UI)
│ │ │ ├── pages/ # 页面组件
│ │ │ └── components/ # 通用组件
│ │ └── electron-builder.yml # 打包配置
│ ├── server/ # NestJS 后端
│ │ ├── src/
│ │ │ ├── modules/ # 功能模块(auth/sync/usage/session...)
│ │ │ └── main.ts # 入口(含 SPA 托管)
│ │ └── prisma/ # 数据库 schema
│ └── web/ # Web 版 SPA(独立部署)
│ └── src/
│ ├── pages/ # 页面组件
│ └── api.ts # API 客户端
├── packages/
│ └── shared/ # 公共类型、常量、国际化
├── docs/ # 文档
└── pnpm-workspace.yaml # Monorepo 配置
CLI 工具 (Claude Code / Codex / Gemini CLI ...)
│
▼ HTTP 请求
127.0.0.1:15721 (CC Models 代理)
│
├── 工具识别(按请求路径/UA)
├── 路由解析(按工具选择供应商)
├── 格式转换(Anthropic/Google → OpenAI 格式)
├── 故障切换(供应商不可用时自动切换)
└── 日志记录(Token、费用、会话)
│
▼ HTTP 请求
目标供应商 API (DeepSeek / OpenAI / Anthropic ...)
# 克隆
git clone https://github.com/sohu0025/ccmodels.git
cd cc-models
# 安装依赖
pnpm install
# 开发模式
pnpm dev
# 构建
pnpm build| 层 | 技术 |
|---|---|
| 桌面框架 | Electron 33 |
| 前端 | React 18 + TypeScript + Tailwind CSS 4 + DaisyUI 5 |
| 后端 | NestJS 10 + Fastify + Prisma |
| 数据库 | SQLite(本地)/ MySQL(可选云端) |
| 构建 | Turborepo + pnpm workspace |
| 包管理 | pnpm |
| 图标 | @lobehub/icons |
MIT License
- 大象中转API — 合作伙伴