5分钟让 Claude Code 接入 DeepSeekClaude Code Router 完整路由指南【免费下载链接】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-routerClaude Code RouterCCR是一个本地模型网关把 Claude Code 等编码 Agent 的请求路由到任意你选择的第三方模型。本文讲从安装到 Claude Code 接入 DeepSeek 的完整路径以及路由规则与回退怎么配。用一个本地网关解决三个痛点用 Claude Code 配第三方模型时常见三个问题换模型要手改配置、重启客户端某个模型挂了只能人工切请求最终发给了谁完全看不到。CCR 的思路是在本机起一个固定端点默认http://127.0.0.1:3456客户端只认这一个地址供应商、路由规则、回退链和请求日志全部集中在这一个地方管理客户端体验不变变的只是上游。5 分钟跑通ccr 命令行接入 DeepSeek安装 CLI 需要 Node.js 22 及以上装完ccr命令即可启动同一个网关和浏览器管理界面npm install -g musistudio/claude-code-router ccr ui浏览器会打开http://127.0.0.1:3458接着三步供应商 → 添加供应商选 DeepSeek 预设API 地址https://api.deepseek.com、OpenAI Chat 协议均已预填填 API 密钥勾选deepseek-chat、deepseek-reasoner点检测连通性确认 Key 与模型可用。Agent 配置 → 添加配置选 Claude Code填配置名称、选默认模型保存。从 CCR 打开 Claude CodeCLI 执行ccr 配置名称发一条消息在请求日志里确认resolved provider/resolved model指向 DeepSeek。完整流程见 Claude Code 接入文档 与 接入供应商。CCR 路由规则怎么配场景、模型与回退对照路由页面管理所有规则按列表顺序匹配第一条命中的启用规则生效。内置的 Claude Code 路由负责识别请求客户端显式选择且 CCR 能识别的模型优先未选择或不可识别时落到 Agent 配置里的默认模型。你的自定义规则仍可在其后继续改写。四类场景的常见配法场景建议配置理由日常问答、小修改deepseek/deepseek-chat响应快、成本低适合高频对话常规写代码任务deepseek/deepseek-chat 规则级回退命中失败时自动切备用模型不中断任务复杂推理、架构分析deepseek/deepseek-reasoner推理模型慢只留给难题拆解长日志、长文档另配长上下文供应商模型避免小上下文窗口截断除路由外还有回退层页面顶部的默认失败处理是全局回退每条规则里的失败时是规则级回退命中时覆盖全局。三种模式关闭只请求一次、继续重试当前模型重试 N 次适合偶发超时与限流、失败降级目标按顺序切备用模型主模型不可用时兜底。字段全集与操作符见 路由文档。高级技巧脚本分流与子代理模型按消息内容分流Node.js 脚本规则场景普通条件规则只能匹配单个字段如request.body.model前缀而你想消息像推理任务就走推理模型像代码任务就走快模型。做法把规则类型改成Node.js 脚本指向一个本地.js文件。脚本每次执行前重新读取改完不用重存规则返回null表示不命中、继续下一条规则超时可在 10–30000 毫秒间设置。脚本能直接拿到input.summary.lastUserText最后一条用户消息const text input.summary.lastUserText ?? ; if (/推理|证明|为什么/.test(text)) return { model: deepseek/deepseek-reasoner }; return null;子代理单独指定模型场景Claude Code 用 Agent / Task 派生子代理时你希望子任务按类型选模型而不是全部走默认模型。做法在模型页面给希望被自动选择的模型填Description写清适合的任务、速度与成本。CCR 会把模型列表注入 Claude Code 的工具说明派生请求的 prompt 首行携带模型标签CCR 识别后直接路由CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请给出这道题的完整推理步骤……没有任何模型填 Description 时该机制不会启用所以先给 1–2 个模型写说明再测试。CCR 常见排坑清单改了配置但没生效最常见原因是没有从 CCR 打开 Claude Code或 Agent 配置未启用。验证方法打开请求日志看这条请求的resolved provider/resolved model是否预期并用/model确认 CCR 暴露的模型可见。推理模型超时reasoner 类模型出结果慢默认超时会被打穿。做法是在对应规则单独调大超时。验证方法发一条典型难题看请求日志里状态是否成功、耗时集中在哪一段。输出长度超过模型上限Claude Code 期望的max_tokens高于上游模型单次上限请求以错误返回。做法是在命中规则里加一行改写把request.body.max_tokens调小。验证方法看日志里的上游错误信息通常直接写明 token 限制。model not found路由解析出的模型名不在供应商模型列表里通常三处之一供应商模型列表、路由规则、Agent 配置不一致。验证方法逐一对比这三处把不一致的改齐后重发请求。401 / 403这是凭据问题而非路由问题Key 未启用或 Base URL、协议不匹配。验证方法在供应商页面点检测连通性用真实请求确认整条链路。更多症状的排查步骤见 故障排查文档。这套路由方案适不适合你适合日常主力使用 Claude Code或其他受支持的编码 Agent手里有多家模型额度希望在本地集中管理路由、回退和凭据并且想看清每次请求最终发给谁、花了多少 token。不适合一次性调几个模型 API 做对比——直接写脚本更省事或者想连 Claude Code 客户端本身一起替换——CCR 是网关不是客户端它不改变你的交互方式。一个简单的判断标准如果你经常换个模型要动客户端配置、上游一挂就得手工切换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），仅供参考
