关于DeepSeek 在 Claude Code 中报错解决方法（400 JSON解析失败）“API Error: 400 Failed to deserialize the JSON body in

关于DeepSeek 在 Claude Code 中报错解决方法（400 JSON解析失败）“API Error: 400 Failed to deserialize the JSON body into the target type: messages[1].role: unknown variant system, expected user or assistant at line 1 column 492”

SEO关键词：DeepSeek Claude Code 报错、400 Failed to deserialize JSON、messages role system 错误、Claude Code 降级版本、DeepSeek API 兼容问题

在实际接入大模型 API 的过程中，经常会遇到“看似配置正确，但就是跑不通”的问题。这类问题通常不是业务逻辑，而是SDK / CLI 版本与 API 协议不兼容导致的。

本文复现并整理一个典型问题： 👉 DeepSeek 在 Claude Code 中报错 400 Failed to deserialize JSON body

在这里插入图片描述

"API Error: 400 Failed to deserialize the JSON body into the target type: messages[1].role: unknown variant `system`, expected `user` or `assistant` at line 1 column 492"

一、问题现象

在使用 DeepSeek 模型通过 Claude Code 调用时，直接报错：

API Error: 400 Failed to deserialize the JSON body into the target type:
messages[1].role: unknown variant `system`, expected `user` or `assistant`

二、错误原因分析

这个错误的核心点在于：

Claude Code 当前版本的消息协议，不支持 system role

1. OpenAI/DeepSeek 标准结构

正常情况下消息结构类似：

{
  "messages": [
    { "role": "system", "content": "xxx" },
    { "role": "user", "content": "xxx" }
  ]
}

2. Claude Code 旧版本限制

但在某些 Claude Code 版本中：

• 只支持 user
• 只支持 assistant
• 不接受 system

于是 DeepSeek 按标准 API 发出的请求直接被拒绝，导致 400 JSON 解析失败。

三、解决方案（核心）

社区验证最有效的方式是：

🔥 降级 Claude Code 到兼容版本

1. 推荐版本

@anthropic-ai/claude-code@2.1.148

2. 降级安装命令

npm install -g @anthropic-ai/claude-code@2.1.148

3. 如果已安装新版本，先卸载

npm uninstall -g @anthropic-ai/claude-code

然后重新安装指定版本。

四、Windows / 非 npm 安装用户处理方式

如果不是 npm 安装（例如 winget / native 安装），需要手动处理：

1. 删除本地 Claude Code

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

或 Windows PowerShell：

Remove-Item -Recurse -Force $env:USERPROFILE\.local\share\claude
Remove-Item -Force $env:USERPROFILE\.local\bin\claude

2. 重新安装旧版本（推荐 npm 方式）

统一安装路径，避免多版本冲突。

五、防止自动升级（很关键）

部分环境会自动升级 Claude Code，导致问题复现。

可以通过环境变量关闭自动更新：

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

或在 shell 中设置：

export DISABLE_AUTOUPDATER=1

六、可选版本策略

根据社区反馈：

七、问题本质总结

从工程角度看，这个问题本质是：

API schema evolution 与 CLI 消息协议不一致

具体表现为：

• DeepSeek 按标准 OpenAI message schema 输出 system
• Claude Code CLI 未同步支持
• JSON 反序列化直接失败（400）

八、替代方案（如果不想降级）

在这里插入图片描述

如果不想锁版本，可以考虑：

1. 使用 VSCode + Cline + DeepSeek API

这种方式对 OpenAI schema 兼容更完整。

2. 使用 OpenClaude / 兼容封装工具

一些社区项目已经做了协议适配层。

九、结论

这个问题不是 DeepSeek 或 Claude 单方 bug，而是：

CLI 工具版本与 API message schema 不一致导致的协议错误

短期最稳定的解决方案：

npm install -g @anthropic-ai/claude-code@2.1.148

并关闭自动更新。

如果后续 Claude Code 更新协议支持 system role，这个问题会自然消失。