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-router上个月一位同事把 Claude Code 的月度账单甩进群重度跑 agent 重构token 花费比订阅费高出一截长会话每次都要等海外节点吐字改一行代码的往返延迟肉眼可见。他后来把入口换成了 Claude Code Routerccr——请求先打到本地 3456 网关再由 ccr 按路由规则分发到 DeepSeek 这类国产模型账单曲线随即拐了下来。ccr 的定位可以一句话讲完它是编程 agent 的本地路由网关对 Claude Code 保持单一 Anthropic 协议入口内部按你写的路由策略把请求转发到任意供应商DeepSeek 集成就是其中一个内置供应商预设请求在本地完成协议适配与格式回转后再落到上游。 ccr 路由机制请求怎么分发到 DeepSeek 模型一个请求从 Claude Code 发出后在 ccr 内部会经历四次判断内置路由先识别请求身份——是主请求、Subagent 派生请求还是 Codex 等其他 agent自定义路由规则按列表顺序逐条匹配第一条命中的规则改写目标模型全部不命中则落到 default协议适配层把 Anthropic Messages 格式翻译成上游协议DeepSeek 走 OpenAI Chat Completions鉴权 Key 从凭据池里选一条可用的上游失败时按失败分类器走回退策略重试当前模型或切换到备用模型链。规则引擎本身不长策略按序求值、首条命中即返回可以直接读 路由模块源码 里的policy-engine.ts验证。DeepSeek 端点、协议与余额读取则来自内置预设你不需要手填 base URL 也能让 ccr 识别出上游是 DeepSeek。⚙️ ccr 接入 DeepSeek 的最小可用配置写法先安装 CLI要求 Node.js 22npm install -g musistudio/claude-code-router注意一个版本事实ccr 当前把运行配置存在 SQLite 里~/.claude-code-router/config.sqliteconfig.json只在没有 SQLite 配置时作为首次引导来源读一次之后建议以桌面 UI 为准。所以下面这份 JSON 是首次启动可粘贴的最小集跑通后日常调整走 UI{ APIKEY: ccr-local-client-key, LOG: true, Providers: [ { name: deepseek, api_base_url: https://api.deepseek.com/v1/chat/completions, api_key: $DEEPSEEK_API_KEY, models: [deepseek-chat, deepseek-reasoner] } ], Router: { default: deepseek,deepseek-chat, think: deepseek,deepseek-reasoner } }启动命令一条ccr ui它会拉起后台服务并打开管理页模型网关默认监听http://127.0.0.1:3456。之后在 Claude Code 一侧把ANTHROPIC_BASE_URL指到这个本地网关、带上 ccr 的客户端 Key请求就开始走 DeepSeek 了。字段语义与端口以 官方文档 为准版本迭代较快升级前建议对一遍。 DeepSeek 路由规则怎么配日常编码、长文档与成本敏感三个场景日常编码default 兜底 deepseek-chat上面那份配置里的default已经覆盖了 80% 的流量绝大多数会话、补全、小重构都走deepseek-chat它便宜且响应快够日常用。不需要再写任何规则。长文档按 token 数切到长上下文模型问题不是文档长而是上下文涨——同一个会话聊到几十个文件之后token 数会悄悄越过便宜模型的舒适区。ccr 的脚本规则能直接拿到估算的输入 token 数触发逻辑一句话超过阈值就换长上下文模型否则不命中。if (input.tokenCount 50000) { return { model: longctx/your-long-context-model }; } return null;把longctx/your-long-context-model换成你在 ccr 里实际添加的长上下文供应商和模型即可仓库内置了 Moonshot、百炼等预设可选。脚本规则、可用字段和回退结构的完整说明在 智能路由文档 里它还支持按 header 分流、灰度分桶这类更细的玩法。成本敏感团队限额加回退链团队场景下便宜模型的 Key 更容易触到速率限制。两步走给凭据池的 Key 配窗口限额到限自动跳过换下一条 Key再给路由配model-chain回退当前模型彻底失败时按顺序试备用模型。限额就是一个小 JSON 对象字段含义见 供应商配置文档{ rpm: 60, tpm: 100000 }回退链在脚本规则里返回{ mode: model-chain, models: [...] }即可具体模型必须是 ccr 里已配置的模型写错不会生效。 DeepSeek 候选模型对比单价、上下文与擅长任务并排看选模型时把花多少钱、装多少上下文、干什么活放在一张表里比比逐个查官网高效。单价与上下文长度的具体数值以 DeepSeek 官方定价页和模型页为准这里只给相对量级和任务定位模型单价水平上下文擅长任务deepseek-chat低日常主力以官方模型页为准日常编码、批量修改、摘要deepseek-reasoner明显更高约为 chat 数倍以官方模型页为准复杂推理、架构分析、多步调试Moonshot / Kimi长上下文中长上下文以官方模型页为准读长文档、仓库级上下文整理任意 OpenAI 兼容上游视供应商视供应商作为回退链末位的保底模型经验值是reasoner 的单价是 chat 的数倍所以只让它处理想不清楚的任务别当默认模型长文档场景与其硬塞进 chat不如直接切给长上下文供应商。ccr 侧有用量与成本估算面板跑几天后按日志里的实际消耗校准这张表比拍脑袋可靠。⚠️ 踩坑速查ccr 配 DeepSeek 的超时、token 上限与流式响应超时reasoner 的长思考请求容易撞默认超时表现为请求挂到一半报 5xx。按文档调大超时上限别用重试硬扛重试只会重复烧 token。token 上限输出被截断多半是max_tokens设小了尤其 reasoning 模型的思考本身也要占 token 预算路由判断时优先信input.tokenCount这种网关估算值别自己数。流式响应DeepSeek 的流要经过协议回转中文偶发在分块边界截断。仓库里有针对 SSE UTF-8 分块边界的测试packages/core/test/unit/gateway/sse-utf8-chunk-boundary.test.mjs遇到乱截先升级到最新版再看。需要常驻服务器时可以容器化部署配置与持久化路径同样以 官方文档 为准。从 路由模块近几个版本的演进看策略正在从选模型扩展到凭据池、失败分类与脚本化灰度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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考