環境変数

CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS

ターン途中で終了したセッションが再開時に自動継続するための、最後のトランスクリプトメッセージの最大経過時間(ミリ秒)。最後のメッセージがこの上限より古い場合、Claude Code は CLAUDE_CODE_RESUME_INTERRUPTED_TURN による自動再開とその CLAUDE_CODE_RESUME_PROMPT の継続メッセージをスキップし、セッションはアイドル状態で開始されるため明示的に継続する必要がある。未設定または 0 の場合は上限なし。ただし、API エラーで終了したターンなど、一部のターンは最後のメッセージから 6 時間以内でのみ再開される。正の値を設定すると、それらを含むすべてのターンに上限が適用される。負の値や数値でない値の場合は 1 時間の上限が適用される。長時間実行するエージェントの起動スクリプトでこの値を設定すると、古いトランスクリプトに対する再起動時に古いプロンプトが再実行されるのを防げる。Claude Code は、対話セッションから会話を引き継いだクラッシュしたエージェントビューセッションを再起動する際に、自ら 1 時間の上限を設定する。Claude Code v2.1.211 以降が必要

使い方・用途

  • 中断されたターンが古い場合に再開時に自動再開させないようにして、古いトランスクリプトに対して古いプロンプトが再実行されるのを防ぎたい場合に使う。長時間実行するエージェントの起動スクリプトで、再起動時に古いトランスクリプトに対して古いプロンプトが再実行されるのを避けたい場合に使う。
英語原文(公式ドキュメントより)

Maximum age in milliseconds of the last transcript message for a session that ended mid-turn to continue automatically on resume. When the last message is older than this bound, Claude Code skips the CLAUDE_CODE_RESUME_INTERRUPTED_TURN automatic resume and its CLAUDE_CODE_RESUME_PROMPT continuation message, and the session starts idle so you continue explicitly. Unset or 0 sets no bound, except that some turns resume only within six hours of their last message, such as one that ended with an API error. A positive value bounds every turn, including those; a negative or non-numeric value applies a one-hour bound. Spawn scripts for long-running agents can set this so a restart against an old transcript doesn't re-run a stale prompt. Claude Code sets a one-hour bound itself when it restarts a crashed agent view session that inherited its conversation from an interactive session. Requires Claude Code v2.1.211 or later

関連する変更履歴

v2.1.269(1件)

Fixed
CLAUDE_CODE_RESUME_INTERRUPTED_TURN が、6 時間より前に API エラーで失敗したターンや、CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS が設定されている場合にはその期間より古いターンを再実行する問題を修正した
英語原文を表示
Fixed CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-running a turn that had failed with an API error over 6 hours earlier, or longer ago than CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS when set