環境変数

CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS

SessionEnd フックの実行に割り当てられるタイムアウト時間をミリ秒単位で上書きします。

使い方・用途

  • セッション終了時や /clear 実行時のクリーンアップ処理、ログ保存などの後処理が強制終了されるのを防ぐために使用します。
  • デフォルトの1.5秒では完了しない重いスクリプトを実行する必要がある場合に、待機時間を延長できます。
  • 自動的に最大60秒まで調整されますが、プラグイン提供のフックはこの自動延長の対象外であるため、明示的な指定が必要な場合に有効です。
英語原文(公式ドキュメントより)

Override the time budget in milliseconds for SessionEnd hooks. Applies to session exit, /clear, and switching sessions via interactive /resume. By default the budget is 1.5 seconds, automatically raised to the highest per-hook timeout configured in settings files, up to 60 seconds. Timeouts on plugin-provided hooks do not raise the budget

関連ドキュメント

関連する変更履歴

v2.1.268(1件)

Fixed
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS を設定しても、フックごとの timeout が未設定の SessionEnd フックが延長されず、1.5 秒後にキャンセルされる問題を修正した。
英語原文を表示
Fixed CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS not extending SessionEnd hooks that have no per-hook timeout (they were still cancelled after 1.5 seconds)

変更前

env var no effect on per-hook unset - per-hook timeout が設定されていない SessionEnd フックは、CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS を設定しても効果がなく、1.5 秒後にキャンセルされていた。

変更後

env var and per-hook timeout - CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS が per-hook timeout 未設定の SessionEnd フックのタイムアウト予算を延長するようになった。

ユーザーへの恩恵

環境変数で SessionEnd フック全体のタイムアウト予算を制御できるようになり、per-hook timeout を個別に設定せずに長時間処理を完走させられる。

関連ドキュメント

v2.1.74(1件)

Fixed
Hooks
終了時の SessionEnd フックが hook.timeout 設定にかかわらず1.5秒で強制終了される問題を修正 — CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS で設定可能に
英語原文を表示
Fixed SessionEnd hooks being killed after 1.5 s on exit regardless of hook.timeout — now configurable via CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS

変更前

セッション終了時に実行したいクリーンアップ処理やログ保存などのフック処理が、設定したタイムアウト時間に達する前に強制的に打ち切られていました。

変更後

環境変数で終了時の待機時間をカスタマイズできるようになり、時間のかかる終了後処理も確実に完了させることができます。

ユーザーへの恩恵

大切な後処理や自動化スクリプトが途中で途切れる心配がなくなり、開発ワークフローの自動化がより堅牢になります。

関連ドキュメント