cc-router

本地运行的大模型聚合网关，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 ...      Open WebUI / Cherry Studio ...
      |             |           |         |         |                         |
      -------------------------------------         |                         |
                        |                           |                         |
                    Anthropic                    OpenAI                    OpenAI
                  Messages API                Responses API         Chat Completions API
                 (/v1/messages)              (/v1/responses)       (/v1/chat/completions)
                        |                           |                         |
                        -------------------------------------------------------
                                                  |  入口 · 虚拟模型
                                                  |
                                              cc-router
                                        (本地 127.0.0.1:23456)
                                                  |
                                                  |  出口 · 真实模型
           -----------------------------------------------------------------------------
           |            |            |            |            |            |          |
       DeepSeek        GLM         Kimi       Anthropic     OpenAI       Gemini     ......
          API        Coding       Coding      Messages    Responses &      API
                      Plan         Plan          API      Completions

功能亮点：

• 入口三协议，工具随便接 —— 同时开放 Anthropic Messages / OpenAI Responses / OpenAI Chat Completions 三个端点，Claude Code、Codex、OpenClaw、Hermes Agent、Kimi Code、ZCode、Cherry Studio 等无需改造直接接入
• 出口三协议，订阅一站调度 —— 内置 24 家厂商预设（DeepSeek、Qwen、Kimi、MiMo、MiniMax、GLM、Claude、OpenAI、Gemini 等），任何 Anthropic / OpenAI / Gemini 兼容端点也能直接配进来
• 聚合所有模型Token —— 顺序 / 轮询 / 会话亲和、自动切换、故障转移
• 用量小票 —— token 用量一键导出成一张「超市小票」样式的消费凭证，晒图、留档都方便
• 三语完整翻译 —— 简体中文 / 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 聚合的多家订阅，详见配置教程

接入指南

下方这些 AI Agent / Coding Agent 工具都能接入 cc-router，用上你手里的全部大模型 Plan：

安装使用

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-5.6-sol gpt-6-sol gpt-5.6-sol-20261201 都命中 sol 档（terra/luna/mini 同理）。

入口与出口

cc-router 夹在你的工具和大模型厂商中间：工具从入口连进来，请求从出口发给厂商。两头各支持三种主流大模型接口，可以任意组合——比如 Codex 从 OpenAI Responses 入口进来，最终由 DeepSeek 的 Anthropic 端点作答。

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

三个入口共用同一套订阅、虚拟模型、限额与会话亲和，请求日志的「入口接口」一栏能看到每条请求从哪个入口进来。按你的工具支持的协议展开对应一节：

• 这是主入口，请求原样透传不做协议翻译，thinking、output_config.effort、cache_control、图片、工具调用全部按 Anthropic 原生语义工作。
• Claude Code 的完整 env 示例见上方「在 Claude Code 中使用」；Claude Desktop 需要本地 HTTPS，见配置教程。
• 会话亲和优先按 x-claude-code-session-id 请求头、其次 metadata.user_id 识别会话。
• 在订阅编辑页为某条订阅开启「透传客户端请求头」后，anthropic-beta / anthropic-version 等白名单头会原样转发给该上游，按订阅单独设置，默认关闭。

~/.codex/config.toml 片段（设置页「集成」可一键写入并自动备份原文件，之后用 codex -p cc-router 启动）：

[model_providers.cc-router]
name = "cc-router"
base_url = "http://127.0.0.1:23456/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

[profiles.cc-router]
model_provider = "cc-router"
model = "model-sonnet"

• 请求在内部翻译为 Anthropic Messages：instructions 与 developer 消息并入 system，reasoning.effort 映射为 thinking 预算，max_output_tokens 映射为 max_tokens（缺省 4096，并会自动抬高到覆盖 thinking 预算）。
• reasoning 双向：上游的 thinking 以带签名的 reasoning item 返回，客户端下一轮原样回传即可保持多轮推理上下文。