Hooks
Hooksを使うと、Claude Codeのライフサイクルの特定のタイミングでコマンドを実行できます。 このコースでこれまで扱ってきたものと比べた、hooksの重要な違いは、hooksが決定的であること——必ず実行されるということです。
Hooksを使う理由
CLAUDE.mdに「ファイルを編集するたびにPrettierを実行する」ように書いておくことはできます。たいていの場合はその通りに動きます。ただし、そうならないこともあります。hookを使えば、毎回例外なく必ず実行させることができます。
一般的なユースケースには次のようなものがあります。
- ファイル編集後の自動フォーマット
- コンプライアンスのため、実行されたすべてのコマンドをログに記録する
- 本番ファイルの変更など、危険な操作をブロックする
- Claudeがタスクを完了したときに自分宛てに通知を送る
仕組み
Hooksはsettings.jsonで設定します。イベントを選び、必要に応じてどのツールに適用するかを指定するマッチャーを設定し、実行するコマンドを指定します。よく使われるイベントには次のようなものがあります。
- PreToolUse — ツール呼び出しの前に実行される
- PostToolUse — ツール呼び出しの完了後に実行される
- UserPromptSubmit — プロンプトを送信したとき、Claudeが処理する前に実行される
- Stop — Claudeが応答を終えたときに実行される
- Notification — Claudeが通知を送るときに実行される
これらはフックできるイベントのほんの一部にすぎません——Claude Codeはさらに多くのイベントをサポートしています。全リストについてはhooksリファレンス(新しいタブで開きます)を参照してください。
これらはsettings.jsonを直接編集して設定します。Claude Code内の/hooksコマンドでは、設定済みのhooksの読み取り専用の一覧が開くので、新しいhookが反映されているかを確認できます。

実践例
最もよく使われるhookは、編集後の自動フォーマットです。マッチャーを"Edit|Write"に設定したPostToolUseフックを用意すると、ClaudeがEditツールまたはWriteツールを使用した後に実行されます。コマンドはプロジェクトで使用しているフォーマッタを実行します。Prettierの場合は、これを.claude/settings.jsonに追加します(jqが必要です)。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "file=$(jq -r '.tool_input.file_path') && npx prettier --write -- \"$file\""
}
]
}
]
}
}動作をテストするには、Claudeにファイルの編集を依頼し、そのファイルが再フォーマットされたことを確認してください。
PreToolUseでブロックする
PreToolUseフックは、ツール呼び出しが実行される前にブロックできます。フックはツール名と入力をJSON形式で標準入力から受け取ります。終了コードによって動作が決まります。
- 終了コード0 — 通常どおり進行する。
- 終了コード2 — 操作をブロックする。stderrのメッセージはClaudeへのフィードバックとして渡され、なぜブロックされたのかが分かり、調整できるようになります。
- それ以外の終了コード — 非ブロッキングのエラーとして扱われ、あなたには表示されますが、何かを止めることはありません。
これが、厳格なルールを強制する方法です。本番の設定ディレクトリへの書き込みをブロックする。rm -rfを含むbashコマンドをブロックする。mainブランチへのコミットをブロックする。チームとして保証が必要なことであり、単なる提案では済まないことに使います。

チームとHooksを共有する
.claude/settings.jsonで設定されたhooksはプロジェクトレベルのもので、リポジトリにチェックインできます。つまり、チーム全員が自動的に同じhooksを利用できるということです。コマンド内ではCLAUDE_PROJECT_DIR環境変数を使って、プロジェクト内に保存されたスクリプトを参照してください。そうすれば、Claudeの現在の作業ディレクトリがどこであっても正しく動作します。
まとめ
Hooksは、Claude Codeの動作を決定的に制御する手段を提供します。自動フォーマットやログ記録にはPostToolUseを使い、危険な操作のブロックにはPreToolUseを使います。settings.jsonで設定し、/hooksで確認します。そしてリポジトリにチェックインして、チームにも行き渡るようにしましょう。
何があっても必ず実行させたいことがあるなら、プロンプトに書くのではなく、hookに組み込みましょう。