公告 土豆居合斩 QQ 交流群已开放 / 欢迎进群交流功能建议、产品想法、数据问题和使用反馈
AI AI聚合站资源、商品与社区聚合平台
返回项目目录
finch-xu

finch-xu

cc-router

本地运行的大模型聚合网关，GUI桌面端app，零代码部署，把Coding Plan、大模型 API 额度聚合成一个虚拟 Plan，一键接入 Claude Code、Claude Desktop App、OpenClaw、OpenCode 等工具。Bundle your scattered Token Plan, Coding Plan, and LLM API quotas into a single virtual Plan, and plug it into Claude Code, Claude Desktop App, OpenClaw, OpenCode, and more.

SkillAgent模型 / 推理AI 编程agentic-aianthropiccc-switchclaude-codecoding-plandeepseek
查看 GitHub 项目主页
Stars
220
Forks
22
Watchers
220
Issues
7

README

项目介绍

18724 bytes

cc-router logo

cc-router

License: MIT Tauri 2 Rust 1.88+ React 19 TypeScript 5 Tailwind CSS Platform

中文 · English · 日本語

📖 中文文档 · 📖 English Docs · 📖 日本語ドキュメント · 🤖 DeepWiki · 🌐 官方网站ccrouter.app

本地运行的大模型聚合网关，GUI桌面端app，零代码部署，把零散的 Token Plan、Coding Plan、大模型 API 额度聚合成一个虚拟 Plan，一键接入 Claude Code、Claude Desktop App、OpenClaw、OpenCode、Codex 等工具 —— 省钱！省 Token！完全本地运行！

注意⚠️ 本工具仅限于自动切换订阅套餐，请求体几乎完全透传，不涉及逆向、不涉及破解等操作。用户需自行遵守每个编程套餐的使用规则。此工具只能用于 Claude Code 等编程工具，切勿用于其他用途。

各家 provider 的 ToS 不一定明确允许"订阅 Key 接第三方代理 + 多虚拟模型混调度"的用法，尤其是 Coding Plan / Token Plan 这类 per-seat 订阅，可能触发风控。因使用本工具导致账号被限速、被封禁、订阅被取消的，作者不承担任何责任。

本软件按 As-Is 提供，不对任何因使用造成的直接或间接损失负责，包括但不限于额度异常消耗、数据丢失、业务中断。

架构与请求走向一览：

 Claude Code     OpenCode      OpenClaw     pi ...            Codex ...
      |              |             |           |                  |
      ------------------------------------------                  |
                          |                                       |
               Anthropic Messages API                   OpenAI Responses API
                   (/v1/messages)                          (/v1/responses)
                          |                                       |
                          -----------------------------------------
                                              |
                                          cc-router
                                   (本地 127.0.0.1:23456)
                                              |
      -----------------------------------------------------------------------------------
      |             |             |             |             |             |           |
  DeepSeek         GLM          Kimi        Anthropic      OpenAI        Gemini      ......
     API         Coding        Coding       Messages     Responses &       API
                  Plan          Plan           API       Completions

功能亮点：

  • 19 家 provider 一站调度 —— 内置 DeepSeek、Qwen、Kimi、MiMo、MiniMax、GLM、Claude、Gemini 等 Token Plan / Coding Plan / API 额度,opus / sonnet / haiku 三槽位任意搭配,顺序 / 轮询 / 会话亲和自动切换
  • 任意自定义端点 —— 内置厂商不够时,把任何 Anthropic Messages 兼容、Gemini generateContent / Gemini Interactions 兼容、OpenAI Responses / Chat Completions 兼容的 API 直接配进来,与内置订阅同等调度
  • 用量小票 —— token 消费快照一键导出 PNG / PDF / HTML,黑白 / 彩色双模式,默认不显示价格只展示用量,扫底部二维码即跳仓库
  • 三语完整翻译 —— 简体中文 / English / 日本語,可跟随系统或在设置页手动切换
  • 虚拟模型多别名 —— fable / opus / sonnet / haiku 四个槽位各识别多种命名,以 opus 为例,model-opus / claude-opus-4-7 / anthropic/model-opus / anthropic/claude-opus-4-7 都路由到同一虚拟模型,工具用什么命名都不挑
  • 本地 HTTPS —— 一键生成自签 CA 与服务器证书,让只支持 HTTPS 的客户端也能接入 cc-router,详见配置教程
  • 接入 Claude Desktop App —— 借助本地 HTTPS 与虚拟模型别名,Anthropic 官方桌面端可直接走 cc-router 聚合的多家订阅,详见配置教程
  • 双协议 API 入口 —— Anthropic /v1/messages 与 OpenAI /v1/responses 两套端点并行,Claude Code / Codex 等 Anthropic 与 OpenAI 生态的客户端都能一键接入
