Claude Code Router（CCR）
一个本地控制平面，统一管理所有AI代理：路由、故障转移、扩展和观测。
- Star 数
- ★ 38k
- 最近更新
- 9 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用Claude Code的开发者希望无需修改配置文件即可切换到不同模型或提供者。
- 不适合
- 仍在使用 Node.js 22 以下版本的环境
- 希望开箱即用、不愿配置路由与凭据池的用户
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Claude Code Router（CCR）是一个本地模型网关，为Claude Code、Claude Design、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode等代理提供一个稳定的本地端点（默认http://127.0.0.1:3456）。它支持OpenAI Chat/Responses、Anthropic Messages、Gemini、OpenRouter、DeepSeek等协议，并支持自定义端点。CCR提供直观的桌面应用（macOS、Windows、Linux）、CLI（通过npm）和Docker部署。核心功能包括提供者预设、模型发现、路由规则、重试、凭据池、键轮换、回退模型、Fusion视觉、网络搜索、MCP工具和ToolHub。它提供详细的请求日志、延迟、令牌使用、成本估算和账户状态。项目采用MIT许可证，并有活跃的社区和赞助支持。
CCR作为本地代理运行，拦截来自多个AI代理的API请求，并根据配置的路由规则将其转发到所选的提供者。它提供路由规则、凭据池、重试、回退模型、请求改写和条件匹配。它支持Fusion模型（视觉、网络搜索、MCP工具）和ToolHub，通过插件扩展功能。它记录请求和响应，包括解析的提供者、模型、凭据、状态、延迟、令牌、成本和工具调用。它支持通过AgentClaw通过微信、企业微信、Slack、Discord、Telegram、LINE、飞书和钉钉进行代理中继。
- 使用Claude Code的开发者希望无需修改配置文件即可切换到不同模型或提供者。
- 同时使用多个AI代理（如Claude Code和Codex）的团队，希望统一管理所有代理的模型配置和凭据。
- 需要高可用性的用户，通过重试、凭据池和回退模型确保请求不中断。
- 需要向现有模型添加视觉、网络搜索或MCP工具功能的用户，使用Fusion和ToolHub。
- 需要详细审计请求日志、成本和性能指标的组织。
- 需要在企业通信平台（如Slack或钉钉）中通过AgentClaw中继代理请求的用户。
如何安装或部署这个 Agent？
桌面应用：从GitHub Releases下载适用于macOS、Windows或Linux的安装包并启动。CLI：确保Node.js 22+，运行npm install -g @musistudio/claude-code-router，然后执行ccr ui。Docker：克隆仓库并运行docker compose up -d --build。
如何使用这个 Agent？
启动CCR后，打开Providers → Add Provider，选择内置预设或自定义端点，输入API密钥，选择协议和模型。启动服务器（默认http://127.0.0.1:3456）。在Agent Config中选择你的代理（如Claude Code），选择模型并应用配置文件。然后正常使用你的代理；打开Logs查看解析的提供者、模型、状态、令牌、延迟和错误。在Routing中配置条件、重试、请求改写和回退模型。
这个 Agent 有哪些优点和局限？
- 集中管理多个代理和提供者，减少配置碎片化。
- 支持内置预设和自定义端点，兼容多种协议（OpenAI、Anthropic等）。
- 提供重试、凭据池、键轮换和回退模型，增强请求可靠性。
- 通过Fusion和ToolHub扩展模型能力，支持视觉、搜索和MCP工具。
- 提供详细日志和成本估算，增强可观测性。
- 活跃的社区和赞助支持，持续开发。
- 桌面应用需要安装Electron应用，占用系统资源。
- CLI需要Node.js 22或更高版本，可能不适合旧环境。
- 依赖第三方API密钥和订阅，存在提供商锁定风险。
- 高级路由和插件配置需要学习曲线。
- 某些功能（如AgentClaw）需要额外配置外部服务。
- 文档大部分为英文，中文资源有限。
这个 Agent 与同类方案有什么区别？
类似工具如LiteLLM和OpenRouter，但CCR专注于本地控制平面和代理管理，不依赖云服务。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code Router（CCR） 当前 | 51 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 38k | 9 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| Puppetmaster | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 468 | 今天 | Python | Codex · Claude Code |
| ccxray | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 296 | 1 天前 | JavaScript | Claude Code · Claude API |
| Runtm | 63 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 302 | 2 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示项目提供了本地网关、API密钥管理、路由规则和日志功能，但未明确说明权限最小化、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚和来源归属的具体实现。因此，这些标准仅部分满足，得分为1。
项目包含单元测试和架构测试，表明一定的一致性，但依赖可用性和失败消息的详细程度不足，因此得分为1或2。
项目面向多种代理和提供商，提供了丰富的配置选项，但能力边界和触发精度未详细说明，因此得分为2。
项目提供了详细的README、安装说明、示例和文档，但已知限制和变更日志不明确，因此得分为2。
项目提供了多种功能，如路由、故障转移、日志等，但成本效益和输出可用性未量化，因此得分为2。
项目提供了测试和文档，但声明与证据的对应关系不明确，且缺乏外部验证，因此得分为1。
- 未验证发布者身份，需谨慎对待。
- 依赖项未明确安全审计，需检查供应链风险。
- 敏感数据处理细节未公开，需确认API密钥存储安全。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Highlights - Rebuild the bundled model catalog and publish it to [models.ccrdesk.top](https://models.ccrdesk.top/models.json). The catalog refreshes from the CDN at startup and hourly, with bundled and cached data available offline. - Improve routing script token estimation, gateway restart recovery, and raw trace delivery. - Fix Codex session affinity, protocol-specific provider aliases, and upstream streaming resets. - Add the Y-API provider preset and bound OpenRouter catalog requests with a timeout. What's Changed …在 GitHub 查看 ↗ -
发布说明摘录
Highlights - Fix Codex workspace launching and network requirements handling, and preserve approval reviewer settings. - Protect configuration saves against stale concurrent edits and preserve provider capabilities, routing rules, and fallback settings. - Bundle the gateway regression fixes in every release: valid Anthropic tool IDs and replay histories, complete Fusion traces, and accurate upstream HTTP status and headers. - Improve fallback error details, Anthropic reasoning compatibility, OpenCode Go cache usage, and live OAuth credential refresh during model discovery and requests. …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * fix(gateway): surface per-attempt failure details in aggregate error messages by @zeal-up in https://github.com/musistudio/claude-code-router/pull/1773 * fix(gateway): raise and make configurable the core config-acceptance timeout by @fszcd in https://github.com/musistudio/claude-code-router/pull/1794 * fix(usage): price routed models instead of rule aliases (#1787) by @cpruijsen in https://github.com/musistudio/claude-code-router/pull/1790 …在 GitHub 查看 ↗
常见问题
CCR是否会降低请求速度？
我可以在没有桌面应用的情况下使用CCR吗？
ccr ui）提供基于浏览器的管理界面，Docker部署也可用。