用途
Claude Code Router（CCR）是一个本地模型网关与控制平面，面向编码智能体。它为 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy 以及兼容 API 客户端提供一个稳定的本地端点，同时在一个地方管理提供商、模型、账户、路由规则与工具。
主要能力
- 集中管理所有智能体与提供商，无需为每个客户端维护独立的模型配置。
- 切换提供商或模型时无需改变工作流，也无需反复编辑智能体配置文件。
- 通过重试、凭证池、密钥轮换与有序回退模型保持请求持续运行。
- 为现有模型增加 Fusion 视觉、网页搜索、MCP 工具与 ToolHub 等能力。
- 通过请求日志、已解析路由、延迟、Token 用量、成本估算与账户状态查看实际发生的情况。
- 支持 OpenAI Chat / Responses、Anthropic Messages、Gemini Generate Content / Interactions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、Bailian 及自定义兼容提供商。
使用方式
桌面应用（推荐）
- 下载适用于 macOS、Windows 或 Linux 的 Claude Code Router，然后启动应用。
- 打开 Providers → Add Provider。选择内置预设或自定义端点，输入 API 密钥，选择协议与模型，然后保存。
- 打开 Server 并点击 Start。本地模型网关默认监听 http://127.0.0.1:3456。
- 打开 Agent Config，选择 Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 或 WorkBuddy，选择模型并应用配置。
- 开始使用智能体。打开 Logs 确认已解析的提供商、模型、状态、Token、延迟与错误。
此时智能体已连接到 CCR。如需添加条件、重试、请求重写或回退模型，打开 Routing。
npm CLI
npm CLI 需要 Node.js 22 或更高版本。它启动相同的网关和基于浏览器的管理界面，不依赖 Electron： 打开 http://127.0.0.1:3458，然后遵循与上文相同的 Providers → Server → Agent Profiles 流程。模型网关仍位于 http://127.0.0.1:3456。服务模式、认证与配置文件命令请参阅 CLI 参考文档。
Docker
Docker 默认通过 http://127.0.0.1:3458 暴露管理界面与网关路由。当 ../../next-ai/gateway 存在时，npm 脚本会在构建镜像前准备支持插件的本地 ai-gateway 运行时。在远程暴露 CCR 之前，请阅读 Docker 部署指南。
构建桌面应用
安装 Node.js 22+，然后运行 npm ci。 Windows 应用打包必须在 Windows x64 上运行，因为 better-sqlite3 附带原生 Electron 模块。发布工作流在推送 v* 标签时，在 macOS 运行器上构建 macOS，在 windows-latest 上构建 Windows。
适用场景
- 需要为多个编码智能体或 API 客户端统一管理模型提供商与路由。
- 希望在切换提供商或模型时不修改各智能体配置。
- 需要通过重试、凭证池、密钥轮换与回退模型提升请求可靠性。
- 需要为现有模型扩展视觉、网页搜索、MCP 工具等能力。
- 需要查看请求日志、路由解析、延迟、Token 用量、成本估算与账户状态。
限制与说明
- npm CLI 需要 Node.js 22 或更高版本。
- Windows 应用打包必须在 Windows x64 上运行。
- 远程暴露 CCR 之前需阅读 Docker 部署指南。
- 完整文档位于 ccrdesk.top。项目基于 MIT 许可证。
