Claude Code フック

どんなものか

フックは、Claude Code のライフサイクルの決まった場面で動くユーザー定義のコマンドです。モデルの判断に任せず「必ず実行される」ので、プロジェクトのルールを確実に守らせたいときに使います。判断が必要な場合は、Claude のモデルに評価させるプロンプト型・エージェント型のフックもあります。

主なイベント

イベント	タイミング
SessionStart	セッションの開始・再開時
UserPromptSubmit	プロンプトを送った直後、処理の前
PreToolUse	ツール実行の前（止めることもできる）
PostToolUse	ツール実行が成功した後
Notification	Claude Code が通知を出すとき

ほかにもイベントがあり、全体はフックのリファレンスにまとまっています。

設定する

~/.claude/settings.json（全体）か、プロジェクトの .claude/settings.json に hooks を書きます。

例：ファイルを編集・作成した後に Prettier で整形する

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

確認する

Claude Code で /hooks を実行すると、登録されたフックの一覧が開きます。Claude に「〜するフックを書いて」と頼んで作ってもらうこともできます。