Claude Code Router(CCR)
一个本地控制平面,统一管理所有AI代理:路由、故障转移、扩展和观测。
证据显示项目提供了本地网关、API密钥管理、路由规则和日志功能,但未明确说明权限最小化、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚和来源归属的具体实现。因此,这些标准仅部分满足,得分为1。
项目包含单元测试和架构测试,表明一定的一致性,但依赖可用性和失败消息的详细程度不足,因此得分为1或2。
项目面向多种代理和提供商,提供了丰富的配置选项,但能力边界和触发精度未详细说明,因此得分为2。
项目提供了详细的README、安装说明、示例和文档,但已知限制和变更日志不明确,因此得分为2。
项目提供了多种功能,如路由、故障转移、日志等,但成本效益和输出可用性未量化,因此得分为2。
项目提供了测试和文档,但声明与证据的对应关系不明确,且缺乏外部验证,因此得分为1。
- 未验证发布者身份,需谨慎对待。
- 依赖项未明确安全审计,需检查供应链风险。
- 敏感数据处理细节未公开,需确认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、飞书和钉钉进行代理中继。
- 使用Claude Code的开发者希望无需修改配置文件即可切换到不同模型或提供者。
- 同时使用多个AI代理(如Claude Code和Codex)的团队,希望统一管理所有代理的模型配置和凭据。
- 需要高可用性的用户,通过重试、凭据池和回退模型确保请求不中断。
- 需要向现有模型添加视觉、网络搜索或MCP工具功能的用户,使用Fusion和ToolHub。
- 需要详细审计请求日志、成本和性能指标的组织。
- 需要在企业通信平台(如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 ui)提供基于浏览器的管理界面,Docker部署也可用。