十分钟跑通 CCR 接入 DeepSeekClaude 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 Routerccr十分钟搭好这条路由装网关、加供应商、配规则客户端本身一行不改。原理速览请求经过哪几个环节这节用一个流程图讲清你敲的字怎么变成 DeepSeek 的回复。CCR 是一个跑在本机的网关相当于请求转发站Claude Code 的所有请求先到本机http://127.0.0.1:3456CCR 按路由规则和供应商配置选定实际上游哪家模型、哪个密钥再把响应原路转回。体验不变变的只是回答你的那个模型。快速上手三步装好 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响应快、成本低日常流量放这里最划算写代码、小改动、修 bugdeepseek/deepseek-chat能力够用再挂一条失败回退到更强模型更稳架构设计、复杂推理、疑难 bugdeepseek/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-MODELdeepseek/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 暴露的模型。适合谁用判断你的用法再决定这节帮你省掉试错时间。如果你日常用 Claude Code、手里有多家模型额度想在本地集中管理路由、回退和子代理选模CCR 是顺手的工具如果只是一次性调几个模型 API或想直接替换 Claude Code 客户端本身它解决的不是同一个问题。下一步建议从上面对照表里挑你最频繁的场景先把它切到deepseek/deepseek-chat跑通请求日志后再逐场景迁移——先跑通再调优。【免费下载链接】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），仅供参考