Skip to content

sohu0025/ccmodels

Repository files navigation

CC Models

一站式 AI 模型网关 & 桌面管理工具

License Electron TypeScript NestJS Prisma

**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 流透传,保持低延迟

桌面管理 (Electron)

  • 供应商管理 — 添加/编辑/启停供应商(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

使用方式

  1. 安装后启动 CC Models
  2. 在「供应商」页面添加 API 供应商(如 DeepSeek、OpenAI)
  3. 点击「配置」按钮,自动配置你使用的 CLI 工具
  4. 正常使用你的 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


相关项目

About

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages