Claude Code、事前チェックの呼び出し準備に失敗した操作を止めるように

チェックの結果が出る前に起きる失敗を止める

Claude Codeには、操作の前後で自作の処理を呼ぶフックがあります。たとえばコマンド実行の前にチームのチェックを置き、その判断を実行許可へ反映する使い方です。

今回の対象は、そのチェックが「許可する」「止める」と判断する前の段階です。どのフックを呼ぶかの照合が失敗したり、ツールの入力を渡せる形式へ変換できなかったりすると、以前はフックが飛ばされることがありました。v2.1.288では、その場合に元のツール呼び出しを止めます。

対象の二つのタイミングは、次のように異なります。

チェックするタイミング	公式のイベント名
ツールによる操作を実行する直前	PreToolUse
操作の許可判断が必要になったとき	PermissionRequest

これは公式Releaseと現在のフック仕様に基づく説明です。特定のチェックを置けばすべての操作を制御できる、という保証ではありません。

フックが動いた後のエラーまで同じ扱いにはならない

フックを呼び出す準備の失敗と、起動したフック自身が失敗することは別です。

現行仕様の「Block the action when a hook fails」は、処理を起動できない、時間切れになる、不正な出力を返すといった失敗について、通常は元の操作が進む場合があると説明しています。それらで操作を止めるonFailure: "block"は、対応するcommand／HTTPフックで使う別の設定で、v2.1.295以降が必要です。v2.1.288で追加された設定ではありません。

このため、「v2.1.288へ更新したので、フックのエラーは全部停止になる」とは読めません。今回塞がれたのは、公式Releaseが明記する照合と入力変換の失敗経路です。チェックのスクリプトや接続先自体が失敗した場合は、イベントと設定に応じた扱いが残ります。

出典と確認範囲

• Claude Code v2.1.288：フック照合・ツール入力の変換に失敗した際の修正。
• Hooks reference：フックの役割、実行前・許可判断時のイベント、現在の失敗時の扱い。

公式資料は2026年10月23日（日本時間）に確認しました。補助CHANGELOGは本文を取得できておらず、根拠には使っていません。実際にフックの失敗を起こす再現試験はしていません。

更新時期の案内は、対象のフックによる制御に依存する環境への本記事の判断です。公式Releaseは全利用者向けの更新期限や、影響が始まった版を示していません。

制作: AI支援