5分钟上手 Claude Code Router：让 Claude Code 接入 DeepSeek 的多模型路由教程-编程实验室

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 Router（CCR）是一个本地多模型路由网关，把 Claude Code、Codex 等 Agent 的模型请求统一收到一个本地端点，由你决定每个请求走哪家供应商、哪个模型，并支持回退、凭据池和请求日志。这篇 ccr 配置教程带你把安装、最小配置和按场景分配模型一次走完。

CCR 是什么：模型请求的本地"总机"

CCR 的定位是本地控制平面：Agent 只管把请求发到http://127.0.0.1:3456，CCR 负责把请求解析到正确的上游供应商和模型，并在过程中提供重试、失败回退、Token 用量和成本估算。如果你现在要在每个 Agent 的配置里分别维护 Base URL 和 API Key，或者请求发出去后根本不知道实际命中了哪个模型，CCR 解决的就是这两件事。

上图是桌面端主界面，左侧导航覆盖供应商、路由、Agent 配置、日志等入口。更完整的说明可以看仓库里的官方文档。

🚀 3分钟装好并启动 CCR

这一节解决"怎么最快看到效果"。CLI 方式要求 Node.js 22 或更高版本，三条命令完成安装和启动：

node --version npm install -g @musistudio/claude-code-router ccr ui

ccr ui会拉起后台服务并打开浏览器管理界面，地址是http://127.0.0.1:3458；模型网关默认监听http://127.0.0.1:3456。在界面里按顺序做三件事：添加一个供应商和模型，在"API 密钥"页创建访问网关用的客户端 Key，再到"服务"页点启动。状态显示运行中即算跑通——发一个最小模型请求，"日志"页就能看到实际命中的供应商、模型和耗时。

⚙️ 给供应商填好 4 个核心字段

这一节解决"配置到底要写什么"。CCR 现在的配置存在本机 SQLite（macOS/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
长文档、大日志 → 长上下文模型

如果模型页里给每个模型填了一句话 Description，CCR 还会把它注入到 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 的子代理流量加一条路由规则，切到更便宜的模型，然后在概览页对比两者的成本差。凭据池和失败回退要不要上，等你看到日志里的成本分布再决定。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

5分钟上手 Claude Code Router：让 Claude Code 接入 DeepSeek 的多模型路由教程