Claude Code 连 DeepSeek 报错

近日，有开发者在 V2EX 社区反映，在使用 Anthropic 最新推出的命令行 AI 编码工具 Claude Code 桥接 DeepSeek 模型（如 deepseek-v4-pro 等兼容接口）时遭遇 API 400 报错。错误信息显示无法将 JSON 解析为目标类型，具体原因为 messages[1].role 出现未知的 system 角色，而接口期望的是 user 或 assistant。 该问题的技术根源在于 Claude Code 的上下文构建逻辑中，在消息历史的非首位（如第二条消息）发送了 system 角色消息。而许多 OpenAI 兼容的 API 网关（包括部分 DeepSeek 代理渠道或 OneAPI 等分发系统）有着严格的 Schema 校验，规定 system 角色只能作为首条消息出现，后续消息必须交替呈现 user 和 assistant。 这一冲突反映了 Claude Code 与主流兼容 API 在协议实现上的差异。对于想要使用低成本 DeepSeek 模型替代 Claude 官方 API 的开发者，建议通过配置 API 代理网关，开启“合并系统提示词”或“角色自动转换”功能来绕过此限制。