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.274 ·

CLI-too-old failure now emits structured JSON in stream-json/SDK mode

Version-mismatch startup failures now return structured JSON for SDK-driven sessions

TierUnder the hoodhow much it should matter to you
Useful2my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaSDKwhat it touches
KindImprovementsin v2.1.274,
Under the hood

Version-mismatch startup failures now return structured JSON for SDK-driven sessions

What

When Claude Code's CLI is too old to talk to a newer workspace or server, and it's running with --output-format stream-json plus CLAUDE_CODE_STARTUP_FAILURE_RESULTS set, the version-mismatch failure is now emitted as a structured JSON result object with startup_failure_reason: 'cli_version_too_old', instead of only printing a human-readable error to the console before exiting.

Why

Tools and SDKs that drive Claude Code programmatically can now detect and handle this specific failure reason directly from the output stream, rather than having to parse plain-text error messages.

See this entry in the whole of v2.1.274 →

Feedback