環境変数

CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS

SessionEnd フックの時間予算をミリ秒単位で上書きする。この値は、自身でタイムアウトを設定していない各フックのタイムアウトにもなる。セッション終了、/clear、対話的な /resume によるセッション切り替えに適用される。既定では予算は 1.5 秒で、設定ファイルに構成された最も高いフック単位のタイムアウト(最大 60 秒)に自動的に引き上げられる。プラグイン提供のフックのタイムアウトは予算を引き上げない。

使い方・用途

  • SessionEnd フックが終了処理の途中で 1.5 秒の既定タイムアウトで強制終了される問題を解決したい場合。
  • セッション終了・/clear・/resume でのセッション切り替え時の SessionEnd フック全体の時間予算を明示的に指定したい場合。
  • settings ファイルに per-hook の timeout を設定せず、環境変数一括でフックごとのタイムアウトも兼ねさせたい場合。
英語原文(公式ドキュメントより)

Override the time budget in milliseconds for SessionEnd hooks. The value is also the timeout for each hook that sets no timeout of its own. 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
フックごとの timeout が設定されていない SessionEnd フックに対し、CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS が適用されない問題を修正した (従来は 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)

関連ドキュメント

v2.1.74(1件)

Fixed
終了時の 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

変更後

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

関連ドキュメント