cc-router 实时路由页截图 cc-router 虚拟模型配置页截图 cc-router 用量小票长图
cc-router 用量小票页截图 cc-router 请求日志页截图

接入指南

下方的 AI Agent / Coding Agent 工具都支持接入cc-router并使用你的所有大模型plan。

Claude Code cli · Claude Desktop App · OpenAI Codex cli · OpenAI Codex Desktop App · OpenCode · OpenClaw · Kimi code cli · pi coding agent 等等还有好多。

支持的编程套餐和API

id 名称 Token Plan API 兼容性
anthropic Anthropic 官方 API（仅按量付费，不含 Plan） ❌ ✅ verified
openai_codex OpenAI Codex (ChatGPT Plus/Pro 订阅) 有封号风险，不推荐使用 ✅ ❌ tested
kiro Kiro IDE (AWS) 免费 Claude 订阅额度，灰色地带有封号风险，不推荐使用 ✅ ❌ tested
google_ai_studio Google AI Studio (Gemini) 按量付费 + 免费 quota ❌ ✅ verified
google_gemini_interactions Google Gemini (Interactions API) 新统一接口 /v1beta/interactions（协议翻译） ❌ ✅ partial
zhipu 智谱 GLM（按量付费/中国订阅） ✅ ✅ verified
deepseek DeepSeek（按量付费） ❌ ✅ verified
moonshot Moonshot Kimi（按量付费/中国订阅/国际订阅） ✅ ✅ untested
minimax MiniMax（按量付费/中国订阅/国际订阅） ✅ ✅ verified
xiaomi 小米 MiMo（按量付费/中国订阅/国际订阅） ✅ ✅ verified
alibaba 阿里云百炼（Token Plan 团队版 + 按量付费 2 地域 + 停售的 Coding Plan） ✅ ✅ verified
volcengine 字节跳动 火山方舟（Coding Plan 订阅 + Agent Plan 订阅 + 按量付费） ✅ ✅ untested
openrouter OpenRouter 聚合平台（500+ 模型路由） ❌ ✅ untested
tencent 腾讯云大模型（Token Plan 订阅 + TokenHub 按量付费境内/境外） ✅ ✅ untested
aiberm Aiberm（按量付费 API，模型按 token group 动态返回） ❌ ✅ untested
whatai 神马中转 API（按量付费，OpenAI/Anthropic 双协议中转，仅用 Anthropic 路径） ❌ ✅ untested
ollama Ollama 本地推理（仅 localhost:11434，含云端模型 tag 如 glm-4.7:cloud） ❌ ✅ partial
fireworks Fireworks AI（按量付费/国际订阅Fire Pass） ✅ ✅ verified
stepfun 阶跃星辰（按量付费/中国订阅/国际订阅） ✅ ✅ untested
baidu 百度千帆（按量付费/中国订阅） ✅ ✅ untested
modelscope 魔搭 ModelScope（按量付费） ❌ ✅ partial
ucloud 优云智算 UCloud Modelverse（Coding Plan 订阅 + 按量付费 API 国内/海外） ✅ ✅ untested
openai OpenAI 官方 API（按量付费，含 GPT-5 / o3 / 4.1 等 reasoning 模型，自动翻译 Anthropic thinking ↔ OpenAI reasoning） ❌ ✅ untested
xai xAI Grok（按量付费，含 Grok 4.5 / 4.3，官方 Anthropic 兼容端点） ❌ ✅ untested
自定义 自定义任意Anthropic协议API ✅ ✅ verified
自定义 (Gemini 兼容) 接入任意 Gemini generateContent 兼容端点（中转站等），messages_path 用 {model} 占位符 ❌ ✅ tested
自定义 (Gemini Interactions 兼容) 接入任意 Gemini Interactions API /v1beta/interactions 兼容端点（Google 新统一接口 / 兼容中转站），自动协议翻译；与旧 generateContent 不同，model 在请求 body 里，无需 {model} 占位符 ❌ ✅ partial
自定义 (OpenAI Responses 兼容) 接入任意 OpenAI /v1/responses 兼容端点（one-api / new-api 等中转站），自动协议翻译 ❌ ✅ tested
自定义 (OpenAI Chat Completions 兼容) 接入任意 OpenAI /v1/chat/completions 兼容端点（DeepSeek / Together / Groq / Ollama / one-api / new-api 等中转站），自动协议翻译，DeepSeek R1 等模型的 reasoning_content 暴露为 Claude Code thinking 块 ❌ ✅ tested

