Claude Code Hooksとは？使い方・設定・自動化の仕組みを完全解説【2026年最新】

Claude Code Hooksとは？自動化の仕組みと使い方を完全解説【2026年最新】

---

Claude Code Hooksとは？基本概念と仕組み

1. Claude Codeの特定のイベントが発火する（例: ファイルを編集した後）
2. 設定したマッチャーが一致するかチェックする
3. 一致した場合、フックハンドラーが実行される
4. ハンドラーはJSON入力をstdinで受け取り、結果をstdoutで返す

フックが定義できる場所（スコープ）

---

フックイベントの種類と一覧

よく使うイベントTOP3

---

Claude Code Hooksの設定方法と使い方

{
  "hooks": {
    "イベント名": [
      {
        "matcher": "フィルタ条件（正規表現）",
        "hooks": [
          {
            "type": "command",
            "command": "実行するシェルコマンド"
          }
        ]
      }
    ]
  }
}

/hooksメニューでフックを確認する

---

最初のフックを設定する：デスクトップ通知

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Codeがあなたの入力を待っています\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

claude code hooks 通知をSlackに飛ばす

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -X POST -H 'Content-type: application/json' --data '{\"text\":\"Claude Codeが作業を完了しました\"}' $SLACK_WEBHOOK_URL"
          }
        ]
      }
    ]
  }
}

macOS afplayで音を鳴らす

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff"
          }
        ]
      }
    ]
  }
}

---

コードの品質を自動保証する：lint・フォーマット連携

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

ESLint・Biome・Ruffとの連携

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

jq -r '.tool_input.file_path' | xargs npx prettier --write --ignore-unknown

---

危険なコマンドをブロックする：PreToolUseの活用

#!/bin/bash
# .claude/hooks/protect-files.sh

INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED_PATTERNS[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2
    exit 2
  fi
done

exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

---

カスタムフック（Custom Hooks）の作り方

• 「〇〇したら△△する」→ PostToolUse（後処理）
• 「〇〇をブロックしたい」→ PreToolUse（前処理）
• 「入力待ちのときに通知したい」→ Notification
• 「作業が全部終わったら通知したい」→ Stop
• 「セッション開始時に何かしたい」→ SessionStart
• 「ファイルの変更を監視したい」→ FileChanged

{
  "session_id": "abc123",
  "tool_name": "Edit",
  "tool_input": {
    "file_path": "/path/to/file.ts",
    "old_string": "...",
    "new_string": "..."
  },
  "tool_response": {
    "success": true
  }
}

#!/usr/bin/env python3
import json, sys, subprocess

data = json.load(sys.stdin)
file_path = data.get('tool_input', {}).get('file_path', '')

if file_path.endswith('.py'):
    subprocess.run(['ruff', 'check', '--fix', file_path])
elif file_path.endswith(('.ts', '.tsx', '.js', '.jsx')):
    subprocess.run(['npx', 'eslint', '--fix', file_path])
elif file_path.endswith('.go'):
    subprocess.run(['gofmt', '-w', file_path])

---

マルチエージェント環境でのHooks活用

{
  "hooks": {
    "SubagentStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "jq -c '{event: \"subagent_start\", timestamp: now | todate, type: .agent_type}' >> ~/claude-agent.log"
          }
        ]
      }
    ],
    "SubagentStop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "jq -c '{event: \"subagent_stop\", timestamp: now | todate, type: .agent_type}' >> ~/claude-agent.log"
          }
        ]
      }
    ]
  }
}

---

非同期フックと高度な設定

{
  "hooks": {
    "FileChanged": [
      {
        "matcher": ".ts|.tsx",
        "hooks": [
          {
            "type": "command",
            "background": true,
            "command": "npm test"
          }
        ]
      }
    ]
  }
}

• JSONの構文エラー（カンマの過不足、括弧の閉じ忘れ等）
• スクリプトファイルに実行権限がない（chmod +x忘れ）
• jqがインストールされていない（brew install jqが必要）
• $CLAUDE_PROJECT_DIRが解決できていない環境で実行している

---

スキル・プラグインとの組み合わせ

---

よくあるユースケース：Best Practices集

Windows環境でのHooks

---

プロンプトベースフックとエージェントベースフック

---

Claude Code HooksのFAQ

---

まとめ：Hooksでどう使い方が変わるか

1. ~/.claude/settings.jsonにNotificationフックを追加して通知を設定する
2. プロジェクトの.claude/settings.jsonにPostToolUseフックでlintを自動化する
3. PreToolUseで保護したいファイルや危険なコマンドをブロックする
4. Stopイベントを使って作業完了をSlackに通知する
5. サブエージェントを使う場合はSubagentStart/Stopでログを取る

---

出典

• Claude Code Hooksガイド（公式）
• Claude Code Hooksリファレンス（公式）