What probably matters to youSection of the release
What
Claude Code can now report a specific, structured reason when it refuses to start, instead of just failing silently or with a generic message. This is meant for a host application (like an IDE extension or desktop wrapper) that embeds Claude Code, so it can react to the specific cause rather than just retrying blindly. New reason values include:
worktree_resume_refused and worktree_unverified (problems resuming a git worktree, an isolated working copy of a repo)
session_held_by_background (another process is using the session)
managed_settings_invalid and remote_settings_required_unavailable
proxy_invalid
temp_dir_unusable and cwd_unavailable
Why
Giving each startup failure a distinct machine-readable reason lets host applications show the right message or take the right corrective action automatically, rather than treating every startup refusal the same way.
