关于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 variantsystem, expecteduserorassistantat 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 当前版本的消息协议，不支持systemrole

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. 降级安装命令

npminstall-g@anthropic-ai/claude-code@2.1.148

---

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

npmuninstall-g@anthropic-ai/claude-code

然后重新安装指定版本。

---

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

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

1. 删除本地 Claude Code

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

或 Windows PowerShell：

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

---

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

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

---

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

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

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

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

或在 shell 中设置：

exportDISABLE_AUTOUPDATER=1

---

六、可选版本策略

根据社区反馈：

版本	状态
2.1.148	稳定可用
2.1.152	可用
2.1.153	可用
>=2.1.154	部分功能更新，但存在兼容变化

---

七、问题本质总结

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

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 不一致导致的协议错误

短期最稳定的解决方案：

npminstall-g@anthropic-ai/claude-code@2.1.148

并关闭自动更新。

---

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