hookのパス誤記で停止せず

筆者は以前の記事で、Claude Codeのフックを使ってツールが.envや鍵ファイルを削除するのを防ぐ取り組みを紹介した。その設定には盲点があった。公式のhooksリファレンスには、settings.jsonのパスを打ち間違えるとフックがまったく実行されず、壊れたガードフックはすべてを通してしまうと記されている。テストでは、Claude CodeがコマンドをJSONでガードスクリプトに渡し、スクリプトはブロックなら終了コード2、許可なら0を返し、それ以外は非ブロックの失敗とみなされた。登録パスの1文字の誤記により終了ステータス127（ファイル未検出）となり、rmコマンドがそのまま実行された。

修正は"onFailure": "block"という1つの設定だけで、ガードはフェイルオープンからフェイルクローズに切り替わる。トレードオフは意図的なもので、クラッシュやタイムアウトを含むあらゆるフックの失敗が、settings.jsonでパスを修正してClaude Codeを開き直すまですべてのBash利用をブロックする。そのため筆者は、失うより止めたいものを守るガードフックにのみ適用することを勧めている。

付属の約30行のチェッカーは、登録されたコマンドを走査し、$CLAUDE_PROJECT_DIRと~を展開して、存在しないフックファイルを終了コード1で一覧表示する。ガードに頼る前にパスの誤記を見つける手軽な方法だが、確認するのは存在だけであり、スクリプトのブロック条件が正しいかどうかは検証しない。