フック（Hooks）

フックは、Claude Code のライフサイクルの特定のタイミングで自動的にシェルコマンドを実行する仕組みです。「ファイルを編集したら自動フォーマット」「権限確認が出たらデスクトップ通知」「セッション開始時にコンテキストを自動挿入」など、決定的（deterministic）な自動化を実現できます。Claude の判断に依存せず、必ず実行される点が AI への指示との違いです。

フックの動作フロー

フックの設定方法

settings.json の hooks セクションにイベントごとの設定を記述します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write modified-file.ts"
          }
        ]
      }
    ]
  }
}

フックタイプ

フックには4つのタイプがあります。ほとんどの場合は command タイプで十分です。

利用可能なイベント一覧

Claude Code のライフサイクル全体にわたって、さまざまなタイミングでフックを設定できます。

終了コードの意味

フックのコマンドが返す終了コードによって、その後の動作が変わります。