読み込み中
読み込み中

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が反映されているかを確認できます。

hooksの設定が書かれた.claudeディレクトリ内のsettings.jsonファイル

実践例

最もよく使われるhookは、編集後の自動フォーマットです。マッチャーを"Edit|Write"に設定したPostToolUseフックを用意すると、ClaudeがEditツールまたはWriteツールを使用した後に実行されます。コマンドはプロジェクトで使用しているフォーマッタを実行します。Prettierの場合は、これを.claude/settings.jsonに追加します(jqが必要です)。

json
{
  "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ブランチへのコミットをブロックする。チームとして保証が必要なことであり、単なる提案では済まないことに使います。

マッチャーとコマンドを伴うPreToolUseおよびPostToolUseフックを示すsettings.jsonファイル

チームとHooksを共有する

.claude/settings.jsonで設定されたhooksはプロジェクトレベルのもので、リポジトリにチェックインできます。つまり、チーム全員が自動的に同じhooksを利用できるということです。コマンド内ではCLAUDE_PROJECT_DIR環境変数を使って、プロジェクト内に保存されたスクリプトを参照してください。そうすれば、Claudeの現在の作業ディレクトリがどこであっても正しく動作します。

まとめ

Hooksは、Claude Codeの動作を決定的に制御する手段を提供します。自動フォーマットやログ記録にはPostToolUseを使い、危険な操作のブロックにはPreToolUseを使います。settings.jsonで設定し、/hooksで確認します。そしてリポジトリにチェックインして、チームにも行き渡るようにしましょう。

何があっても必ず実行させたいことがあるなら、プロンプトに書くのではなく、hookに組み込みましょう。