尧图网页设计 
Claude Code 接入第三方模型的 5 个坑位完整清单来自 deepclaude 的 thinking 块剥离与模型名重映射实战【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaude想让Claude Code接入第三方模型DeepSeek、OpenRouter 等 Anthropic 兼容后端最省钱的方案 deepclaude 已经把路上的 5 个坑全踩平了。它的核心思路是换掉大脑保留身体——终端、工具循环、文件编辑、bash、git 全部不动只把 API 调用从 Anthropic$15/M 输出换到 DeepSeek V4 Pro$0.87/M 输出同样体验便宜约 17 倍。这篇文章带你逐个拆解这 5 个坑位并给出 deepclaude 里的解法模型名重映射、thinking 块剥离、usage 字段注入、鉴权头重写和远程控制分流。看完你既能用好 deepclaude也能自己给任意项目做第三方模型适配。 为什么值得折腾先看一张成本对比表Claude Code Max 订阅 $200/月且有用量上限用 deepclaude 走 DeepSeek 后使用强度Anthropic Maxdeepclaude (DeepSeek)节省轻度每月 10 天$200/月封顶约 $20/月90%重度每月 25 天$200/月封顶约 $50/月75%带自动循环任务$200/月封顶约 $80/月60%DeepSeek 还有自动上下文缓存多轮对话后系统提示词和文件上下文命中缓存价$0.004/M未缓存为 $0.44/MAgent 循环越跑越便宜。 完整定价对比可以用deepclaude --cost查看源码在 deepclaude.sh。坑位 1模型名对不上 —— 必须做模型名重映射现象Claude Code 发请求时写的是claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-...这些 Anthropic 专属模型名。第三方后端根本不认识这些名字直接报 404/400。解法在请求转发前把model字段逐个改写。deepclaude 的映射表在 model-proxy.jsClaude Code 发送的模型名DeepSeek 后端OpenRouter 后端claude-opus-4-6 / opus-4-7deepseek-v4-prodeepseek/deepseek-v4-proclaude-sonnet-4-6 等deepseek-v4-flashdeepseek/deepseek-v4-flashclaude-haiku-4-5-...deepseek-v4-flashdeepseek/deepseek-v4-flash注意一个新手容易忽略的细节不同后端对同一个模型的命名规则不一样。DeepSeek 直接用deepseek-v4-proOpenRouter 必须带厂商前缀deepseek/deepseek-v4-proFireworks 甚至是accounts/fireworks/models/deepseek-v4-pro。映射表必须按后端各写一份这也是 model-proxy.js 里MODEL_REMAP按后端分组的缘故。不走代理、直接改环境变量时deepclaude 也是按这一层重映射表给 Claude Code 注入模型名的见 deepclaude.sh 的set_model_env()Opus/Sonnet/Haiku/子代理四个槽位分别指向 DeepSeek 模型。坑位 2thinking 块会被第三方后端拒收 —— 发送前必须剥离现象Claude Code 默认开启思考模式thinking多轮对话中历史消息里会夹带thinking块。把这种消息原样发给 DeepSeek 等第三方后端对方会拒收——哪怕这个块是带签名的也不认因为它不是自己生成的。解法deepclaude 在 model-proxy.js 实现了两个剥离函数对应两种策略发给第三方后端 → 全量剥离stripAllThinkingBlocks把messages里所有type: thinking的块删掉再转发见 model-proxy.js 的转发逻辑。发回 Anthropic → 分情况纯 Anthropic 会话只剥未签名的 thinking 块stripUnsignedThinkingBlocks签名的要保留否则 Anthropic 端会报错会话中途切走过第三方后端切回 Anthropic 后要全量剥离因为第三方后端产生的带签名但无效的块能通过未签名过滤发给 Anthropic 照样 400。这是最隐蔽的一个坑对应 model-proxy.js 的注释说明。 一句话记忆thinking 块谁生成的谁认账跨后端流转前一律剥掉。Claude Code 终端中使用 /deepseek 斜杠命令切换第三方模型后端状态栏显示 deepseek-v4-pro 模型坑位 3usage 字段缺失会直接崩掉 Claude Code现象Claude Code 依赖流式响应SSE里message_start/message_delta事件中的usage.input_tokens和usage.output_tokens来统计用量。DeepSeek、OpenRouter 有时会省略这个字段Claude Code 解析时抛$.input_tokens is undefined整个会话卡死。解法deepclaude 在 model-proxy.js 里写了一个流式转换器UsageNormalizer逐事件拦截 SSE发现缺usage就补一个零值兜底顺手还把 token 数记下来做成本统计。非流式的 JSON 响应也有对应的normalizeJsonBody兜底model-proxy.js。这个坑不崩则已、一崩致命且报错信息完全看不出是第三方后端的问题是最玄学的一个坑位。坑位 4鉴权头不通用 —— x-api-key 与 Bearer 二选一现象Anthropic 官方 API 用x-api-key头传密钥而 OpenRouter、Fireworks 用标准的Authorization: Bearer key。客户端带哪头都不重要——转发时必须按目标后端换成正确的那一种且要把客户端原来的鉴权头删掉否则两边撞车401/403 伺候。解法deepclaude 在 model-proxy.js 里对模型调用统一处理先delete掉authorization和x-api-key再根据目标后端类型注入正确格式。后端类型表见 start-proxy.js四个后端一览后端启动参数输入/M输出/M特点DeepSeek默认deepclaude$0.44$0.87自动上下文缓存多轮再便宜 120 倍OpenRouterdeepclaude --backend or$0.44$0.87美欧延迟最低Fireworks AIdeepclaude --backend fw$1.74$3.48推理最快Anthropicdeepclaude --backend anthropic$3.00$15.00难题兜底Opus 更强另外提醒这些环境变量是deepclaude 按会话临时设置、退出后自动恢复的不会污染你本机 Claude Code 的原始配置见 deepclaude.sh。坑位 5远程控制是双通道只改 Base URL 不够现象Claude Code 的远程控制--remote浏览器/手机访问会话有两条通道Bridge WebSocketwss://bridge.claudeusercontent.comAnthropic 硬编码必须走 Anthropic OAuth模型 API 调用走ANTHROPIC_BASE_URL可配置。新手常犯的错把ANTHROPIC_AUTH_TOKEN设成 DeepSeek 的 key 想省成本——结果 Bridge 鉴权直接被搞坏远程会话起不来。解法本地起一个代理做流量分流Bridge 相关请求原路透传 Anthropic保留 OAuth只有/v1/messages模型调用改道 DeepSeek原理见 proxy/README.md。分流后效果如文首截图浏览器里的 Claude Code 会话模型下拉菜单选的就是deepseek/deepseek-v4-pro。⚠️ 前提条件已claude auth login登录、持有 claude.ai 订阅、Node.js 18。✅ 上手验证清单5 个坑位逐项确认#坑位验证方法1模型名重映射deepclaude --status查看后端与密钥状态终端状态栏应显示deepseek-v4-pro2thinking 块剥离开启思考模式跑多轮对话中途/deepseek↔/anthropic来回切换不报 4003usage 字段兜底会话不出现input_tokens is undefinedcurl 127.0.0.1:3200/_proxy/cost能看到 token 统计4鉴权头正确--benchmark三个后端各发 1 个测试请求全部返回 2005远程双通道deepclaude --remote能拿到浏览器 URLBridge 与模型调用各走各的几个实用小技巧会话中热切换无需重启在 Claude Code 里输入/deepseek、/anthropic、/openrouter斜杠命令或命令行deepclaude --switch ds原理是代理的/_proxy/mode端点见 model-proxy.js省钱追踪代理实时记录各后端 token 用量并折算Anthropic 等价价一条curl就能看省了多少钱性能对比deepclaude --benchmark对各提供商做延迟测试挑最快的后端。 延伸阅读完整使用文档与成本分析README.md代理技术细节proxy/README.md核心代理实现thinking 剥离 / 模型重映射 / usage 兜底proxy/model-proxy.js启动器脚本deepclaude.sh / deepclaude.ps1总结Claude Code 接入第三方模型表面看只是改个 Base URL实际要闯过模型名、thinking 块、usage 统计、鉴权头、双通道这 5 道关。deepclaude 用不到 500 行代理代码把这 5 个坑位全部闭环你直接复用即可理解这套机制后把它搬到自己项目上做任意第三方模型适配也就是照葫芦画瓢的事。【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Code 接入第三方模型的 5 个坑位完整清单：来自 deepclaude 的 thinking 块剥离与模型名重映射实战
Claude Code 接入第三方模型的 5 个坑位完整清单来自 deepclaude 的 thinking 块剥离与模型名重映射实战【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaude想让Claude Code接入第三方模型DeepSeek、OpenRouter 等 Anthropic 兼容后端最省钱的方案 deepclaude 已经把路上的 5 个坑全踩平了。它的核心思路是换掉大脑保留身体——终端、工具循环、文件编辑、bash、git 全部不动只把 API 调用从 Anthropic$15/M 输出换到 DeepSeek V4 Pro$0.87/M 输出同样体验便宜约 17 倍。这篇文章带你逐个拆解这 5 个坑位并给出 deepclaude 里的解法模型名重映射、thinking 块剥离、usage 字段注入、鉴权头重写和远程控制分流。看完你既能用好 deepclaude也能自己给任意项目做第三方模型适配。 为什么值得折腾先看一张成本对比表Claude Code Max 订阅 $200/月且有用量上限用 deepclaude 走 DeepSeek 后使用强度Anthropic Maxdeepclaude (DeepSeek)节省轻度每月 10 天$200/月封顶约 $20/月90%重度每月 25 天$200/月封顶约 $50/月75%带自动循环任务$200/月封顶约 $80/月60%DeepSeek 还有自动上下文缓存多轮对话后系统提示词和文件上下文命中缓存价$0.004/M未缓存为 $0.44/MAgent 循环越跑越便宜。 完整定价对比可以用deepclaude --cost查看源码在 deepclaude.sh。坑位 1模型名对不上 —— 必须做模型名重映射现象Claude Code 发请求时写的是claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-...这些 Anthropic 专属模型名。第三方后端根本不认识这些名字直接报 404/400。解法在请求转发前把model字段逐个改写。deepclaude 的映射表在 model-proxy.jsClaude Code 发送的模型名DeepSeek 后端OpenRouter 后端claude-opus-4-6 / opus-4-7deepseek-v4-prodeepseek/deepseek-v4-proclaude-sonnet-4-6 等deepseek-v4-flashdeepseek/deepseek-v4-flashclaude-haiku-4-5-...deepseek-v4-flashdeepseek/deepseek-v4-flash注意一个新手容易忽略的细节不同后端对同一个模型的命名规则不一样。DeepSeek 直接用deepseek-v4-proOpenRouter 必须带厂商前缀deepseek/deepseek-v4-proFireworks 甚至是accounts/fireworks/models/deepseek-v4-pro。映射表必须按后端各写一份这也是 model-proxy.js 里MODEL_REMAP按后端分组的缘故。不走代理、直接改环境变量时deepclaude 也是按这一层重映射表给 Claude Code 注入模型名的见 deepclaude.sh 的set_model_env()Opus/Sonnet/Haiku/子代理四个槽位分别指向 DeepSeek 模型。坑位 2thinking 块会被第三方后端拒收 —— 发送前必须剥离现象Claude Code 默认开启思考模式thinking多轮对话中历史消息里会夹带thinking块。把这种消息原样发给 DeepSeek 等第三方后端对方会拒收——哪怕这个块是带签名的也不认因为它不是自己生成的。解法deepclaude 在 model-proxy.js 实现了两个剥离函数对应两种策略发给第三方后端 → 全量剥离stripAllThinkingBlocks把messages里所有type: thinking的块删掉再转发见 model-proxy.js 的转发逻辑。发回 Anthropic → 分情况纯 Anthropic 会话只剥未签名的 thinking 块stripUnsignedThinkingBlocks签名的要保留否则 Anthropic 端会报错会话中途切走过第三方后端切回 Anthropic 后要全量剥离因为第三方后端产生的带签名但无效的块能通过未签名过滤发给 Anthropic 照样 400。这是最隐蔽的一个坑对应 model-proxy.js 的注释说明。 一句话记忆thinking 块谁生成的谁认账跨后端流转前一律剥掉。Claude Code 终端中使用 /deepseek 斜杠命令切换第三方模型后端状态栏显示 deepseek-v4-pro 模型坑位 3usage 字段缺失会直接崩掉 Claude Code现象Claude Code 依赖流式响应SSE里message_start/message_delta事件中的usage.input_tokens和usage.output_tokens来统计用量。DeepSeek、OpenRouter 有时会省略这个字段Claude Code 解析时抛$.input_tokens is undefined整个会话卡死。解法deepclaude 在 model-proxy.js 里写了一个流式转换器UsageNormalizer逐事件拦截 SSE发现缺usage就补一个零值兜底顺手还把 token 数记下来做成本统计。非流式的 JSON 响应也有对应的normalizeJsonBody兜底model-proxy.js。这个坑不崩则已、一崩致命且报错信息完全看不出是第三方后端的问题是最玄学的一个坑位。坑位 4鉴权头不通用 —— x-api-key 与 Bearer 二选一现象Anthropic 官方 API 用x-api-key头传密钥而 OpenRouter、Fireworks 用标准的Authorization: Bearer key。客户端带哪头都不重要——转发时必须按目标后端换成正确的那一种且要把客户端原来的鉴权头删掉否则两边撞车401/403 伺候。解法deepclaude 在 model-proxy.js 里对模型调用统一处理先delete掉authorization和x-api-key再根据目标后端类型注入正确格式。后端类型表见 start-proxy.js四个后端一览后端启动参数输入/M输出/M特点DeepSeek默认deepclaude$0.44$0.87自动上下文缓存多轮再便宜 120 倍OpenRouterdeepclaude --backend or$0.44$0.87美欧延迟最低Fireworks AIdeepclaude --backend fw$1.74$3.48推理最快Anthropicdeepclaude --backend anthropic$3.00$15.00难题兜底Opus 更强另外提醒这些环境变量是deepclaude 按会话临时设置、退出后自动恢复的不会污染你本机 Claude Code 的原始配置见 deepclaude.sh。坑位 5远程控制是双通道只改 Base URL 不够现象Claude Code 的远程控制--remote浏览器/手机访问会话有两条通道Bridge WebSocketwss://bridge.claudeusercontent.comAnthropic 硬编码必须走 Anthropic OAuth模型 API 调用走ANTHROPIC_BASE_URL可配置。新手常犯的错把ANTHROPIC_AUTH_TOKEN设成 DeepSeek 的 key 想省成本——结果 Bridge 鉴权直接被搞坏远程会话起不来。解法本地起一个代理做流量分流Bridge 相关请求原路透传 Anthropic保留 OAuth只有/v1/messages模型调用改道 DeepSeek原理见 proxy/README.md。分流后效果如文首截图浏览器里的 Claude Code 会话模型下拉菜单选的就是deepseek/deepseek-v4-pro。⚠️ 前提条件已claude auth login登录、持有 claude.ai 订阅、Node.js 18。✅ 上手验证清单5 个坑位逐项确认#坑位验证方法1模型名重映射deepclaude --status查看后端与密钥状态终端状态栏应显示deepseek-v4-pro2thinking 块剥离开启思考模式跑多轮对话中途/deepseek↔/anthropic来回切换不报 4003usage 字段兜底会话不出现input_tokens is undefinedcurl 127.0.0.1:3200/_proxy/cost能看到 token 统计4鉴权头正确--benchmark三个后端各发 1 个测试请求全部返回 2005远程双通道deepclaude --remote能拿到浏览器 URLBridge 与模型调用各走各的几个实用小技巧会话中热切换无需重启在 Claude Code 里输入/deepseek、/anthropic、/openrouter斜杠命令或命令行deepclaude --switch ds原理是代理的/_proxy/mode端点见 model-proxy.js省钱追踪代理实时记录各后端 token 用量并折算Anthropic 等价价一条curl就能看省了多少钱性能对比deepclaude --benchmark对各提供商做延迟测试挑最快的后端。 延伸阅读完整使用文档与成本分析README.md代理技术细节proxy/README.md核心代理实现thinking 剥离 / 模型重映射 / usage 兜底proxy/model-proxy.js启动器脚本deepclaude.sh / deepclaude.ps1总结Claude Code 接入第三方模型表面看只是改个 Base URL实际要闯过模型名、thinking 块、usage 统计、鉴权头、双通道这 5 道关。deepclaude 用不到 500 行代理代码把这 5 个坑位全部闭环你直接复用即可理解这套机制后把它搬到自己项目上做任意第三方模型适配也就是照葫芦画瓢的事。【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考