System message must be at the beginning.：Claude Code

Quick fix

将 Claude Code 的 "model" 从 "opus" 改为 "haiku" 或其他模型族，以避免 OpenAI 兼容 API 返回 400。

Symptom

报错原文复制

API Error: 400 System message must be at the beginning.

Cause

在 cc-switch 代理 OpenAI 兼容聊天 API 时，Claude Code 使用 "opus" 模型族发出的请求会保留非首位的 system 消息。该后端要求 role: system 位于 messages 数组的第一项，因此拒绝请求并返回 400。

该 issue 中，"haiku" 模型族走的是另一条消息构建路径，system 消息恰好位于首位，所以会话可以正常运行。Issue 建议 cc-switch 在 Anthropic 到 OpenAI Chat Completions 的转换中规范化 system 消息顺序，但该 issue 仍处于 open 状态。

Fix

1. 1

   在 Claude Code 的 cc-switch 配置中，将 "model" 从 "opus" 改为 "haiku"，或改用其他模型族。

2. 2

   重新启动 Claude Code 会话，确认不再出现该 400 错误。

Affected Versions

ToolClaude Code

Version3.20.4（受影响版本）

PlatformsmacOS

Source Issues

本页汇总自 1 个真实 issue

• #7654代理 OpenAI 兼容 API 时 system 消息位置错误导致 400 报错

FAQ

（暂无 FAQ）

相关问题

<thinking> 标签作为正文输出 Claude Code将 provider 的 apiFormat 从 openai_chat 改为 anthropic（若上游支持），可绕过内联 <thinking> 泄露。1 issues merged模型显示错误 Claude Code为 ccstatusline 配置 Custom Command，从当前 cc-switch 供应商配置读取模型名。1 issues mergedmessages.content.type 参数非法 Claude Code多数相关 issue 仍未解决；升级到包含 #7656 修复的版本，使中文图片拒绝错误触发图片降级重试。1 issues merged