Claude Code Hooks完全ガイド｜Command・HTTP・Prompt・Agentフックの設定と実践活用

{
  "hooks": {
    "イベント名": [
      {
        "matcher": "対象ツール名のパターン（省略可）",
        "hooks": [
          {
            "type": "command | http | prompt | agent",
            "... hookタイプ固有の設定 ..."
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && npx eslint --fix $(echo $CLAUDE_TOOL_OUTPUT | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('filePath',''))" 2>/dev/null) 2>&1 | tail -10 || true"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 - <<'EOF'
import sys, json, re, os
data = json.loads(sys.stdin.read())
cmd = data.get('command', '')
dangerous_patterns = [
    r'rm\s+-rf\s+/',
    r'DROP\s+TABLE',
    r'DELETE\s+FROM\s+\w+\s*;',
    r'format\s+[A-Z]:',
    r'dd\s+if=.*of=/dev/'
]
for pat in dangerous_patterns:
    if re.search(pat, cmd, re.IGNORECASE):
        print(f'BLOCKED: 危険なコマンドパターンが検出されました: {cmd[:80]}')
        sys.exit(1)
sys.exit(0)
EOF"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo "$(date '+%Y-%m-%d %H:%M:%S') [$CLAUDE_TOOL_NAME] project=$CLAUDE_PROJECT_DIR" >> ~/.claude/audit.log"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",
            "method": "POST",
            "headers": {
              "Content-Type": "application/json"
            },
            "body": {
              "text": "✅ Claude Codeの作業が完了しました",
              "attachments": [
                {
                  "color": "good",
                  "fields": [
                    {
                      "title": "プロジェクト",
                      "value": "$CLAUDE_PROJECT_DIR",
                      "short": true
                    },
                    {
                      "title": "完了時刻",
                      "value": "$CLAUDE_TIMESTAMP",
                      "short": true
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "http",
            "url": "https://your-audit-api.example.com/v1/logs",
            "method": "POST",
            "headers": {
              "Content-Type": "application/json",
              "Authorization": "Bearer YOUR_API_TOKEN"
            },
            "body": {
              "event": "bash_command",
              "command": "$CLAUDE_TOOL_INPUT",
              "project": "$CLAUDE_PROJECT_DIR",
              "timestamp": "$CLAUDE_TIMESTAMP",
              "source": "claude-code"
            }
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "http",
            "url": "https://api.pushover.net/1/messages.json",
            "method": "POST",
            "headers": {
              "Content-Type": "application/json"
            },
            "body": {
              "token": "YOUR_PUSHOVER_APP_TOKEN",
              "user": "YOUR_PUSHOVER_USER_KEY",
              "title": "Claude Code: 承認が必要です",
              "message": "$CLAUDE_NOTIFICATION_MESSAGE",
              "priority": 1
            }
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "以下のコード変更を確認してください。次の脆弱性が含まれていれば'BLOCK: 理由'と返してください。含まれていなければ'OK'とだけ返してください。

チェック項目:
- SQLインジェクション（文字列結合でクエリ生成）
- XSS（ユーザー入力の無害化なし）
- ハードコードされたAPIキー・パスワード・シークレット
- コマンドインジェクション（ユーザー入力のshell実行）

変更内容:
$CLAUDE_TOOL_INPUT",
            "blockOnResponse": "BLOCK"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "以下のgitコマンドを確認してください。mainまたはproductionブランチへの直接pushやforce pushが含まれていれば'BLOCK: 本番ブランチへの直接操作は禁止されています'と返してください。問題なければ'OK'とだけ返してください。

コマンド: $CLAUDE_TOOL_INPUT",
            "blockOnResponse": "BLOCK"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "新しく作成されたコードの品質を評価してください。以下の観点で1〜5点のスコアと1行コメントを返してください。
1. 命名規則の一貫性
2. 関数の単一責任原則
3. エラーハンドリングの適切さ

形式: スコア: X/5 | コメント: ○○

コード:
$CLAUDE_TOOL_INPUT"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "agent",
            "prompt": "新しく作成されたファイル $CLAUDE_TOOL_OUTPUT について、既存の類似ファイルがないか確認してください。

手順:
1. Glob でプロジェクト内の同種ファイル（同じ拡張子）を列挙する
2. Grep でファイル名・関数名・クラス名の重複を検索する
3. 重複が見つかった場合は警告を出す
4. 重複がない場合は「問題なし」と返す",
            "tools": ["Read", "Glob", "Grep"]
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit",
        "hooks": [
          {
            "type": "agent",
            "prompt": "編集されたファイルに関連するテストファイルを見つけて内容を確認し、テストカバレッジの抜けを報告してください。

手順:
1. Glob で *.test.ts, *.spec.ts などのテストファイルを検索
2. 編集ファイルと同名のテストファイルを優先的に確認
3. 新しく追加された関数・メソッドのテストケースが存在するか確認
4. テストが不足している場合は具体的に何をテストすべきか提案する",
            "tools": ["Read", "Glob", "Grep"]
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "agent",
            "prompt": "package.jsonが更新された場合、追加されたパッケージを確認し、以下をチェックしてください。

1. Read で package.json の変更内容を確認
2. 新しく追加されたパッケージ名を特定
3. Grep でリポジトリ内でそのパッケージが正しく使われているか確認
4. 不審な点（予期しないパッケージ追加・バージョン急変など）があれば警告

対象ファイル: $CLAUDE_TOOL_OUTPUT",
            "tools": ["Read", "Glob", "Grep"]
          }
        ]
      }
    ]
  }
}

# Command Hook 内で JSON を解析する
python3 - << 'EOF'
import sys, json
data = json.loads(open('/dev/stdin').read() if not sys.stdin.isatty() else '{}')
# または環境変数から
import os
tool_input = os.environ.get('CLAUDE_TOOL_INPUT', '{}')
try:
    parsed = json.loads(tool_input)
    command = parsed.get('command', '')
    file_path = parsed.get('file_path', '')
    print(f"Command: {command}, File: {file_path}")
except json.JSONDecodeError:
    print(f"Raw input: {tool_input}")
EOF

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "以下のコード変更にSQLインジェクション・XSS・ハードコードされたシークレットが含まれていれば'BLOCK: 理由'と返してください。問題なければ'OK'とだけ返してください。
変更: $CLAUDE_TOOL_INPUT",
            "blockOnResponse": "BLOCK"
          }
        ]
      },
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "http",
            "url": "https://your-audit-api.example.com/log",
            "method": "POST",
            "headers": { "Content-Type": "application/json" },
            "body": {
              "command": "$CLAUDE_TOOL_INPUT",
              "project": "$CLAUDE_PROJECT_DIR",
              "timestamp": "$CLAUDE_TIMESTAMP"
            }
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && npx prettier --write . 2>&1 | tail -3 || true"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",
            "method": "POST",
            "headers": { "Content-Type": "application/json" },
            "body": {
              "text": "✅ Claude Code作業完了: $CLAUDE_PROJECT_DIR"
            }
          }
        ]
      }
    ]
  }
}