musistudio/claude-code-router

Claude Code Router (CCR)

是什么 – 一个本地网关和控制平面桌面（及CLI）应用程序，可将数十个面向编码的AI代理（Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode、WorkBuddy等）视为使用同一API。您只需一次配置提供方（OpenAI、Anthropic、Gemini、Moonshot、Kimi、Mistral、自定义端点等），即可将任何支持的客户端指向 http://127.0.0.1:3456。

为何值得关注

• 单一真实源：API密钥、模型选择和路由规则的统一管理。
• 零代码切换提供方：无需修改每个代理的配置，即可更换模型或备用提供方。
• 可靠性功能：自动重试、凭证池、密钥轮换、有序回退。
• 可观测性：实时日志显示已解析的提供方、模型、Token使用量、延迟、成本估算和工具调用。
• 可扩展性：支持“Fusion”视觉模型、网络搜索、自定义工具，以及“ToolHub”以增强额外功能。
• 多平台支持：提供Windows/macOS/Linux的Electron桌面应用、纯Node CLI（npm i -g @musistudio/claude-code-router），以及Docker Compose部署。

工作原理（高层次流程）

[代理（Claude Code、Codex等）] → CCR网关（localhost:3456）
    ├─ 配置文件 – 每个代理的配置（模型、环境、作用域）
    ├─ 路由 – 条件性重写、重试、回退
    ├─ 凭证 – 提供方预设、密钥池
    └─ 工具 – Fusion视觉、网络搜索、自定义插件
        ↓
[选定的提供方端点]（OpenAI、Anthropic、Kimi等）

快速入门

1. 从GitHub发布页面下载适用于您操作系统的桌面二进制文件（Windows .exe、macOS .dmg、Linux .AppImage）。
2. 打开应用，添加提供方预设或自定义端点，粘贴API密钥并保存。
3. 点击 Server → Start – 网关将在 127.0.0.1:3456 启动。
4. 在 Agent Config 中选择您想要的代理（例如 Claude Code），并选择一个模型配置文件。
5. 像平常一样运行代理；CCR将路由请求并记录详细信息。

CLI替代方案 – 安装 npm i -g @musistudio/claude-code-router 后，运行 ccr ui 启动相同的Web UI（默认地址为 http://127.0.0.1:3458）。Docker用户可运行 docker compose up -d 启动UI和网关。

核心功能

领域	您可获得的功能
代理	10+个编码代理的预设配置文件、模型覆盖、多实例工作流
提供方	OpenAI、Anthropic、Gemini、Moonshot、Kimi、Mistral、OpenRouter、DeepSeek等内置预设；支持自定义端点
路由	条件路由规则、请求/响应重写、重试策略、有序回退
工具与扩展	Fusion视觉模型、网络搜索、浏览器自动化、Chrome登录导入、插件架构
可观测性	每个请求的详细日志，包含提供方、模型、Token数量、延迟、估算成本、工具调用
访问控制	带配额、过期时间、每请求限制的本地客户端密钥
AgentClaw	将代理转发至聊天平台（WeChat、Slack、Discord、Telegram、LINE、Feishu、DingTalk）

文档与支持 – 完整指南、API参考和故障排除文档托管于 ccrdesk.top。README中列出了Discord社区和赞助链接。

许可证 – 项目仓库采用MIT许可证发布。

---

以上所有信息均直接取自项目README；未推断任何额外功能。