Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.280 ·

New detection for misordered 'system' role messages in API errors

Claude Code now recognizes API errors about misplaced 'system' role messages and pinpoints the offending message

TierUnder the hoodhow much it should matter to you
Useful1my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaError Handlingwhat it touches
KindInternal Changesin v2.1.280,
Under the hood

Claude Code now recognizes API errors about misplaced 'system' role messages and pinpoints the offending message

What

Claude Code can now detect a specific class of API error: when the API complains that a system role message needs to come before or after other messages, or that the top-level system parameter should be used instead for the initial system prompt. A new parser extracts the index of the offending message from the error text when it's present.

Why

This allows Claude Code to recognize and potentially handle this error condition more precisely, since it can now identify exactly which message in the conversation caused the problem.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat Claude Code does with the detected error or message index beyond parsing it is not stated.

See this entry in the whole of v2.1.280 →

Feedback