CCR 三步接入 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 Router(下称 CCR)是本地中转层,把 Claude Code 的请求转发到 DeepSeek 等第三方模型。日常用 Claude Code、手里有多家模型额度、想本地集中管路由回退,适合你;只想一次性调 API 或打算换掉客户端,请绕道。
① 准备工作:一条命令装好 CCR
准备工作就三句话的事,装完马上能用。
- 先确认本机 Node.js 版本 ≥ 22,不够就先升。
- 用 npm 全局装 CCR 的 CLI:
npm install -g @musistudio/claude-code-router- 启动管理界面:
ccr ui浏览器打开http://127.0.0.1:3458,管理页面就在眼前。
② 首次配置:两页点完就能用
两页点完就能用,全程不碰代码。
供应商页
- 进 供应商 → 添加供应商,挑 DeepSeek 内置模板。
- API 地址默认
https://api.deepseek.com,协议走 OpenAI Chat Completions,都不用动。 - 粘贴 API 密钥,勾上
deepseek-chat和deepseek-reasoner两个模型。 - 点 检测连通性,确认 Key 和模型 ID 都能调通。
Agent 配置页
- 到 Agent 配置 加一条 Claude Code,选好默认模型。
- 直接从 CCR 启动 Claude Code,打通完成。
完整流程参考 Claude Code 接入文档,供应商细节看 供应商文档。
③ 路由对照表:四种场景各交给谁
四种活交给谁,一张表说清:
| 你手里的活 | 交给谁 | 为什么 |
|---|---|---|
| 日常问答 | deepseek/deepseek-chat | 响应快还便宜,高频对话首选 |
| 写代码 | deepseek/deepseek-chat | 代码任务够用,再搭条回退链更稳 |
| 复杂推理 | deepseek/deepseek-reasoner | 出结果慢但推理强,留给架构分析和拆难题 |
| 长上下文 | 另配长上下文模型 | 读大日志、长文档时切过去,防窗口截断 |
规则在 路由 页面配置,按列表顺序匹配,第一条命中的启用规则生效。优先级一句话:客户端显式指定的模型优先,没选或认不出的落到 Agent 默认模型,你写的自定义规则还能在最后一步改写。字段说明都在 路由文档。
④ 一次请求的完整路线:用过之后再懂原理
原理不复杂:请求绕道本机中转层,再由它挑上游。
Claude Code 发出的请求先落到本机http://127.0.0.1:3456的 CCR。它依据供应商、路由规则和凭据,决定这单发给哪个 API,响应再原路送回。你在 Claude Code 里的操作体验一点没变,换掉的只是上游供应商。
⑤ 进阶一:让消息内容决定走哪个模型
想让路由跟着消息内容走,普通条件规则不够,上 Node.js 脚本。把规则类型切到 Node.js 脚本,再指向一个本地脚本文件就行。文件每次执行前都会重新读取,改完不用重存规则;返回null表示不命中,自动看下一条。
const text = input.summary.lastUserText ?? ""; if (/def |function |class |import /.test(text)) { return { model: "deepseek/deepseek-chat" }; } if (/推理|证明|为什么/.test(text)) { return { model: "deepseek/deepseek-reasoner" }; } return null;⑥ 进阶二:子代理不再走默认模型
子代理也能挑模型,靠 Description 加一个标签。Claude Code 用 Agent / Task / Workflow 派生子代理时,你不想让它们全走默认模型:在 模型 页面给想被选中的模型填 Description,写清它适合什么任务。CCR 顺手把模型列表塞进 Claude Code 的工具说明里。派生请求的 prompt 首行会带上模型标签,CCR 看到标签直接路由过去:
<CCR-SUBAGENT-MODEL>deepseek/deepseek-reasoner</CCR-SUBAGENT-MODEL> 请给出这道题的完整推理步骤……⑦ 翻车现场三连
三条高频事故,照单自查。
一、推理模型超时
- 症状:难题一发,请求卡到超时失败。
- 原因:reasoner 出结果慢,默认超时兜不住。
- 怎么改:给这条路由规则单独调大超时,脚本规则支持 10–30000 毫秒。
- 怎么验证:发一条典型难题,看请求日志里的状态是否成功。
二、输出超模型 token 上限
- 症状:请求直接以错误返回。
- 原因:Claude Code 期望的输出 token 高于 DeepSeek 单次上限。
- 怎么改:在命中规则里加改写,把
request.body.max_tokens调小。 - 怎么验证:去日志里翻上游报错,一般会直接写明 token 限制。
三、改了配置不生效
- 症状:开关拨了,行为纹丝不动。
- 原因:十有八九没从 CCR 打开 Claude Code,或启用开关没拨开。
- 怎么改:从 CCR 重新启动 Claude Code,确认配置已启用。
- 怎么验证:打开请求日志,核对这条请求解析出的供应商和模型是否是你预期的组合,顺带确认
/model里能看到 CCR 暴露的模型。
一句话决策:多家模型额度加上天天用 Claude Code,就装 CCR 集中管路由与回退;只是偶尔试个 API,直接跳过。换上游就像换高速公路——车还是 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),仅供参考