README_zh.md
</a>
<sub>
<a href="https://www.kimi.com/code?aff=ccr"><strong>Kimi Code 订阅</strong></a>
·
<a href="https://platform.kimi.com?aff=ccr"><strong>API 中文站</strong></a>
·
<a href="https://platform.kimi.ai?aff=ccr">API Global</a>
</sub>
</td>
Claude Code Router Desktop 是给编程 Agent 用的本地控制平面。它为 Claude Code、Codex、Grok CLI、ZCode 以及兼容 API 客户端提供一个稳定的本地入口，然后由你在 CCR 中决定每个请求应该走哪个供应商、哪个模型、哪套路由策略、哪些工具能力和哪组账号凭据。
相比在每个 Agent、每个模型服务里反复改配置，CCR 把模型层收束到本机桌面应用里：供应商预设、自定义端点、凭据池、Fallback、Fusion 组合模型、MCP 工具、请求日志、账号用量和 Agent 启动配置都在一个地方管理。
<p align="center"> </p>| 目标 | CCR 提供的能力 |
|---|---|
| 保持 Agent 工作流不变，同时自由切换模型 | 为 Claude Code、Codex、Grok CLI、ZCode 创建本地配置档案，支持 CLI / App 启动入口和按配置选择模型 |
| 快速接入多个模型供应商 | 内置供应商预设、自定义 OpenAI / Anthropic / Gemini 兼容端点、协议探测、模型发现和连通性检测 |
| 把路由变成可配置策略 | 内置 Agent 路由、条件规则、请求改写、模型前缀路由、自动重试和 Fallback 模型链 |
| 控制成本和额度压力 | 凭据池、Key 轮换、本地限额、账号余额快照、Token / 成本仪表盘和托盘状态 |
| 给稳定模型补能力 | 通过 Fusion 给基础模型叠加视觉、联网搜索或指定 MCP 工具 |
| 让大量工具变得可用 | ToolHub 把多个 MCP server 收束成一个紧凑入口，让 Agent 按任务动态解析和调用工具 |
| 排查每一次请求 | 请求日志、最终供应商 / 模型、耗时、Token、成本估算、网络捕获和 Agent 观测链路 |
完整文档见 ccrdesk.top，其中包括 CLI 命令参考 和 Docker 部署指南。
Claude-Code-Router_<version>-mac-Apple-Silicon-arm64.dmg 或 .zipClaude-Code-Router_<version>-mac-Intel-x64.dmg 或 .zipClaude Code Router_<version>.exeClaude Code Router_<version>.AppImage~/.claude-code-router/config.sqlite%APPDATA%\claude-code-router\config.sqliteCCR 的运行配置存储在 SQLite 中。旧版 config.json 只会在没有 SQLite 配置时作为迁移来源读取一次。
从 服务 页面启动后，CCR 默认监听 http://127.0.0.1:3456。服务 页面负责配置网关 Host、Port、代理模式、系统代理、网络捕获和 CA 证书状态。
npm CLI 要求 Node.js 22 或更高版本，不依赖 Electron，也能提供浏览器管理界面、模型网关和 Agent 配置启动命令：
npm install -g @musistudio/claude-code-router
ccr ui
CLI 管理界面默认是 http://127.0.0.1:3458，模型网关默认是 http://127.0.0.1:3456。后台 / 前台服务、全部选项、Profile 启动、鉴权和数据位置见完整 CLI 参考。
如果要使用单一 Nginx 端口和持久化 Docker 数据卷运行管理 UI 与网关：
docker compose up -d --build
Docker 默认把管理和网关路径都发布在 http://127.0.0.1:3458。远程暴露前请先阅读 Docker 部署指南，其中包含内部端口拓扑、管理与网关鉴权、CCR_PUBLIC_BASE_URL、数据卷、备份恢复、升级和健康检查。
CCR 可以完全通过桌面 UI 完成配置。首次使用建议按下面顺序操作。
打开 供应商，点击 添加供应商，选择内置预设、导入支持的本机 Agent 登录态，或选择 其他 / 自定义 API 端点。按表单填写 Provider 名称、基础 URL、协议、API Key 和模型列表。可用时先运行协议探测和模型连通性检查，然后保存 Provider。
打开 路由，启用内置 Agent 路由，添加条件规则，配置请求改写和失败降级。如果需要更细粒度控制，使用 添加路由规则 添加模型前缀、请求条件或规则级失败降级目标。
打开 服务，点击 启动。页面显示运行中后，CCR 默认会在本机监听 http://127.0.0.1:3456。如果希望每次打开桌面应用时自动启动网关，可以启用自动启动。
打开 Agent配置，选择要使用的客户端。配置 Claude Code、Codex、Grok CLI 或 ZCode，选择目标模型和作用范围，然后应用配置。对于 App 入口，可以使用 打开 Agent 通过 CCR 打开目标应用。
到 设置 → 日志与观测 打开请求日志和 Agent 观测。使用 日志 确认 request model、resolved provider、resolved model、状态码、tokens、耗时和错误；使用概览仪表盘和托盘窗口查看 Token、成本、模型分布和账号状态。
对 Codex 的支持来自于 musistudio/codexl 这个项目。
</a>
<sub>通过 Ko-fi 单次赞助</sub>
</td>
<td align="center" width="220">
<a href="https://paypal.me/musistudio1999">
</a>
<sub>国际赞助通道</sub>
</td>
</td>
<td align="center" width="220">
<strong>微信支付</strong>
</td>
<strong>Z智谱</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://aihubmix.com/">
<strong>AIHubmix</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://ai.burncloud.com">
<strong>BurnCloud</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://share.302.ai/ZGVF9w">
<strong>302.AI</strong>
</a>
</td>
<strong>RunAPI</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://teamorouter.com/">
<strong>TeamoRouter</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://code0.ai/agent/register/9n9jOsSnYQoemIVL?utm_source=claudecoderouter&utm_medium=partner&utm_campaign=claudecoderouter_2026&utm_content=default">
<strong>code0.ai</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://console.claudeapi.com/agent/register/LbmB7Y9kPloyzhwF?utm_source=claudecoderouter&utm_medium=partner&utm_campaign=claudecoderouter_2026&utm_content=default">
<strong>claudeapi</strong>
</a>
</td>
<strong>七牛云 AI</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://api.fenno.ai/register?redirect=/purchase?tab=subscription%26group=16&aff=9HHHAB5QLAES">
<strong>Fenno.ai</strong>
</a>
</td>
<td align="center" width="330">
<a href="https://unity2.ai/register?source=claudecoderouter">
<strong>Unity2.Ai</strong>
</a>
</td>
<sub>如果你的名字被打码，请通过我的主页邮箱联系我更新为 GitHub 用户名。</sub>
</div>本项目基于 MIT License 发布。