开发与工程 model-routingprovider-gatewaycodexgrok-clikimi-clitool-orchestrationobservability

Claude Code Router(CCR)

一个本地控制平面,统一管理所有AI代理:路由、故障转移、扩展和观测。

FollowAgents 评估 · FARS-2.1
不推荐
51/ 100 五分制 2.6 / 5
1 2 3 4 5 6
1信任安全10 / 29 · 1.7/5

证据显示项目提供了本地网关、API密钥管理、路由规则和日志功能,但未明确说明权限最小化、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚和来源归属的具体实现。因此,这些标准仅部分满足,得分为1。

2可靠稳定6 / 14 · 2.1/5

项目包含单元测试和架构测试,表明一定的一致性,但依赖可用性和失败消息的详细程度不足,因此得分为1或2。

3适用触发12 / 18 · 3.3/5

项目面向多种代理和提供商,提供了丰富的配置选项,但能力边界和触发精度未详细说明,因此得分为2。

4规范维护11 / 18 · 3.1/5

项目提供了详细的README、安装说明、示例和文档,但已知限制和变更日志不明确,因此得分为2。

5有效结果9 / 13 · 3.5/5

项目提供了多种功能,如路由、故障转移、日志等,但成本效益和输出可用性未量化,因此得分为2。

6证据核验3 / 8 · 1.9/5

项目提供了测试和文档,但声明与证据的对应关系不明确,且缺乏外部验证,因此得分为1。

证据充分度: 评估于 2026年8月9日 审查版本 47f36494317a
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 未验证发布者身份,需谨慎对待。
  • 依赖项未明确安全审计,需检查供应链风险。
  • 敏感数据处理细节未公开,需确认API密钥存储安全。
查看完整评分方法 →

这个 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、飞书和钉钉进行代理中继。

  1. 使用Claude Code的开发者希望无需修改配置文件即可切换到不同模型或提供者。
  2. 同时使用多个AI代理(如Claude Code和Codex)的团队,希望统一管理所有代理的模型配置和凭据。
  3. 需要高可用性的用户,通过重试、凭据池和回退模型确保请求不中断。
  4. 需要向现有模型添加视觉、网络搜索或MCP工具功能的用户,使用Fusion和ToolHub。
  5. 需要详细审计请求日志、成本和性能指标的组织。
  6. 需要在企业通信平台(如Slack或钉钉)中通过AgentClaw中继代理请求的用户。

这个 Agent 有哪些优点和局限?

优点
  • 集中管理多个代理和提供者,减少配置碎片化。
  • 支持内置预设和自定义端点,兼容多种协议(OpenAI、Anthropic等)。
  • 提供重试、凭据池、键轮换和回退模型,增强请求可靠性。
  • 通过Fusion和ToolHub扩展模型能力,支持视觉、搜索和MCP工具。
  • 提供详细日志和成本估算,增强可观测性。
  • 活跃的社区和赞助支持,持续开发。
局限
  • 桌面应用需要安装Electron应用,占用系统资源。
  • CLI需要Node.js 22或更高版本,可能不适合旧环境。
  • 依赖第三方API密钥和订阅,存在提供商锁定风险。
  • 高级路由和插件配置需要学习曲线。
  • 某些功能(如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 与同类方案有什么区别?

类似工具如LiteLLM和OpenRouter,但CCR专注于本地控制平面和代理管理,不依赖云服务。

常见问题

CCR是否会降低请求速度?
CCR作为本地代理,增加一层网络跳转,但默认在回环地址运行,延迟极低。实际影响取决于路由规则和提供者性能。
我可以在没有桌面应用的情况下使用CCR吗?
是的,CLI(ccr ui)提供基于浏览器的管理界面,Docker部署也可用。
CCR支持哪些协议?
支持OpenAI Chat/Responses、Anthropic Messages、Gemini Generate Content/Interactions、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Kimi Code、Mistral、Z.AI、Bailian和自定义兼容提供者。
是否支持多个账户和凭据池?
是的,支持凭据池和键轮换,可用于负载均衡和故障转移。
如何调试路由问题?
通过Logs视图查看每个请求的解析提供者、模型、状态和错误,帮助调试。

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents