☰
CCR 三步接入 DeepSeek,一次到位
2026/10/11 12:06:55 网站建设 项目流程

CCR 三步接入 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

Claude Code Router(下称 CCR)是本地中转层,把 Claude Code 的请求转发到 DeepSeek 等第三方模型。日常用 Claude Code、手里有多家模型额度、想本地集中管路由回退,适合你;只想一次性调 API 或打算换掉客户端,请绕道。

① 准备工作:一条命令装好 CCR

准备工作就三句话的事,装完马上能用。

  1. 先确认本机 Node.js 版本 ≥ 22,不够就先升。
  2. 用 npm 全局装 CCR 的 CLI:
npm install -g @musistudio/claude-code-router
  1. 启动管理界面:
ccr ui

浏览器打开http://127.0.0.1:3458,管理页面就在眼前。

② 首次配置:两页点完就能用

两页点完就能用,全程不碰代码。

供应商页

  • 进 供应商 → 添加供应商,挑 DeepSeek 内置模板。
  • API 地址默认https://api.deepseek.com,协议走 OpenAI Chat Completions,都不用动。
  • 粘贴 API 密钥,勾上deepseek-chat和deepseek-reasoner两个模型。
  • 点 检测连通性,确认 Key 和模型 ID 都能调通。

Agent 配置页

  • 到 Agent 配置 加一条 Claude Code,选好默认模型。
  • 直接从 CCR 启动 Claude Code,打通完成。

完整流程参考 Claude Code 接入文档,供应商细节看 供应商文档。

③ 路由对照表:四种场景各交给谁

四种活交给谁,一张表说清:

你手里的活交给谁为什么
日常问答deepseek/deepseek-chat响应快还便宜,高频对话首选
写代码deepseek/deepseek-chat代码任务够用,再搭条回退链更稳
复杂推理deepseek/deepseek-reasoner出结果慢但推理强,留给架构分析和拆难题
长上下文另配长上下文模型读大日志、长文档时切过去,防窗口截断

规则在 路由 页面配置,按列表顺序匹配,第一条命中的启用规则生效。优先级一句话:客户端显式指定的模型优先,没选或认不出的落到 Agent 默认模型,你写的自定义规则还能在最后一步改写。字段说明都在 路由文档。

④ 一次请求的完整路线:用过之后再懂原理

原理不复杂:请求绕道本机中转层,再由它挑上游。

Claude Code 发出的请求先落到本机http://127.0.0.1:3456的 CCR。它依据供应商、路由规则和凭据,决定这单发给哪个 API,响应再原路送回。你在 Claude Code 里的操作体验一点没变,换掉的只是上游供应商。

⑤ 进阶一:让消息内容决定走哪个模型

想让路由跟着消息内容走,普通条件规则不够,上 Node.js 脚本。把规则类型切到 Node.js 脚本,再指向一个本地脚本文件就行。文件每次执行前都会重新读取,改完不用重存规则;返回null表示不命中,自动看下一条。

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

⑥ 进阶二:子代理不再走默认模型

子代理也能挑模型,靠 Description 加一个标签。Claude Code 用 Agent / Task / Workflow 派生子代理时,你不想让它们全走默认模型:在 模型 页面给想被选中的模型填 Description,写清它适合什么任务。CCR 顺手把模型列表塞进 Claude Code 的工具说明里。派生请求的 prompt 首行会带上模型标签,CCR 看到标签直接路由过去:

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

⑦ 翻车现场三连

三条高频事故,照单自查。

一、推理模型超时

  • 症状:难题一发,请求卡到超时失败。
  • 原因:reasoner 出结果慢,默认超时兜不住。
  • 怎么改:给这条路由规则单独调大超时,脚本规则支持 10–30000 毫秒。
  • 怎么验证:发一条典型难题,看请求日志里的状态是否成功。

二、输出超模型 token 上限

  • 症状:请求直接以错误返回。
  • 原因:Claude Code 期望的输出 token 高于 DeepSeek 单次上限。
  • 怎么改:在命中规则里加改写,把request.body.max_tokens调小。
  • 怎么验证:去日志里翻上游报错,一般会直接写明 token 限制。

三、改了配置不生效

  • 症状:开关拨了,行为纹丝不动。
  • 原因:十有八九没从 CCR 打开 Claude Code,或启用开关没拨开。
  • 怎么改:从 CCR 重新启动 Claude Code,确认配置已启用。
  • 怎么验证:打开请求日志,核对这条请求解析出的供应商和模型是否是你预期的组合,顺带确认/model里能看到 CCR 暴露的模型。

一句话决策:多家模型额度加上天天用 Claude Code,就装 CCR 集中管路由与回退;只是偶尔试个 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),仅供参考

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

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

立即咨询