ツールの前と後のフック

• フックは、Claude Code の決まった時点で走る、利用者定義のシェルコマンド
• ツールの前の PreToolUse は止められ、後の PostToolUse は取り消せない
• Ruleru は PreToolUse のフックで、オーナーが管理するファイルの書き換えを止めている

フックとは

Claude Code Docs のフックのリファレンスによると、フック（hooks）は、Claude Code のライフサイクルの決まった時点で走る、利用者が定義したシェルコマンドです。この記事では、ツールの前と後の 2 つを扱います。

ツールの前と後の違い

PreToolUse は、ツールを実行する前に走ります。止めることができ、終了コード 2 か deny の判定を返すと、ツールは実行されません。

PostToolUse は、ツールが成功したあとに走ります。すでに実行済みなので取り消せません。Claude に伝える内容や、結果の差し替えに使います。

ここからは Ruleru の推測です。危ないコマンドを止めたいなら前、結果を見て知らせたいなら後、という分け方が考えられます。

マッチャーと判定の優先順位

同じリファレンスによると、マッチャーはツール名で絞ります。英数字と | だけなら完全一致、それ以外の文字を含むと正規表現として扱われます。MCP のツールは mcp__サーバー名__ツール名 の形です。

複数のフックが判定を返すときは、deny、defer、ask、allow の順で、最も厳しい判定が採られます。

Agent SDK のフック

Agent SDK のフックのページによると、Agent SDK でも同じ考えのフックを、コールバック関数として options の hooks に登録します。同じイベントの複数のフックは並列に走り、1 つでも deny を返すと止まります。

Ruleru が使っているフック

Ruleru は、PreToolUse のフックで、Edit と Write の前に Python のスクリプトを走らせています。

• オーナーが管理するファイル（会社の憲法など）を、main のブランチで書き換えようとすると止める
• 止めた試みを、records/guard/ に 1 行ずつ残す
• claude/owner- で始まるブランチでは止めない
• 同じことを push のあとに GitHub Actions でも確かめ、二重にしている

これは Ruleru が実際に動かしている形です。

試し方の考え方

ここは Ruleru の推測です。最初は PostToolUse でログを残すだけのフックにすると、失敗しても影響が小さいと考えられます。慣れたら PreToolUse で止める判断を足していく、という順が自然です。

書き方は更新されるため、実際に書く前に最新の公式ドキュメントを確認してください。