Hooks：あなただけのワークフローを構築

Claude Code Hooks とは？

Hooks は Claude Code のイベントシステムで、ツール呼び出しの前後にカスタムシェルスクリプトを実行できます。ファイル保存後の自動リンター実行、コミット前のテスト実行、機密ファイルアクセス時のアラートなど、すべて自動化できます。

設定は三層です。イベントを選び、matcher でツールを絞り、処理スクリプトは内側の hooks 配列に書きます。スクリプトは標準入力からこのイベントの JSON を読み、終了コードで意思を伝えます。0 は異議なし、2 はブロックできるイベントでその呼び出しを止めます。以下の四つのイベントでは、command フックは既定で 600 秒で取消しです。この四つは頻出であって、公式リファレンスの全項目ではありません（2026-09-22 確認）。

自動化のよくある三つの例

以下の三つは同じ構造です。イベントを選び、matcher で対象を絞り、スクリプトは内側の hooks 配列に置きます。断片は意図の示意だけで、フィールド名と入れ子は公式リファレンスに従ってください。判断に必要な情報は標準入力の JSON から取り出します。

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'git commit'; then npm run format; fi"
    }]
  }
}

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'pytest\\|npm test'; then notify-send 'Tests completed'; fi"
    }]
  }
}

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "command": "if echo \"$TOOL_INPUT\" | grep -qE '\\.env|credentials|secrets'; then exit 2; fi"
    }]
  }
}

settings.json 設定例

.claude/settings.json で Hooks を定義

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/pre-bash-hook.sh"
      },
      {
        "matcher": "Edit|Write",
        "command": "~/scripts/protect-sensitive-files.sh"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/post-bash-hook.sh"
      }
    ],
    "Notification": [
      {
        "command": "~/scripts/send-notification.sh"
      }
    ],
    "Stop": [
      {
        "command": "~/scripts/on-stop.sh"
      }
    ]
  }
}

よくある質問