環境変数

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

SessionEnd

関連する変更履歴

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

変更前

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

変更後

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

ユーザーへの恩恵

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

関連ドキュメント