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-routerClaude Code Router(CCR)是一个本地模型网关,把 Claude Code 的请求路由到 DeepSeek 等第三方模型。本文覆盖安装 CLI、接好 DeepSeek 供应商、配置默认模型与路由规则的完整路径,最后给出用请求日志定位问题的方法。装好 ccr 并启动网关CLI 要求 Node.js 22 及以上。安装后ccr命令拉起同一套模型网关与浏览器管理界面:npm install -g musistudio/claude-code-router ccr uiccr ui启动两个入口:管理界面在http://127.0.0.1:3458,模型网关默认监听http://127.0.0.1:3456。终端里打印出CCR service started at ... (pid ...)这行,说明服务已经起来了。一次请求的链路是:Claude Code →127.0.0.1:3456网关 → 按供应商与路由规则选中上游模型 → 响应原路返回。客户端侧体验不变,变的是上游。连通 DeepSeek 并勾选模型CCR 内置 DeepSeek 预设(预设源码),API 地址https://api.deepseek.com、协议 OpenAI Chat Completions 都是预填的,基本不用手工填。在供应商 → 添加供应商里选 DeepSeek 预设,填入 API Key,勾选deepseek-chat与deepseek-reasoner,再点检测连通性。Key 能通过连通检测、两个模型 ID 都可调用,这步就算完成。配好默认模型并打开 Claude Code到Agent 配置添加一条 Claude Code 配置,填名称(如Claude Code - DeepSeek),在模型字段选默认模型,保存并保持启用。然后从 CCR 打开客户端,不要从系统里直接启动:ccr Claude Code - DeepSeek验证有两个抓手:终端里/model能看到 CCR 暴露的模型;发一条消息后打开 CCR 的请求日志,resolved provider是deepseek、状态成功,说明链路通了。字段细节见 Claude Code 接入文档。按任务档位分模型Claude Code 配置里除了默认模型,还有 Opus、Sonnet、Haiku 等档位字段,每个档位都能单独覆盖成别的供应商模型。按档位分,比按请求拆规则省事:档位建议模型选择理由默认 / Sonnetdeepseek/deepseek-chat响应快、成本低,扛高频对话与日常编码Opusdeepseek/deepseek-reasoner推理更强但更慢,留给架构分析、难题拆解Haikudeepseek/deepseek-chat子任务、摘要这类小活走便宜档想让某档位在上游失败时切备用模型,在路由页面的失败降级目标里按顺序填备用供应商/模型即可,任意 4xx/5xx 都会触发降级。让路由规则按消息内容选模型普通条件规则一次只匹配一个字段;想让消息像推理任务就走 reasoner,其余走 chat,把规则类型改成Node.js 脚本,指向本地脚本文件。脚本按列表顺序执行,返回null表示不命中、继续下一条;每次执行前都会重新读文件,改完不用重存规则:const text input.summary.lastUserText ?? ; if (/为什么|推导|证明/.test(text)) { return { model: deepseek/deepseek-reasoner }; } if (/function |class |def /.test(text)) { return { model: deepseek/deepseek-chat }; } return null;保存前可用编辑器里的测试请求 JSON试跑,不发起真实上游请求。超时填 10–30000 毫秒,input各字段说明见 路由文档。验证:发一条含为什么的消息,请求日志里resolved model是deepseek/deepseek-reasoner。给子代理单独指派模型Claude Code 用 Agent / Task 派生子代理时,希望子任务不走默认模型?给候选模型在模型页面填Description,写清适合的任务。CCR 会把带说明的模型注入 Claude Code 的工具说明,派生请求的 prompt 首行会携带标签:CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请给出这道题的完整推理步骤……CCR 识别标签后直接路由到该模型,日志里这条请求的路由原因显示为builtin:claude-code-subagent。注意:没有任何模型填 Description 时,这套注入根本不会发生——这是子代理没换模型最常见的原因。从请求日志排查问题三条高频问题,都按现象 → 原因 → 改法 → 验证走 请求没走网关。现象:请求日志查不到这条请求,回复的还是 Anthropic 模型。原因:从系统直接打开了 Claude Code,或配置没启用。改法:用ccr 配置名打开,确认配置开关打开。验证:日志里resolved provider是deepseek。推理请求超时。现象:reasoner 任务返回超时或 408。原因:推理模型出结果慢,打穿了默认等待。改法:给命中的规则调大执行超时(脚本规则支持 10–30000 毫秒),或在失败时选继续重试,408 在触发码内。验证:发一条典型难题,日志状态为成功。输出超过模型上限。现象:上游报 token 限制错误。原因:Claude Code 期望的max_tokens高于 DeepSeek 单次上限。改法:命中规则里加改写,set request.body.max_tokens为更小值。验证:日志里该错误消失。什么情况值得上这套网关如果你日常用 Claude Code、手里有多家模型额度,想在本地集中管路由、档位和降级,这套本地网关比较顺手;如果只是偶尔调几个模型 API,或者想直接替换掉 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude Code Router 接入 DeepSeek 完整指南:五步配好模型网关,附日志排查法
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-routerClaude Code Router(CCR)是一个本地模型网关,把 Claude Code 的请求路由到 DeepSeek 等第三方模型。本文覆盖安装 CLI、接好 DeepSeek 供应商、配置默认模型与路由规则的完整路径,最后给出用请求日志定位问题的方法。装好 ccr 并启动网关CLI 要求 Node.js 22 及以上。安装后ccr命令拉起同一套模型网关与浏览器管理界面:npm install -g musistudio/claude-code-router ccr uiccr ui启动两个入口:管理界面在http://127.0.0.1:3458,模型网关默认监听http://127.0.0.1:3456。终端里打印出CCR service started at ... (pid ...)这行,说明服务已经起来了。一次请求的链路是:Claude Code →127.0.0.1:3456网关 → 按供应商与路由规则选中上游模型 → 响应原路返回。客户端侧体验不变,变的是上游。连通 DeepSeek 并勾选模型CCR 内置 DeepSeek 预设(预设源码),API 地址https://api.deepseek.com、协议 OpenAI Chat Completions 都是预填的,基本不用手工填。在供应商 → 添加供应商里选 DeepSeek 预设,填入 API Key,勾选deepseek-chat与deepseek-reasoner,再点检测连通性。Key 能通过连通检测、两个模型 ID 都可调用,这步就算完成。配好默认模型并打开 Claude Code到Agent 配置添加一条 Claude Code 配置,填名称(如Claude Code - DeepSeek),在模型字段选默认模型,保存并保持启用。然后从 CCR 打开客户端,不要从系统里直接启动:ccr Claude Code - DeepSeek验证有两个抓手:终端里/model能看到 CCR 暴露的模型;发一条消息后打开 CCR 的请求日志,resolved provider是deepseek、状态成功,说明链路通了。字段细节见 Claude Code 接入文档。按任务档位分模型Claude Code 配置里除了默认模型,还有 Opus、Sonnet、Haiku 等档位字段,每个档位都能单独覆盖成别的供应商模型。按档位分,比按请求拆规则省事:档位建议模型选择理由默认 / Sonnetdeepseek/deepseek-chat响应快、成本低,扛高频对话与日常编码Opusdeepseek/deepseek-reasoner推理更强但更慢,留给架构分析、难题拆解Haikudeepseek/deepseek-chat子任务、摘要这类小活走便宜档想让某档位在上游失败时切备用模型,在路由页面的失败降级目标里按顺序填备用供应商/模型即可,任意 4xx/5xx 都会触发降级。让路由规则按消息内容选模型普通条件规则一次只匹配一个字段;想让消息像推理任务就走 reasoner,其余走 chat,把规则类型改成Node.js 脚本,指向本地脚本文件。脚本按列表顺序执行,返回null表示不命中、继续下一条;每次执行前都会重新读文件,改完不用重存规则:const text input.summary.lastUserText ?? ; if (/为什么|推导|证明/.test(text)) { return { model: deepseek/deepseek-reasoner }; } if (/function |class |def /.test(text)) { return { model: deepseek/deepseek-chat }; } return null;保存前可用编辑器里的测试请求 JSON试跑,不发起真实上游请求。超时填 10–30000 毫秒,input各字段说明见 路由文档。验证:发一条含为什么的消息,请求日志里resolved model是deepseek/deepseek-reasoner。给子代理单独指派模型Claude Code 用 Agent / Task 派生子代理时,希望子任务不走默认模型?给候选模型在模型页面填Description,写清适合的任务。CCR 会把带说明的模型注入 Claude Code 的工具说明,派生请求的 prompt 首行会携带标签:CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请给出这道题的完整推理步骤……CCR 识别标签后直接路由到该模型,日志里这条请求的路由原因显示为builtin:claude-code-subagent。注意:没有任何模型填 Description 时,这套注入根本不会发生——这是子代理没换模型最常见的原因。从请求日志排查问题三条高频问题,都按现象 → 原因 → 改法 → 验证走 请求没走网关。现象:请求日志查不到这条请求,回复的还是 Anthropic 模型。原因:从系统直接打开了 Claude Code,或配置没启用。改法:用ccr 配置名打开,确认配置开关打开。验证:日志里resolved provider是deepseek。推理请求超时。现象:reasoner 任务返回超时或 408。原因:推理模型出结果慢,打穿了默认等待。改法:给命中的规则调大执行超时(脚本规则支持 10–30000 毫秒),或在失败时选继续重试,408 在触发码内。验证:发一条典型难题,日志状态为成功。输出超过模型上限。现象:上游报 token 限制错误。原因:Claude Code 期望的max_tokens高于 DeepSeek 单次上限。改法:命中规则里加改写,set request.body.max_tokens为更小值。验证:日志里该错误消失。什么情况值得上这套网关如果你日常用 Claude Code、手里有多家模型额度,想在本地集中管路由、档位和降级,这套本地网关比较顺手;如果只是偶尔调几个模型 API,或者想直接替换掉 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考