Token Plan 列包含各厂商的套餐订阅形态（Token Plan / Coding Plan / Agent Plan 等）；API 列指按量付费的 Anthropic Messages 兼容端点。

社区可 PR 补充。

技术栈

  • Tauri 2
  • Tailwind 4
  • React 19

安装使用

  1. 在release里下载客户端并安装。
  2. 配置多厂商的大模型，配置虚拟模型对应的真实模型和调度模式。
  3. 配置到Claude Code中使用。

macOS 上 cc-router 的 Dock 图标随窗口显隐：窗口打开时 Dock 有图标、可 Cmd+Tab 切换；关闭窗口后图标消失，入口只剩屏幕右上角的菜单栏。关闭窗口只是隐藏，代理会继续运行；要再打开窗口，点菜单栏图标、或在 Spotlight 里再搜一次 cc-router 即可。彻底退出请用菜单栏图标 →「退出 cc-router」。

在 Claude Code 中使用

设置 页会动态显示完整的 env snippet；默认端口被占用时自动 +1 递增。

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "your token, show in this app settings",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "model-fable",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "model-fable",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL": "model-opus",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

当OPUS_MODEL支持1m上下文的时候，可以设置为model-opus[1m]以获得Claude code工具的完整上下文支持。

也兼容 LiteLLM 风格的 anthropic/ 前缀：anthropic/model-opus / anthropic/model-sonnet / anthropic/model-haiku 等同于无前缀写法，方便接入需要带 provider 前缀才能识别 Anthropic 协议的工具。

虚拟模型和别名：

虚拟模型 别名
model-fable anthropic/model-fable anthropic/claude-fable* claude-fable* gpt-5.6 gpt-*-sol openai/gpt-5.6 openai/gpt-*-sol
model-opus anthropic/model-opus anthropic/claude-opus* claude-opus* gpt-5.5 gpt-*-terra openai/gpt-5.5 openai/gpt-*-terra
model-sonnet anthropic/model-sonnet anthropic/claude-sonnet* claude-sonnet* gpt-5.4 gpt-*-luna openai/gpt-5.4 openai/gpt-*-luna
model-haiku anthropic/model-haiku anthropic/claude-haiku* claude-haiku* gpt-*-mini openai/gpt-*-mini

claude-opus* 的含义是模糊匹配，你可以传入任意符合规则的模型名，都会被归一为虚拟模型model-opus，比如 claude-opus-4-8 claude-opus-4-7-20260101 claude-opus-100 都没问题。gpt-*-sol 这类按档位段匹配：gpt-5.6-sol gpt-6-sol gpt-5.6-sol-20261201 都命中 sol 档（terra/luna/mini 同理）。

常见问题&使用场景

