Claude Code Router 三步接入 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
官方额度消耗得快,手里却压着一张 DeepSeek 的 Key?想让日常任务走便宜模型、难题再切到推理模型,最省事的路径是在本地架一层网关:Claude Code Router(ccr)常驻本机,按你配好的规则把 Claude Code 的请求路由到 DeepSeek 或其他模型 API,客户端侧无感知。
三步完成首次接入
- 安装 CLI。npm 包要求 Node.js 22 及以上,装完即可在终端直接使用
ccr:
npm install -g @musistudio/claude-code-router- 打开管理界面,添加供应商。执行下面命令会在浏览器拉起
127.0.0.1:3458的管理页,在「供应商」里选 DeepSeek 预设(API 地址已预填为 api.deepseek.com,走 OpenAI Chat Completions 协议),粘贴 Key,勾选deepseek-chat、deepseek-reasoner两个模型:
ccr ui- 接入 Claude Code。在「Agent 配置」里新增一条 Claude Code 配置并选好默认模型,再从 CCR 直接拉起 Claude Code,它的流量就会进入
127.0.0.1:3456的本地网关。完整步骤见 Claude Code 接入文档。
三个检查点确认路由生效
- 点供应商卡片上的「检测连通性」:Key 与所选模型 ID 都能调通时给出通过提示,先排除凭据问题。
- 在 Claude Code 里发一条普通消息,打开请求日志,核对该请求最终解析到的供应商与模型,应为
deepseek/deepseek-chat(或你指定的组合)。 - 客户端输入
/model,列表里应能看到 CCR 暴露的模型;看不到说明流量没走网关,前面的接入没接对。
请求的完整走向如下:
按任务类型选模型
| 任务类型 | 建议模型 | 理由 |
|---|---|---|
| 日常问答 | deepseek/deepseek-chat | 响应快、成本低,扛得住高频对话 |
| 写代码 | deepseek/deepseek-chat | 代码任务足够胜任,叠加回退链更稳 |
| 复杂推理 | deepseek/deepseek-reasoner | 出结果慢,留给架构分析和难题拆解 |
| 长上下文 | 另配长上下文模型 | 读大日志、长文档时切换,避免小窗口截断 |
规则在「路由」页面按列表顺序匹配,第一条命中的启用规则生效,各字段的详细说明见 路由文档。
进阶玩法:按内容分流与子代理独立控制
按消息内容分流。普通条件规则只能匹配单个字段,想做到"像代码任务走一个模型、像推理任务走另一个",把规则类型改为 Node.js 脚本并指向本地脚本文件。脚本在每次执行前重新读取,改完不用重存规则;多条脚本规则按列表顺序执行,返回null表示不命中,继续试下一条:
const text = input.summary.lastUserText ?? ""; if (/function |class |import |def /.test(text)) { return { model: "deepseek/deepseek-chat" }; } if (/推理|证明|为什么/.test(text)) { return { model: "deepseek/deepseek-reasoner" }; } return null;子代理单独指定模型。Claude Code 通过 Agent / Task / Workflow 派生子代理时默认沿用默认模型。给希望被自动挑选的模型在「模型」页面填写 Description(写清适合哪类任务),CCR 会把模型列表注入 Claude Code 的工具说明,派生请求的 prompt 首行随即携带模型标签,CCR 识别后直接路由过去:
<CCR-SUBAGENT-MODEL>deepseek/deepseek-reasoner</CCR-SUBAGENT-MODEL> 请给出这道题的完整推理步骤出问题时从这三处入手
推理模型请求超时返回失败,通常不是网络问题:deepseek-reasoner出结果慢,默认超时撑不住。处理办法是给对应路由规则单独调大超时,脚本规则可设 10–30000 毫秒。验证方式:发一条典型难题,到请求日志里确认状态为成功。
请求报错且上游信息直接提及 token 上限,原因是 Claude Code 期望的输出量超过了 DeepSeek 模型单次输出的最大值。处理办法是在命中规则里加一条改写,把request.body.max_tokens调小。验证方式:看日志中的上游错误信息,限幅值一般会被明确写出。
改了配置却仍走旧组合,最常见的原因是 Claude Code 没有从 CCR 拉起,或那条配置没启用。处理办法是重新从 CCR 启动客户端并确认配置处于启用状态。验证方式:打开请求日志核对这条请求的解析供应商/模型,再顺手用/model确认 CCR 暴露的模型在列表中可见。
这套方案适合日常使用 Claude Code、同时握有多家模型额度、希望在本地集中管理路由与回退的人;如果你只是一次性调用几个模型 API,或者想直接替换掉 Claude Code 客户端本身,CCR 就不在它的适用范围内。
【免费下载链接】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),仅供参考