Claude Code CLI连接 DeepSeek V4模型后调用报400错误

API 400错误

API Error: 400 {"error":{"message":"The content[].thinking in the thinking mode must be passed back to the API.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}

当前claude版本: 2.1.118 (Claude Code)

这个错误是 Claude Code 在使用 DeepSeek V4 模型时因思考模式(thinking mode)的机制引发的。

一、错误原因

DeepSeek V4 的思考模式机制

DeepSeek V4 默认启用思考模式(thinking mode),模型在输出最终答案前会先输出一段思维链(Chain-of-Thought),通过 reasoning_content 参数返回。

API 对 Tool Call(工具调用)轮次(即 Agent 多轮交互场景)的推理连续性有严格校验,官方文档明确指出:

"在两个 user 消息之间,如果模型进行了工具调用,则中间 assistant 的 reasoning_content 需参与上下文拼接,在后续所有 user 交互轮次中必须回传给 API。"
https://api-docs.deepseek.com/zh-cn/guides/thinking_mode
微信截图_20260428163512

触发该错误的典型场景

  1. 同一对话中切换过不同厂商的模型
    会话前半段使用了 OpenAI、Anthropic 或其他非 DeepSeek 模型,切回 DeepSeek V4 后,Claude Code 尝试将之前的对话历史(不含 reasoning_content)发给 DeepSeek,而 DeepSeek 严格校验发现缺少应有的 reasoning_content,便报出 The content[].thinking in the thinking mode must be passed back to the API 错误。

  2. 中间层(API 网关、代理、中转服务)未能完整透传 reasoning_content
    若通过 API 网关、代理或中转服务调用 DeepSeek,这些中间层可能丢失或未正确处理 reasoning_content 字段,导致 API 收到的消息不完整。
    这种情况常见于在 Claude Code 中通过第三方代理接入 DeepSeek 的场景——代理协议转换时如果漏掉了 reasoning_content 字段,就会触发校验失败。

  3. 对话历史中缺失必要的 reasoning_content 信息
    在多轮 Agent 对话中,新的请求必须携带完整的消息历史,其中包含此前所有轮次返回的 reasoning_content。如果 Claude Code 在拼接上下文时遗漏了该字段,也会触发该错误。


二、解决方案汇总

✅ 方案1:新开对话会话(最直接最彻底)

如果对话中途出现该错误,最快捷的解决方式是直接重启 Claude Code 或开启一个全新的对话会话,不要复用之前已损坏的会话上下文。


✅ 方案2:避免在同一对话中切换不同厂商的模型

DeepSeek V4 对工具调用轮次有严格的推理连续性要求,混用其他模型会破坏这一结构。建议:

  • 在一个会话中始终使用 DeepSeek V4 模型,不要中途切换
  • 如果需要换模型,直接开启新的会话,不要沿用旧历史的上下文


✅ 方案3:升级 Claude Code 和相关工具至最新版

开发者社区反馈新版 Claude Code 对 DeepSeek 思考模式的兼容性有所改善。建议更新至最新版本:

同时检查 Claude Code 的版本:

claude --version

✅ 方案4:检查 API 网关/代理/中转服务是否完整透传 reasoning_content

如果你的请求经过了代理网关(如 SuCloud、SiliconFlow 等),请向服务提供方确认:

  • 网关是否完整支持 DeepSeek V4 思考模式
  • reasoning_content 字段是否在响应和后续请求中被正确保留和透传

社区也曾报告类似问题——群友反馈用 API 网关中转时经常遇到该错误,改用官方直连后问题消失。建议尽量直接使用 DeepSeek 官方 API:

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

✅ 方案5:确认对话历史拼接策略符合 DeepSeek API 规范

DeepSeek 要求每次请求携带完整的对话历史,且包含所有 assistant 消息中的 reasoning_content 字段。如果使用自定义代理或网关,应确保:

  1. 从 API 响应中正确提取 reasoning_content
  2. 在后续请求中将其连同 content 一并塞入 messages[-2](即上一条 assistant 消息)
  3. 不丢失任何字段——任何字段的缺失都可能触发严格校验报错

备选方案:关闭思考模式

如果上述方案均无效,可在 Claude Code 的配置中关闭思考模式,使其按非思考模式运行。

不过需要注意的是:

  • DeepSeek V4 思考模式默认启用
  • 关闭思考模式可能影响 Agent 场景下模型的表现,对于复杂 Agent 场景(如 Claude Code、OpenCode),思考模式的 effort 会自动设置为 max

posted @ 2026-04-28 16:25  悠哉大斌  阅读(1499)  评论(1)    收藏  举报