cc-router

简体中文 · 繁體中文 · 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 提供，不对任何因使用造成的直接或间接损失负责，包括但不限于额度异常消耗、数据丢失、业务中断。

cc-router 是独立的第三方开源项目，与 Anthropic 无任何关联，未获其授权或背书，也不是 Claude / Claude Code 的官方应用。文中提及的 Anthropic、Claude、Claude Code 均为 Anthropic 的商标，仅用于说明兼容对象。

架构与请求走向一览：

 Claude Code  OpenCode   pi ...      Codex ...           Open WebUI ...      你的代码 / Agent 框架
      |           |         |            |                      |                      |
      -----------------------            |                      |                      |
                 |                       |                      |                      |
             Anthropic                OpenAI                 OpenAI                   Jev
           Messages API            Responses API      Chat Completions API        System One
          (/v1/messages)          (/v1/responses)    (/v1/chat/completions)     (/v1/systemone)
                 |                       |                      |                      |
                 -----------------------------------------------------------------------
                                                    |  入口 · 虚拟模型
                                                    |
                                                cc-router
                                         (本地 127.0.0.1:23456)
                                                    |
                                                    |  出口 · 真实模型
              ------------------------------------------------------------------------------
              |          |          |          |          |          |          |          |
          DeepSeek      GLM       Kimi     Anthropic   OpenAI     Gemini       Jev      ......
             API      Coding     Coding    Messages  Responses &    API    System One
                       Plan       Plan        API    Completions

功能亮点：

• 入口三协议，工具随便接 —— 同时开放 Anthropic Messages / OpenAI Responses / OpenAI Chat Completions 三个端点，Claude Code、Codex、OpenClaw、Hermes Agent、Kimi Code、ZCode、Cherry Studio 等无需改造直接接入；另有 /v1/systemone 入口专供 Jev（System One）决策模型，走独立的虚拟模型 model-jev
• 出口三协议，订阅一站调度 —— 内置 24 家厂商预设（DeepSeek、Qwen、Kimi、MiMo、MiniMax、GLM、Claude、OpenAI、Gemini 等），任何 Anthropic / OpenAI / Gemini 兼容端点也能直接配进来
• 聚合所有模型Token —— 顺序 / 轮询 / 会话亲和、自动切换、故障转移
• 用量小票 —— token 用量一键导出成一张「超市小票」样式的消费凭证，晒图、留档都方便
• 四语完整翻译 —— 简体中文 / 繁體中文 / English / 日本語，可跟随系统或在设置页手动切换
• 桌面 / 网页 / 终端三种界面 —— 除了桌面 GUI，还能在浏览器里打开与桌面完全相同的网页界面，或用终端 TUI 界面在命令行里管理订阅、查看实时路由与请求日志
• 虚拟模型多别名 —— 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 聚合的多家订阅，详见配置教程

接入指南

下方这些 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 等，还有很多。

安装使用

1. 从下表下载对应平台的安装包并安装。
2. 添加各家厂商的订阅，给虚拟模型绑定真实模型并选好调度模式。
3. 把生成的配置粘到 Claude Code 等工具里即可使用。

两个地址内容完全相同，中国大陆用户选「中国下载」更快。链接始终指向最新版本，历史版本见 Releases。Linux 推荐 AppImage，支持应用内自动更新；deb 需手动重新下载升级。

在 Claude Code 中使用

{
  "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 协议的工具。

虚拟模型和别名：

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

入口与出口

cc-router 夹在你的工具和大模型厂商中间：工具从入口连进来，请求从出口发给厂商。两头各支持三种主流大模型接口，可以任意组合——比如 Codex 从 OpenAI Responses 入口进来，最终由 DeepSeek 的 Anthropic 端点作答。另有一条 Jev（System One）决策模型的专用通道，入口和出口都是 /v1/systemone，原样透传。

入口：你的工具怎么连 cc-router

三个对话入口共用同一套订阅、虚拟模型、限额与会话亲和；第四个入口 /v1/systemone 专供 Jev 决策模型，只调度 model-jev。请求日志的「入口接口」一栏能看到每条请求从哪个入口进来。按你的工具支持的协议展开对应一节：

Anthropic Messages /v1/messages —— Claude Code、Claude Desktop、OpenCode、OpenClaw、pi、Kimi code cli 等

• 这是主入口，请求原样透传不做协议翻译，thinking、output_config.effort、cache_control、图片、工具调用全部按 Anthropic 原生语义工作。
• Claude Code 的完整 env 示例见上方「在 Claude Code 中使用」；Claude Desktop 需要本地 HTTPS，见配置教程。