Under the hoodTier: how much it should matter to you
1Useful: my rating, 1 to 5
0Signal: worth watching, 1 to 5
TelemetryArea: what it touches
Internal ChangesKind: in v2.1.321,
Internal ChangesSection of the release
What
When Claude Code cannot start, it stops with exit code 1. An exit code is the number a program hands back to whatever launched it. Some of these exits already recorded a reason, and more of them now do. The exit code is still 1. The reasons now recorded are:
session_held_by_background: the session is already held by a background task
sandbox_worktree_protection_failed: protection for a sandboxed worktree could not be set up
resume_failed: resuming an earlier session failed
worker_state_unread: the saved state of a worker could not be read
Why
A reason attached to each exit makes failed starts and failed resumes easier to tell apart when they are reported and counted. A plain exit code of 1 says only that something went wrong.
