企业官网建设流程全解析

5分钟让 Claude Code 接入 DeepSeek：Claude 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-router

Claude Code Router（CCR）是一个本地模型网关，把 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，接着三步：

1. 供应商 → 添加供应商：选 DeepSeek 预设（API 地址https://api.deepseek.com、OpenAI Chat 协议均已预填），填 API 密钥，勾选deepseek-chat、deepseek-reasoner，点检测连通性确认 Key 与模型可用。
2. Agent 配置 → 添加配置：选 Claude Code，填配置名称、选默认模型，保存。
3. 从 CCR 打开 Claude Code（CLI 执行ccr "配置名称"），发一条消息，在请求日志里确认resolved provider/resolved model指向 DeepSeek。

完整流程见 Claude Code 接入文档 与 接入供应商。

CCR 路由规则怎么配：场景、模型与回退对照

路由页面管理所有规则，按列表顺序匹配，第一条命中的启用规则生效。内置的 Claude Code 路由负责识别请求：客户端显式选择且 CCR 能识别的模型优先；未选择或不可识别时，落到 Agent 配置里的默认模型。你的自定义规则仍可在其后继续改写。四类场景的常见配法：

除路由外还有回退层：页面顶部的默认失败处理是全局回退，每条规则里的失败时是规则级回退（命中时覆盖全局）。三种模式：关闭（只请求一次）、继续重试（当前模型重试 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-MODEL>deepseek/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