Claude Code Router:多 Agent 多模型统一路由入口,三步接入指南
【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router
Claude Code、Codex、Kimi CLI 同时在跑,每个都配着不同的 base URL 和 API Key。想换成便宜点的模型,得挨个翻配置文件改;某个 Key 限流了,就只有一个 Agent 悄悄挂掉。
Claude Code Router(CCR)是个本地模型网关,就是为了解决这件事:所有 Agent 的请求都发往同一个本地入口127.0.0.1:3456,背后由哪个供应商、哪个模型处理,交给路由配置决定。
两条命令拉起本地网关
CLI 方式要求 Node.js 22+,先全局安装:
npm install -g @musistudio/claude-code-router再启动网关和浏览器管理界面:
ccr ui打开http://127.0.0.1:3458,按「供应商 → 服务 → Agent 配置档案」走一遍:选内置的供应商预设(DeepSeek、OpenRouter、Moonshot 等都有),填 API Key,启动服务,再把 Claude Code、Codex 等绑定到目标模型。想部署到服务器,docker compose up -d --build也可以直接起,细节见 Docker 部署指南。
三个值得先试的路由能力
- 条件路由与回退:按请求头和请求体内容命中不同模型,失败后自动重试、按顺序切换回退模型。说白了,一个 Key 限流不再拖垮整个 Agent。
- Fusion 组合模型:把文本模型和视觉、联网搜索、MCP 工具拼成列表里可直接选择的新模型,老模型也能获得看图、查资料的能力。
- 请求日志:记录每次请求最终落到哪个供应商和模型、token 数、耗时与成本估算,花了多少钱、花在哪个模型上一目了然,路由配置文档里有完整的条件字段说明。
谁不必折腾
只有一个 Agent、且只用一份官方订阅的话,加这一层只会让链路变长,直连官方更省事。CCR 的价值出现在多 Agent、多 Key、多供应商,或者想按任务贵贱混用模型的场景;如果你只是想把某一个模型换成便宜点儿的 API,直接改环境变量就够了。
回到开头的麻烦:现在换模型、接限流、查成本都在一个本地面板里完成,Agent 侧配置不用动。建议先接一个官方订阅加一个低成本 API 两个供应商跑几天,翻一遍日志里的成本分布,再决定要不要把路由规则铺满。
【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考