{"name":"CLAUDE_CODE_RESUME_REASON","slug":"claude-code-resume-reason","family":"env","title":"Environment variables","noun":"environment variable","description":"New CLAUDE_CODE_RESUME_REASON env var labels why an interrupted turn was resumed","description_source":"entry","described_by":{"version":"2.1.268","anchor":"new-claude-code-resume-reason-env-var-for-interrupted-turns"},"presence":{"first_seen":"2.1.268","removed_in":null,"in_current_build":true,"newest_mined":"2.1.322","builds":50,"mined_builds":161,"first_cited":{"version":"2.1.268","released_at":"2026-09-10 18:41:11","spans":1}},"aliases":[],"entries":[{"version":"2.1.268","anchor":"new-claude-code-resume-reason-env-var-for-interrupted-turns","heading":"New CLAUDE_CODE_RESUME_REASON env var for interrupted turns","line":"New CLAUDE_CODE_RESUME_REASON env var labels why an interrupted turn was resumed","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.268","anchor":"new-resume-reason-field-on-streaming-assistant-message-frame","heading":"New resume_reason field on streaming assistant-message frames","line":"Streaming assistant messages can now carry a resume_reason explaining an automatic re-run after an interruption","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.268","anchor":"sdk-turn-result-schema-gains-resume-reason-and-result-index","heading":"SDK turn result schema gains resume_reason and result_index fields","line":"SDK turn results can now report a resume_reason and a result_index","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text"}],"entries_total":3,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"CLAUDE_CODE_RESUME_CACHE_WARM","slug":"claude-code-resume-cache-warm","description":"Claude Code recognises `CLAUDE_CODE_RESUME_CACHE_WARM` and lets a cache-warming request run when you resume a session"},{"name":"CLAUDE_CODE_RESUME_FROM_SESSION","slug":"claude-code-resume-from-session","description":"Child worker processes no longer inherit your session id, resume prompt or auth handles."},{"name":"CLAUDE_CODE_RESUME_INTERRUPTED_TURN","slug":"claude-code-resume-interrupted-turn","description":"Resuming a turn interrupted by shutdown now correctly sees the tool call as still pending instead of faked-answered."},{"name":"CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS","slug":"claude-code-resume-interrupted-turn-max-age-ms","description":"The staleness cutoff for auto-resuming an interrupted turn is now configurable, defaulting to 6 hours"},{"name":"CLAUDE_CODE_RESUME_PROMPT","slug":"claude-code-resume-prompt","description":"Child worker processes no longer inherit your session id, resume prompt or auth handles."},{"name":"CLAUDE_CODE_RESUME_SESSIONSTART_HOOKS_WAIT_MS","slug":"claude-code-resume-sessionstart-hooks-wait-ms","description":"Claude Code now reads three new environment variables: agent progress summaries, a sleep-compaction delay and a resume hook wait"},{"name":"CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLS","slug":"claude-code-resume-shows-cut-off-calls","description":"A new CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLS setting lets a resumed session show tool calls that were interrupted mid-turn"},{"name":"CLAUDE_CODE_RESUME_SOURCE_ALIVE","slug":"claude-code-resume-source-alive","description":"The screen-reader setting CLAUDE_AX_SCREEN_READER now joins the environment variables Claude Code passes along"},{"name":"CLAUDE_CODE_RESUME_THRESHOLD_MINUTES","slug":"claude-code-resume-threshold-minutes","description":"Minimum age in minutes of the last user or assistant message older than one minute before Claude Code offers the resume-return prompt with the choices `compact`, `continue`, `dismiss` and `never`. Default `70` when unset or not a number; `0` is taken literally and removes the age requirement. The prompt also needs `tengu_gleaming_fair` or `tengu_gleaming_fair_reuse` on, the user not having picked `never`, and the conversation at or above `CLAUDE_CODE_RESUME_TOKEN_THRESHOLD`."},{"name":"CLAUDE_CODE_RESUME_TOKEN_THRESHOLD","slug":"claude-code-resume-token-threshold","description":"Minimum estimated token count of the conversation before Claude Code offers the resume-return prompt with the choices `compact`, `continue`, `dismiss` and `never`. Default `100000` when unset or not a number; `0` is taken literally and removes the token requirement. The prompt also needs `tengu_gleaming_fair` or `tengu_gleaming_fair_reuse` on and the last message older than `CLAUDE_CODE_RESUME_THRESHOLD_MINUTES`."}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/claude-code-resume-reason","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}