環境変数

CLAUDE_CODE_STOP_HOOK_BLOCK_CAP

Stop または SubagentStop フックがターンの終了をブロックできる連続回数の上限。Claude Code がこれを上書きしてターンを強制的に終了させるまでの回数である(既定: 8)。0 を設定すると上限を無効にする。フックが解決のために正当により多くのイテレーションを必要とする場合は、この値を引き上げる。

使い方・用途

  • Stop フックが条件を満たせず何度も続行をブロックして無限ループに陥るのを防ぎたい場合に設定する
  • フックが正当な理由で 8 回を超える連続反復を必要とする場合に、上限を引き上げてフックの処理を完了させる
英語原文(公式ドキュメントより)

Maximum number of consecutive times a Stop or SubagentStop hook may block the turn from ending before Claude Code overrides it and ends the turn anyway (default: 8). Set to 0 to disable the cap. Raise this if your hook legitimately needs more iterations to resolve

関連ドキュメント

関連する変更履歴

v2.1.143(1件)

Fixed
ループを繰り返してブロックし続けるStopフックの修正：8回連続でブロックされた場合、警告を表示してターンを終了するようになりました
英語原文を表示
Fixed stop hooks that block repeatedly looping forever — the turn now ends with a warning after 8 consecutive blocks (override via CLAUDE_CODE_STOP_HOOK_BLOCK_CAP)

変更後

バグのあるフックスクリプトによる意図しない課金の発生を防ぎ、安全に自動化を運用できます。

関連ドキュメント