☰
Claude Code Router 三步接入 DeepSeek:本地模型路由完整配置指南
2026/10/11 11:43:55 网站建设 项目流程

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-router

官方额度消耗得快,手里却压着一张 DeepSeek 的 Key?想让日常任务走便宜模型、难题再切到推理模型,最省事的路径是在本地架一层网关:Claude Code Router(ccr)常驻本机,按你配好的规则把 Claude Code 的请求路由到 DeepSeek 或其他模型 API,客户端侧无感知。

三步完成首次接入

  1. 安装 CLI。npm 包要求 Node.js 22 及以上,装完即可在终端直接使用ccr:
npm install -g @musistudio/claude-code-router
  1. 打开管理界面,添加供应商。执行下面命令会在浏览器拉起127.0.0.1:3458的管理页,在「供应商」里选 DeepSeek 预设(API 地址已预填为 api.deepseek.com,走 OpenAI Chat Completions 协议),粘贴 Key,勾选deepseek-chat、deepseek-reasoner两个模型:
ccr ui
  1. 接入 Claude Code。在「Agent 配置」里新增一条 Claude Code 配置并选好默认模型,再从 CCR 直接拉起 Claude Code,它的流量就会进入127.0.0.1:3456的本地网关。完整步骤见 Claude Code 接入文档。

三个检查点确认路由生效

  • 点供应商卡片上的「检测连通性」:Key 与所选模型 ID 都能调通时给出通过提示,先排除凭据问题。
  • 在 Claude Code 里发一条普通消息,打开请求日志,核对该请求最终解析到的供应商与模型,应为deepseek/deepseek-chat(或你指定的组合)。
  • 客户端输入/model,列表里应能看到 CCR 暴露的模型;看不到说明流量没走网关,前面的接入没接对。

请求的完整走向如下:

按任务类型选模型

任务类型建议模型理由
日常问答deepseek/deepseek-chat响应快、成本低,扛得住高频对话
写代码deepseek/deepseek-chat代码任务足够胜任,叠加回退链更稳
复杂推理deepseek/deepseek-reasoner出结果慢,留给架构分析和难题拆解
长上下文另配长上下文模型读大日志、长文档时切换,避免小窗口截断

规则在「路由」页面按列表顺序匹配,第一条命中的启用规则生效,各字段的详细说明见 路由文档。

进阶玩法:按内容分流与子代理独立控制

按消息内容分流。普通条件规则只能匹配单个字段,想做到"像代码任务走一个模型、像推理任务走另一个",把规则类型改为 Node.js 脚本并指向本地脚本文件。脚本在每次执行前重新读取,改完不用重存规则;多条脚本规则按列表顺序执行,返回null表示不命中,继续试下一条:

const text = input.summary.lastUserText ?? ""; if (/function |class |import |def /.test(text)) { return { model: "deepseek/deepseek-chat" }; } if (/推理|证明|为什么/.test(text)) { return { model: "deepseek/deepseek-reasoner" }; } return null;

子代理单独指定模型。Claude Code 通过 Agent / Task / Workflow 派生子代理时默认沿用默认模型。给希望被自动挑选的模型在「模型」页面填写 Description(写清适合哪类任务),CCR 会把模型列表注入 Claude Code 的工具说明,派生请求的 prompt 首行随即携带模型标签,CCR 识别后直接路由过去:

<CCR-SUBAGENT-MODEL>deepseek/deepseek-reasoner</CCR-SUBAGENT-MODEL> 请给出这道题的完整推理步骤

出问题时从这三处入手

推理模型请求超时返回失败,通常不是网络问题:deepseek-reasoner出结果慢,默认超时撑不住。处理办法是给对应路由规则单独调大超时,脚本规则可设 10–30000 毫秒。验证方式:发一条典型难题,到请求日志里确认状态为成功。

请求报错且上游信息直接提及 token 上限,原因是 Claude Code 期望的输出量超过了 DeepSeek 模型单次输出的最大值。处理办法是在命中规则里加一条改写,把request.body.max_tokens调小。验证方式:看日志中的上游错误信息,限幅值一般会被明确写出。

改了配置却仍走旧组合,最常见的原因是 Claude Code 没有从 CCR 拉起,或那条配置没启用。处理办法是重新从 CCR 启动客户端并确认配置处于启用状态。验证方式:打开请求日志核对这条请求的解析供应商/模型,再顺手用/model确认 CCR 暴露的模型在列表中可见。

这套方案适合日常使用 Claude Code、同时握有多家模型额度、希望在本地集中管理路由与回退的人;如果你只是一次性调用几个模型 API,或者想直接替换掉 Claude Code 客户端本身,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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询