4 步把 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-routerClaude Code Router下称 CCR是一个本地模型网关它为 Claude Code 等编程代理提供统一的本地端点把每次模型请求转发到你配置的提供商与模型上。本文以 DeepSeek 集成为主线依次说明 CCR 的定位、最小可运行配置、路由机制、按场景分发模型的方法、高级定制手段以及成本监控与生产部署覆盖从 DeepSeek 接入 Claude Code 到多模型路由策略的完整过程。认识项目Claude Code Router 是什么Claude Code Router 是一个运行在本地的模型网关与控制面。Claude Code 默认只调用 Anthropic 的模型而 CCR 在本地默认127.0.0.1:3456暴露一个兼容端点接收请求后完成三件事判断请求属于哪类场景选择目标提供商和模型做协议转换transformer把 Anthropic Messages 格式的请求转成目标模型支持的格式再把响应转回来记录每次请求的最终路由、耗时、token 用量与成本估计供界面查看。DeepSeek 是 CCR 内置的提供商预设之一使用 OpenAI Chat Completions 兼容协议预设定义见 packages/core/src/providers/presets/deepseek/index.ts。因此 DeepSeek 接入 Claude Code 不需要自己写转换逻辑把 Claude Code 指向 CCR 的本地端点由 CCR 负责协议适配与路由。安装 Claude Code Router 并准备最小配置通过 npm 全局安装 CLI然后启动服务npm install -g musistudio/claude-code-router ccr start # 后台启动管理服务和网关ccr ui 可打开管理界面最小可运行的配置如下保存为~/.claude-code-router/config.json{ HOST: 127.0.0.1, PORT: 3456, API_TIMEOUT_MS: 600000, Providers: [ { name: deepseek, api_base_url: https://api.deepseek.com, api_key: $DEEPSEEK_API_KEY, models: [deepseek-chat, deepseek-reasoner] } ], Router: { default: deepseek/deepseek-chat } }字段含义示例值HOST/PORT本地网关监听地址Claude Code 指向它127.0.0.1/3456API_TIMEOUT_MS上游模型请求超时时间毫秒600000Providers[].name提供商名称路由时以「名称/模型」引用deepseekapi_base_url模型服务地址https://api.deepseek.comapi_key服务密钥支持$变量引用环境变量$DEEPSEEK_API_KEYmodels该提供商下可用的模型 ID 列表deepseek-chatRouter.default默认路由目标deepseek/deepseek-chat需要注意桌面版将运行配置维护在 SQLite 数据库中位置见 docs/src/content/docs/zh/configuration/configuration-file.mdconfig.json仅在没有数据库时作为迁移来源读取一次。因此日常建议在ccr ui界面中管理提供商和路由界面内也提供 DeepSeek 预设导入。路由机制请求如何按场景分发到不同模型token 指模型计费与计量所用的词元单位router 指决定「这次请求交给哪个模型」的环节。CCR 处理每个请求的顺序是先由内置路由识别请求来源与场景再依次匹配用户自定义规则最后交给 transformer 做协议转换并转发。Claude Code 的不同请求对应不同场景场景配置项触发时机主对话default常规对话与编码请求后台任务background标题生成、摘要等低成本后台请求扩展思考think需要 reasoning 的复杂推理请求长上下文longContext上下文长度超过设定阈值联网搜索webSearch请求需要网页检索能力整体流程如下内置路由与自定义规则的细节见 docs/src/content/docs/zh/configuration/routing.md。按场景选模型DeepSeek 模型对比表Claude Code 模型路由配置的核心是给每个场景指定合适的模型参考如下模型 ID 以 DeepSeek 平台实际可用为准场景配置项推荐模型适用任务日常编码defaultdeepseek-chat一般问答、代码补全、代码解释后台小任务background轻量 Flash 级模型标题生成、摘要、低成本并行子代理复杂推理thinkdeepseek-reasoner数学推导、算法设计、多步规划长文档分析longContext长上下文模型可跨提供商仓库级上下文整理、长文档问答联网检索webSearch具备搜索能力的模型实时信息获取高级配置自定义路由规则、子代理与环境变量在路由页面添加自定义规则按请求头或请求体字段设置条件命中后改写目标模型规则按列表顺序匹配第一条命中即生效。更复杂的判断可用 Node.js 脚本规则脚本可访问请求摘要与 token 估算例如按关键词分发const text input.summary.lastUserText || ; if (/debug|单测|修复/.test(text)) { return { model: deepseek/deepseek-chat }; } if (/证明|推导|算法设计/.test(text)) { return { model: deepseek/deepseek-reasoner }; } return null; // 不命中走默认路由子代理指定模型Claude Code 派生的子代理Subagent请求可以在 prompt 首行携带模型标签CCR 内置路由会提取并删除该标签把请求路由到指定模型CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请分析这道数学题的解题步骤……API Key 管理配置中api_key支持$变量名写法避免密钥写死在文件里export DEEPSEEK_API_KEYsk-xxxx成本与性能基于 token 的路由和日志监控脚本规则可直接读取input.tokenCountCCR 估算的输入 token 数实现按上下文规模分流小请求走便宜模型、大请求走长上下文模型if (input.tokenCount 20000) { return { model: deepseek/deepseek-v3.2 }; } if (input.tokenCount 1000) { return { model: deepseek/deepseek-chat }; } return null;成本方面DeepSeek 各模型的输入输出定价普遍低于 Claude 旗舰模型具体数值以两家官方定价页为准这里不做数字承诺。CCR 界面为每个模型标注了单价请求日志中会按 token 用量给出成本估计便于核对实际花费。日志监控在设置中开启请求日志后管理界面可查询每次请求的最终路由模型、耗时、token 用量与成本估计失败请求还会记录错误信息用于排查路由或上游问题。生产部署Docker 容器化与 CI 集成仓库提供 Docker 部署方式说明见 docker/README.mddocker compose up -d --build容器内设置HOME/data配置数据库位于/data/.claude-code-router/config.sqlite。持久化时挂载整个/data目录即可保留配置与日志密钥通过环境变量注入例如DEEPSEEK_API_KEY。CI 场景下可以在流水线里安装并启动 CCR再把代理的模型端点指向本地网关steps: - name: Start router run: | npm install -g musistudio/claude-code-router export DEEPSEEK_API_KEY${{ secrets.DEEPSEEK_API_KEY }} ccr start无人值守环境注意在启动前准备好配置或界面完成初始化避免服务在无提供商可用状态下空跑。常见问题连接超时、代理与 token 上限连接超时推理类模型响应慢时调大API_TIMEOUT_MS默认已是 600000 毫秒若走代理先确认代理端口可达再在设置的 proxy 部分为上游请求指定代理。代理设置CCR 支持系统代理与自定义上游两种模式跨境访问 DeepSeek 或反向访问时在界面 proxy 配置中切换上游模式并填写地址与认证信息。输出 token 上限当上游返回max_tokens相关错误时说明请求要求的输出长度超过模型上限。可在模型配置中下调最大输出 token或换用输出上限更高的模型对长文档请求优先调整longContext场景的模型而不是强行加长输出。配置不生效确认 CCR 未处于运行状态时再迁移 JSON 配置运行中请通过界面修改界面保存会即时写入 SQLite 数据库。小结Claude Code Router 把 Claude Code 的模型请求收敛到本地网关DeepSeek 作为内置预设可以直接接入无需自行处理协议转换。最小路径是安装 CLI、写入包含Providers与Router.default的 JSON 配置、用环境变量管理密钥然后启动ccr start。路由层面内置场景default、background、think、longContext、webSearch负责粗分发自定义规则与脚本负责细粒度策略子代理可通过标签指定模型。成本与排障主要依赖请求日志中的路由、耗时与 token 数据。【免费下载链接】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），仅供参考 4 步把 Claude Code 的请求路由到 DeepSeek 模型：Claude Code Router 实践
4 步把 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-routerClaude Code Router下称 CCR是一个本地模型网关它为 Claude Code 等编程代理提供统一的本地端点把每次模型请求转发到你配置的提供商与模型上。本文以 DeepSeek 集成为主线依次说明 CCR 的定位、最小可运行配置、路由机制、按场景分发模型的方法、高级定制手段以及成本监控与生产部署覆盖从 DeepSeek 接入 Claude Code 到多模型路由策略的完整过程。认识项目Claude Code Router 是什么Claude Code Router 是一个运行在本地的模型网关与控制面。Claude Code 默认只调用 Anthropic 的模型而 CCR 在本地默认127.0.0.1:3456暴露一个兼容端点接收请求后完成三件事判断请求属于哪类场景选择目标提供商和模型做协议转换transformer把 Anthropic Messages 格式的请求转成目标模型支持的格式再把响应转回来记录每次请求的最终路由、耗时、token 用量与成本估计供界面查看。DeepSeek 是 CCR 内置的提供商预设之一使用 OpenAI Chat Completions 兼容协议预设定义见 packages/core/src/providers/presets/deepseek/index.ts。因此 DeepSeek 接入 Claude Code 不需要自己写转换逻辑把 Claude Code 指向 CCR 的本地端点由 CCR 负责协议适配与路由。安装 Claude Code Router 并准备最小配置通过 npm 全局安装 CLI然后启动服务npm install -g musistudio/claude-code-router ccr start # 后台启动管理服务和网关ccr ui 可打开管理界面最小可运行的配置如下保存为~/.claude-code-router/config.json{ HOST: 127.0.0.1, PORT: 3456, API_TIMEOUT_MS: 600000, Providers: [ { name: deepseek, api_base_url: https://api.deepseek.com, api_key: $DEEPSEEK_API_KEY, models: [deepseek-chat, deepseek-reasoner] } ], Router: { default: deepseek/deepseek-chat } }字段含义示例值HOST/PORT本地网关监听地址Claude Code 指向它127.0.0.1/3456API_TIMEOUT_MS上游模型请求超时时间毫秒600000Providers[].name提供商名称路由时以「名称/模型」引用deepseekapi_base_url模型服务地址https://api.deepseek.comapi_key服务密钥支持$变量引用环境变量$DEEPSEEK_API_KEYmodels该提供商下可用的模型 ID 列表deepseek-chatRouter.default默认路由目标deepseek/deepseek-chat需要注意桌面版将运行配置维护在 SQLite 数据库中位置见 docs/src/content/docs/zh/configuration/configuration-file.mdconfig.json仅在没有数据库时作为迁移来源读取一次。因此日常建议在ccr ui界面中管理提供商和路由界面内也提供 DeepSeek 预设导入。路由机制请求如何按场景分发到不同模型token 指模型计费与计量所用的词元单位router 指决定「这次请求交给哪个模型」的环节。CCR 处理每个请求的顺序是先由内置路由识别请求来源与场景再依次匹配用户自定义规则最后交给 transformer 做协议转换并转发。Claude Code 的不同请求对应不同场景场景配置项触发时机主对话default常规对话与编码请求后台任务background标题生成、摘要等低成本后台请求扩展思考think需要 reasoning 的复杂推理请求长上下文longContext上下文长度超过设定阈值联网搜索webSearch请求需要网页检索能力整体流程如下内置路由与自定义规则的细节见 docs/src/content/docs/zh/configuration/routing.md。按场景选模型DeepSeek 模型对比表Claude Code 模型路由配置的核心是给每个场景指定合适的模型参考如下模型 ID 以 DeepSeek 平台实际可用为准场景配置项推荐模型适用任务日常编码defaultdeepseek-chat一般问答、代码补全、代码解释后台小任务background轻量 Flash 级模型标题生成、摘要、低成本并行子代理复杂推理thinkdeepseek-reasoner数学推导、算法设计、多步规划长文档分析longContext长上下文模型可跨提供商仓库级上下文整理、长文档问答联网检索webSearch具备搜索能力的模型实时信息获取高级配置自定义路由规则、子代理与环境变量在路由页面添加自定义规则按请求头或请求体字段设置条件命中后改写目标模型规则按列表顺序匹配第一条命中即生效。更复杂的判断可用 Node.js 脚本规则脚本可访问请求摘要与 token 估算例如按关键词分发const text input.summary.lastUserText || ; if (/debug|单测|修复/.test(text)) { return { model: deepseek/deepseek-chat }; } if (/证明|推导|算法设计/.test(text)) { return { model: deepseek/deepseek-reasoner }; } return null; // 不命中走默认路由子代理指定模型Claude Code 派生的子代理Subagent请求可以在 prompt 首行携带模型标签CCR 内置路由会提取并删除该标签把请求路由到指定模型CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请分析这道数学题的解题步骤……API Key 管理配置中api_key支持$变量名写法避免密钥写死在文件里export DEEPSEEK_API_KEYsk-xxxx成本与性能基于 token 的路由和日志监控脚本规则可直接读取input.tokenCountCCR 估算的输入 token 数实现按上下文规模分流小请求走便宜模型、大请求走长上下文模型if (input.tokenCount 20000) { return { model: deepseek/deepseek-v3.2 }; } if (input.tokenCount 1000) { return { model: deepseek/deepseek-chat }; } return null;成本方面DeepSeek 各模型的输入输出定价普遍低于 Claude 旗舰模型具体数值以两家官方定价页为准这里不做数字承诺。CCR 界面为每个模型标注了单价请求日志中会按 token 用量给出成本估计便于核对实际花费。日志监控在设置中开启请求日志后管理界面可查询每次请求的最终路由模型、耗时、token 用量与成本估计失败请求还会记录错误信息用于排查路由或上游问题。生产部署Docker 容器化与 CI 集成仓库提供 Docker 部署方式说明见 docker/README.mddocker compose up -d --build容器内设置HOME/data配置数据库位于/data/.claude-code-router/config.sqlite。持久化时挂载整个/data目录即可保留配置与日志密钥通过环境变量注入例如DEEPSEEK_API_KEY。CI 场景下可以在流水线里安装并启动 CCR再把代理的模型端点指向本地网关steps: - name: Start router run: | npm install -g musistudio/claude-code-router export DEEPSEEK_API_KEY${{ secrets.DEEPSEEK_API_KEY }} ccr start无人值守环境注意在启动前准备好配置或界面完成初始化避免服务在无提供商可用状态下空跑。常见问题连接超时、代理与 token 上限连接超时推理类模型响应慢时调大API_TIMEOUT_MS默认已是 600000 毫秒若走代理先确认代理端口可达再在设置的 proxy 部分为上游请求指定代理。代理设置CCR 支持系统代理与自定义上游两种模式跨境访问 DeepSeek 或反向访问时在界面 proxy 配置中切换上游模式并填写地址与认证信息。输出 token 上限当上游返回max_tokens相关错误时说明请求要求的输出长度超过模型上限。可在模型配置中下调最大输出 token或换用输出上限更高的模型对长文档请求优先调整longContext场景的模型而不是强行加长输出。配置不生效确认 CCR 未处于运行状态时再迁移 JSON 配置运行中请通过界面修改界面保存会即时写入 SQLite 数据库。小结Claude Code Router 把 Claude Code 的模型请求收敛到本地网关DeepSeek 作为内置预设可以直接接入无需自行处理协议转换。最小路径是安装 CLI、写入包含Providers与Router.default的 JSON 配置、用环境变量管理密钥然后启动ccr start。路由层面内置场景default、background、think、longContext、webSearch负责粗分发自定义规则与脚本负责细粒度策略子代理可通过标签指定模型。成本与排障主要依赖请求日志中的路由、耗时与 token 数据。【免费下载链接】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），仅供参考