5分钟上手 Claude Code Router让 Claude Code 接入 DeepSeek 的多模型路由教程【免费下载链接】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 派出一堆子代理做全库搜索每个请求都打在主力贵模型上而真正擅长重构的推理模型却在旁边吃灰。Claude Code RouterCCR是一个本地多模型路由网关把 Claude Code、Codex 等 Agent 的模型请求统一收到一个本地端点由你决定每个请求走哪家供应商、哪个模型并支持回退、凭据池和请求日志。这篇 ccr 配置教程带你把安装、最小配置和按场景分配模型一次走完。CCR 是什么模型请求的本地总机CCR 的定位是本地控制平面Agent 只管把请求发到http://127.0.0.1:3456CCR 负责把请求解析到正确的上游供应商和模型并在过程中提供重试、失败回退、Token 用量和成本估算。如果你现在要在每个 Agent 的配置里分别维护 Base URL 和 API Key或者请求发出去后根本不知道实际命中了哪个模型CCR 解决的就是这两件事。上图是桌面端主界面左侧导航覆盖供应商、路由、Agent 配置、日志等入口。更完整的说明可以看仓库里的官方文档。 3分钟装好并启动 CCR这一节解决怎么最快看到效果。CLI 方式要求 Node.js 22 或更高版本三条命令完成安装和启动node --version npm install -g musistudio/claude-code-router ccr uiccr ui会拉起后台服务并打开浏览器管理界面地址是http://127.0.0.1:3458模型网关默认监听http://127.0.0.1:3456。在界面里按顺序做三件事添加一个供应商和模型在API 密钥页创建访问网关用的客户端 Key再到服务页点启动。状态显示运行中即算跑通——发一个最小模型请求日志页就能看到实际命中的供应商、模型和耗时。⚙️ 给供应商填好 4 个核心字段这一节解决配置到底要写什么。CCR 现在的配置存在本机 SQLitemacOS/Linux 位于~/.claude-code-router旧版config.json只作为迁移来源读取一次所以不必手写文件在供应商页添加即可。核心就 4 个字段{ name: deepseek, api_base_url: https://api.deepseek.com, api_key: sk-your-key, models: [deepseek-chat, deepseek-reasoner] }name是路由规则和日志里引用供应商的前缀api_base_url决定请求实际发往哪里api_key没有配置凭据池时的默认凭据models是暴露给 CCR 的模型 ID 列表路由规则和 Agent 的/models只能看到这里的模型。保存后建议点检测连通性它会发一次真实请求验证 Key、模型名和协议比事后排查省时。 给不同任务分配不同模型这一节解决路由策略怎么排。路由的价值在于别让最贵的模型干所有活一份常见的分工清单是这样的在路由页设置默认模型和规则日常编码主请求 →deepseek/deepseek-chat后台子代理搜索、摘要、并行小任务→ 更便宜的快模型大规模重构、跨文件推理 →deepseek/deepseek-reasoner长文档、大日志 → 长上下文模型如果模型页里给每个模型填了一句话 DescriptionCCR 还会把它注入到 Claude Code 的 Agent/Task 工具说明中让 Claude Code 派生子代理时自己挑模型并打上标签子请求会自动改道无需你逐条写规则。让路由脚本自己判断条件规则只能做单字段匹配要看懂用户话术就用 Node.js 脚本规则。最短写法如下返回null表示不命中、继续下一条规则if (!input.summary.lastUserText.includes(explain this code)) { return null; } return { model: deepseek/deepseek-reasoner };脚本在独立 worker 里执行input是只读的完整请求对象编辑器支持构造测试请求试跑。完整字段说明见路由文档。️ 出问题先查这里这一节把常见故障和调优合并处理每条按现象→原因→动作收口Agent 没走 CCR→ 服务没跑或配置没应用 → 服务页确认运行中从Agent 配置入口启动 Agent 并确认作用范围覆盖当前项目。model not found→ 供应商模型列表、路由规则、Agent 配置三处的模型名不一致 → 逐一对齐成同一个 ID。401 / 403→ 凭据问题而非路由问题 → 核对 Key 和 Base URL再用检测连通性确认。端口被占用→ 默认端口冲突 → CCR 会自动尝试后续端口并打印实际地址也可以显式ccr ui --port 3460。请求超时→ 上游慢或 timeout 太短 → 到日志页看耗时定位卡在哪一段再调大对应超时。更多案例在常见问题文档里按症状分组。跑通之后最值钱的下一步是给 Claude Code 的子代理流量加一条路由规则切到更便宜的模型然后在概览页对比两者的成本差。凭据池和失败回退要不要上等你看到日志里的成本分布再决定。【免费下载链接】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），仅供参考