十分钟跑通 CCR 接入 DeepSeek：Claude Code 模型路由完整指南-育师

十分钟跑通 CCR 接入 DeepSeek：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

日常用 Claude Code 时，想让高频任务走 DeepSeek 省钱、难题再交给强推理模型，这篇指南帮你用 Claude Code Router（ccr）十分钟搭好这条路由：装网关、加供应商、配规则，客户端本身一行不改。

原理速览：请求经过哪几个环节

这节用一个流程图讲清"你敲的字怎么变成 DeepSeek 的回复"。CCR 是一个跑在本机的网关，相当于请求转发站：Claude Code 的所有请求先到本机http://127.0.0.1:3456，CCR 按路由规则和供应商配置选定实际上游（哪家模型、哪个密钥），再把响应原路转回。体验不变，变的只是回答你的那个模型。

快速上手：三步装好 DeepSeek 预设

这节只做一件事：把环境跑起来。

安装 CLI（要求 Node.js 22 及以上）。装完先启动管理界面：
```
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，点检测连通性可验证密钥和模型 ID 是否可用。
在Agent 配置添加一条 Claude Code 配置并选好默认模型，然后从 CCR 打开 Claude Code——只有从 CCR 启动，配置才会生效。接入细节见 Claude Code 接入文档。

路由策略：场景模型对照与规则匹配顺序

这节回答"同一个请求该发给哪个模型"。先说匹配顺序：CCR 内置路由优先识别 Claude Code 请求——客户端显式选择且可识别的模型优先，未选或无法识别时落到 Agent 配置的默认模型；你的自定义规则仍可在其后改写。规则本身按列表顺序匹配，第一条命中的启用规则生效，后面的不再检查，所以顺序就是优先级。

常见场景的对应关系，可作起点：

场景	建议模型	理由
高频问答、快速摘要	deepseek/deepseek-chat	响应快、成本低，日常流量放这里最划算
写代码、小改动、修 bug	deepseek/deepseek-chat	能力够用，再挂一条失败回退到更强模型更稳
架构设计、复杂推理、疑难 bug	deepseek/deepseek-reasoner	推理更深但耗时更长，别让它承接高频请求
读长日志、长文档	另配一个大上下文模型	避免小窗口截断，专门给长上下文用

字段和回退的完整说明在路由文档。

进阶玩法：按内容分流与子代理模型标签

这节解决普通条件规则表达不了的两类需求。

Node.js 脚本路由：按消息内容选模型

普通条件只能匹配单个字段，想"看消息内容再定模型"，把规则类型改成Node.js 脚本，指向一个本地脚本文件。CCR 每次执行前重新读取文件，改完脚本不用回界面重新保存规则；返回null表示不命中，继续试下一条规则。

const text = input.summary.lastUserText ?? ""; if (/重构|修复|加个功能|实现/.test(text)) { return { model: "deepseek/deepseek-chat" }; } if (/架构|方案对比|性能瓶颈|为什么这样设计/.test(text)) { return { model: "deepseek/deepseek-reasoner" }; } return null;

建规则时记得设超时：脚本规则可配 10–30000 毫秒，reasoner 那条建议给大些。

子代理模型标签：让派生 Agent 自动选模型

Claude Code 通过 Agent / Task / Workflow 派生子代理时，不必都走默认模型。机制分两步：在模型页面给希望被自动选中的模型填Description（写清适合的任务、速度、成本），CCR 会把模型列表和说明注入 Claude Code 的工具说明；派生请求的 prompt 首行携带模型标签，CCR 识别后剥离标签并直接路由到标签里的模型：

<CCR-SUBAGENT-MODEL>deepseek/deepseek-reasoner</CCR-SUBAGENT-MODEL> 请给出这个模块的完整重构方案……

注意：没有任何模型填 Description 时，这套注入不会发生，标签机制等于关闭。

排查手册：三类常见问题与验证方法

这节覆盖最常踩的三个坑。所有验证都指向同一个地方：CCR 的请求日志。

⚠️推理模型请求超时
- 症状：chat 模型正常，reasoner 频繁报错。
- 原因：推理模型出结果慢，打穿默认超时。
- 处理：给命中规则单独调大超时（脚本规则范围 10–30000 毫秒）。
- 验证：✅ 发一条典型难题，在请求日志里确认该条状态为成功。
⚠️上游报输出 token 超限
- 症状：请求直接失败，上游错误信息点明限制。
- 原因：Claude Code 期望的输出 token 高于 DeepSeek 模型的单次上限。
- 处理：在命中规则里加改写，把request.body.max_tokens调小。
- 验证：✅ 看请求日志中的上游错误是否消失、状态变成功。
⚠️改了配置但不生效
- 症状：换了供应商或规则，请求仍走旧模型。
- 原因：多半是没从 CCR 打开 Claude Code，或规则开关没启用。
- 处理：检查规则状态，改从 CCR 启动客户端。
- 验证：✅ 在请求日志里核对这条请求解析出的供应商/模型是否为预期组合，并确认 Claude Code 的/model里能看到 CCR 暴露的模型。