Claude Code路由器：智能任务分发工具

感谢 Kimi 对本项目的赞助！Kimi K3 是 Moonshot AI 目前能力最强的模型，也是全球首个开放的 3T 级模型。K3 拥有 2.8 万亿参数、原生视觉能力和 100 万 token 的上下文窗口，在长周期编程、知识工作和推理任务上展现出前沿性能。在 CCR 中，Kimi 已作为内置的 provider 预设提供：只需一键导入按量付费 API 或 Kimi Code 订阅，即可将 coding agent 的请求路由到 Kimi。订阅 endpoint 会以原生方式直通，无需进行协议转换；API endpoint 会自动适配；账户余额和订阅用量也可以直接在 CCR dashboard 中查看。

CCR 已经内置 Kimi provider 预设。你可以访问 Kimi Open Platform（中文站｜Global）体验 API，也可以了解 Kimi Code 订阅。

在一个地方管理所有 Agent 和 provider。

将 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 以及兼容的 API client 连接到你选择的 provider，然后通过一个应用对每个请求进行路由、故障转移、能力扩展和观测。

为什么使用 Claude Code Router？

Claude Code Router（CCR）是一个面向 coding agent 的本地模型网关与控制平面。它为 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 以及兼容的 API client 提供一个稳定的本地 endpoint，同时让你能够在一个地方统一管理其背后的 provider、模型、账户、路由规则和工具。

统一管理所有 Agent 和 provider，无需再为每个 client 分别维护一套模型配置。

无需改变现有工作流，也不用反复编辑 Agent 配置文件，就能切换 provider 或模型。

通过重试、凭据池、密钥轮换和有序 fallback 模型，让请求持续稳定运行。

利用 Fusion vision、web search、MCP 工具和 ToolHub，为现有模型扩展能力。

通过请求日志、最终解析出的路由、延迟、token 用量、成本估算和账户状态，了解每次请求实际发生了什么。

CCR 支持 OpenAI Chat / Responses、Anthropic Messages、Gemini Generate Content / Interactions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、Bailian，以及自定义的兼容 provider。

桌面应用（推荐）

下载适用于 macOS、Windows 或 Linux 的 Claude Code Router，然后启动应用。Windows、Linux、macOS（Apple Silicon）、macOS（Intel）

打开 Providers → Add Provider。选择内置预设或自定义 endpoint，输入 API key，选择协议和模型，然后保存。

打开 Providers → Add Provider。选择内置预设或自定义 endpoint，输入 API key，选择协议和模型，然后保存。

打开 Server 并点击 Start。默认情况下，本地模型网关监听 http://127.0.0.1:3456。

打开 Server 并点击 Start。默认情况下，本地模型网关监听 http://127.0.0.1:3456。

打开 Agent Config，选择 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi 或 ZCode，再选择一个模型并应用该 profile。

打开 Agent Config，选择 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi 或 ZCode，再选择一个模型并应用该 profile。

开始使用你的 Agent。打开 Logs，确认最终解析出的 provider、模型、状态、token、延迟和错误信息。

开始使用你的 Agent。打开 Logs，确认最终解析出的 provider、模型、状态、token、延迟和错误信息。

现在，你的 Agent 已经连接到 CCR。若要添加条件、重试、请求重写或 fallback 模型，请打开 Routing。

npm CLI 要求使用 Node.js 22 或更高版本。它会启动相同的网关，以及一个基于浏览器的管理 UI，无需 Electron：

npm install -g @musistudio/claude-code-router
ccr ui

打开 http://127.0.0.1:3458，然后按照上文相同的 Providers → Server → Agent Profiles 流程操作。模型网关仍位于 http://127.0.0.1:3456。有关服务模式、身份验证和 profile 命令，请参阅 CLI 参考文档。

docker compose up -d --build

默认情况下，Docker 会通过 http://127.0.0.1:3458 暴露管理 UI 和网关路由。在远程开放 CCR 之前，请先阅读 Docker 部署指南。

安装 Node.js 22+，然后运行 npm ci。

Windows 应用的打包必须在 Windows x64 上运行，因为 better-sqlite3 附带原生 Electron 模块。当推送 v* tag 时，release workflow 会分别使用 macOS runner 构建 macOS 版本，并使用 windows-latest 构建 Windows 版本。

Claude Code · Claude Design · Codex · Grok CLI · Kimi CLI · Kilo Code · OpenCode · Pi · ZCode · Compatible API clients
                              │
                              ▼
                 Claude Code Router :3456
          Profiles · Routing · Credentials · Tools · Logs
                              │
                              ▼
             Selected provider, model, and account

准备好后，进一步深入了解

完整文档位于 ccrdesk.top。

安装并启动 CCR

探索路由与配置

排查常见问题

如果你觉得这个项目有帮助，请考虑赞助其开发。非常感谢你的支持。

衷心感谢所有赞助者的慷慨支持。

如果你的名字被隐藏，请通过我主页上的电子邮箱与我联系，以便将其更新为你的 GitHub 用户名。

本项目采用 MIT License。