cc-router 解决了什么问题？ **没有 cc-router 时**：AI Agent（Claude Code / OpenCode 等）一次只能接一家厂商，小额度订阅在关键时刻断流，得手动切配置——体验糟糕。 **接上 cc-router 后**：Agent → cc-router → 厂商 A + B + C，自动负载均衡、自动故障转移，三家订阅当一家用。 收益： - **省钱** —— 不必买昂贵的大额 Coding Plan，两个小额度拼起来就够用 - **不断流** —— 限流 / 失败自动切换，Agent 无感 - **混搭顶配** —— GLM-5.1、DeepSeek-V4-Pro、MiniMax-2.7、MiMo-V2.5-Pro 同时上桌，也能掺 Claude Opus、GPT-5.5 这类原生 API - **用量统一** —— 所有订阅 token 消费一屏看完，可一键导出小票 model-opus / model-sonnet / model-haiku 三个虚拟模型是干啥的？ Claude Code 按任务难度分三档：opus 做规划、sonnet 写代码、haiku 跑工具调用。 cc-router 把这三档抽象成 `model-opus` / `model-sonnet` / `model-haiku` 三个虚拟槽位，每个槽位绑一组真实模型 + 调度模式： - `model-opus` → DeepSeek-V4-Pro + GLM-5.1（轮询） - `model-sonnet` → MiniMax-M2.7 + MiMo-V2.5-Pro（轮询） - `model-haiku` → GLM-4-Flash CC 请求来了就按映射转发，不用再频繁改 `~/.claude/settings.json`。 有多个 Coding Plan 怎么搭配？ 举例：订阅 A = GLM-5 / MiniMax-2.7 / DeepSeek-Flash，订阅 B = DeepSeek-V4-Pro / MiniMax-2.7 / GLM-5。 - **稳妥派**：把两边的同档模型一起绑进对应槽位，效果一致、容灾好 - **激进派**：把两边各自的顶配模型都塞进 `model-opus` 轮询，交叉使用大概率 `1 + 1 ≥ 2` 调度模式：顺序、轮询还是会话亲和？ - **顺序** —— 用完 A 再切 B。命中缓存好、能榨干小额度订阅，**推荐给两个小额 GLM Coding Plan 这类场景** - **轮询** —— 两家均衡分担。但跨账号的缓存是独立的，会多吃额度，换来的是真正的负载均衡 - **会话亲和** —— 同一个 Claude Code 会话固定用同一家订阅、不同会话轮流分配。既像轮询一样均衡，又不丢 prompt cache；并发子代理也能共用缓存。订阅限流/失败时自动换家。**多家订阅都健康、又在意缓存命中时推荐。**

开发

依赖：Node.js ≥ 20（推荐 pnpm），Rust ≥ 1.88（建议直接用 rustup 最新 stable），Xcode CLT（macOS）。

pnpm install
pnpm tauri dev      # 启动开发模式（同时运行前端 + Rust 后端 + 代理）

首次启动 app 会进入 onboarding：

  1. 添加一个订阅（选厂商 → 选接入点 → 填 API Key → 自动抓取模型列表）
  2. 一键把订阅绑定到三个虚拟模型
  3. 复制 Claude Code 环境变量配置，粘到你的 ~/.claude/settings.json

添加新provider

如果你使用Claude Code，我提供了一个SKILL，可以执行new-provider并附加provider的官方文档或接口地址等信息，能够自动创建provider的配置。

打包

pnpm tauri build

产出：src-tauri/target/release/bundle/ 下对应平台的安装包。

Windows 开发环境注意事项

在 Windows 上开发或打包遇到问题时展开（能省几小时） **1. 必须用 MSVC toolchain，不能用 GNU** Tauri 在 Windows 上打包依赖 MSVC，CI 用的也是 `x86_64-pc-windows-msvc`。确认： 
rustup show          # active toolchain 应带 -msvc 后缀
rustc --version      # 应 ≥ 1.88
**2. 需要 Visual Studio Build Tools** MSVC toolchain 依赖 C++ 编译器和 Windows SDK，缺了会报 `link.exe not found`。装 [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/) 时勾选「使用 C++ 的桌面开发」工作负载，装完重开终端。 **3. `rustc --version` 和 `rustup show` 对不上？查 PATH** 若曾用 msi / scoop / Visual Studio 组件装过独立 Rust，它可能排在 rustup shim 之前，导致 `rustup default stable` 说什么都不生效： 
Get-Command rustc, cargo -All | Select-Object Source
`Source` 应指向 `%USERPROFILE%\.cargo\bin`。否则把该目录提到 PATH 最前（`rundll32 sysdm.cpl,EditEnvironmentVariables`），或卸掉那份独立安装。 **4. dev server 端口残留** Ctrl+C 常杀不干净 `tauri dev` 的进程树，再次启动会报 `Port 1420 is already in use`（`strictPort: true` 刻意不自动换端口，因为 `devUrl` 写死了 1420）： 
Get-NetTCPConnection -LocalPort 1420 -State Listen |
  Select-Object -ExpandProperty OwningProcess -Unique |
  ForEach-Object { Stop-Process -Id $_ -Force }

图标

Provider 品牌 logo 来自 @lobehub/icons（MIT）。各品牌商标归原所有者所有。

证书

MIT