Claude Codeのフック（Hooks）でワークフローを自動化する

AIがツール（ファイル書き込み、コマンド実行など）を使用する前に実行されます。フックが非ゼロで終了すると、ツールの実行がブロックされます。

用途：
- 危険なコマンドの実行を防止
- ファイル書き込み前のバリデーション
- 特定のディレクトリへの書き込みをブロック

AIがツールを使用した後に実行されます。ツール実行の結果に対してアクションを実行できます。

用途：
- ファイル書き込み後の自動lint/format
- コマンド実行後の結果検証
- コード変更後の自動テスト実行

Claude Codeがユーザーの入力待ちになったときに実行されます。長い処理が完了したことを通知するのに便利です。

用途：
- デスクトップ通知の送信
- Slack/Discord通知
- サウンド再生

Claude Codeのエージェントターンが終了したときに実行されます。

用途：
- 作業完了のログ記録
- 自動的なクリーンアップ処理

サブエージェントが完了したときに実行されるフックです。サブエージェントの結果に基づいた後処理を自動化できます。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'ツール実行前のチェック'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'ファイル書き込み後の処理'"
          }
        ]
      }
    ]
  }
}

設定（PHP + JavaScript プロジェクト）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); if [[ \"$FILE\" == *.php ]]; then php -l \"$FILE\" 2>&1; elif [[ \"$FILE\" == *.js ]]; then npx eslint --fix \"$FILE\" 2>&1; fi"
          }
        ]
      }
    ]
  }
}

動作の流れ

1. Claude CodeがPHPファイルを書き込み/編集
2. フックが発火し、php -lで構文チェック
3. JavaScriptファイルの場合はeslint --fixで自動修正
4. エラーがあればClaude Codeに結果が返される

設定

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); if [[ \"$FILE\" == */src/* ]]; then TEST_FILE=$(echo \"$FILE\" | sed 's|/src/|/tests/|' | sed 's|\\.php|Test.php|'); if [ -f \"$TEST_FILE\" ]; then php vendor/bin/phpunit \"$TEST_FILE\" --no-coverage 2>&1 | tail -5; fi; fi"
          }
        ]
      }
    ]
  }
}

動作説明

• src/配下のファイルが変更されたとき、対応するテストファイルを探す
• テストファイルが存在すれば自動的にPHPUnitを実行
• 結果の最後の5行をClaude Codeに返す（コンテキスト節約のため）

設定（macOS）

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

設定（Windows - PowerShell）

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Codeが入力を待っています')\""
          }
        ]
      }
    ]
  }
}

設定（Linux）

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Claude Codeが入力を待っています'"
          }
        ]
      }
    ]
  }
}

設定

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "BLOCKED_PATTERNS='rm -rf /|DROP TABLE|DROP DATABASE|git push.*--force|git reset --hard|:(){ :|:& };:'; CMD=$(cat /dev/stdin | jq -r '.tool_input.command'); echo \"$BLOCKED_PATTERNS\" | tr '|' '\\n' | while read pattern; do if echo \"$CMD\" | grep -qiE \"$pattern\"; then echo \"BLOCKED: 危険なコマンドが検出されました: $pattern\"; exit 1; fi; done"
          }
        ]
      }
    ]
  }
}

ブロックされるコマンドの例

設定: セキュリティチェック

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); if [[ \"$FILE\" == *.php ]]; then ISSUES=''; if grep -n 'mysql_query\\|mysqli_query.*\\$_' \"$FILE\" 2>/dev/null; then ISSUES=\"${ISSUES}SQLインジェクションの可能性あり\\n\"; fi; if grep -n 'echo.*\\$_GET\\|echo.*\\$_POST\\|echo.*\\$_REQUEST' \"$FILE\" 2>/dev/null; then ISSUES=\"${ISSUES}XSSの可能性あり\\n\"; fi; if [ -n \"$ISSUES\" ]; then echo \"セキュリティ警告:\"; echo -e \"$ISSUES\"; fi; fi"
          }
        ]
      }
    ]
  }
}

検出されるパターン

• プリペアドステートメントを使っていないSQLクエリ
• エスケープなしのユーザー入力の出力（XSS）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); echo 'Step 1: 構文チェック' && php -l \"$FILE\""
          },
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); echo 'Step 2: コーディング規約チェック' && phpcs --standard=PSR12 \"$FILE\""
          },
          {
            "type": "command",
            "command": "FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path'); echo 'Step 3: 静的解析' && phpstan analyse \"$FILE\" --level=5"
          }
        ]
      }
    ]
  }
}

stdin JSONの構造

{
  "tool_name": "Write",
  "tool_input": {
    "file_path": "/path/to/file.php",
    "content": "..."
  },
  "project_dir": "/path/to/project"
}

stdinからの値取得例（jq使用）

# ファイルパスの取得
FILE=$(cat /dev/stdin | jq -r '.tool_input.file_path')

# Bashコマンドの取得
CMD=$(cat /dev/stdin | jq -r '.tool_input.command')