Claude Code Hooks 実践レシピ集 — 全17イベント解説と本番で使える自動化パターン10選

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Bashが実行されます' >> /tmp/claude-hook.log"
          }
        ]
      }
    ]
  }
}

{ "type": "command", "command": "curl -X POST -d '{\"text\":\"ファイル変更\"}' $SLACK_WEBHOOK_URL" }

{ "type": "http", "url": "https://hooks.slack.com/services/XXX" }

{ "type": "prompt", "prompt": "この変更は重要か判定してください: $ARGUMENTS" }

{ "type": "agent", "prompt": "変更されたファイルの影響範囲を調査してください: $ARGUMENTS" }

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "^Bash$",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/guard.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

DANGEROUS_PATTERNS=(
  "rm -rf /"
  "rm -rf ~"
  "git push.*--force"
  "git reset --hard"
  "DROP TABLE"
  "DROP DATABASE"
)

for pattern in "${DANGEROUS_PATTERNS[@]}"; do
  if echo "$CMD" | grep -qiE "$pattern"; then
    echo "ブロック: '$pattern' に一致する危険なコマンドです" >&2
    exit 2
  fi
done

exit 0

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "cd \"$CLAUDE_PROJECT_DIR\" && npm test -- --bail 2>&1 | tail -20",
            "async": true,
            "timeout": 120
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
INSTRUCTIONS=$(echo "$INPUT" | jq -r '.custom_instructions // empty')
MEMORY_FILE="$CLAUDE_PROJECT_DIR/.claude/memory/auto-compact.md"

# custom_instructionsは手動 /compact 実行時のユーザー入力テキスト
# 自動コンパクト時は空文字になるため、空の場合はスキップ
if [ -z "$INSTRUCTIONS" ]; then
  exit 0
fi

mkdir -p "$(dirname "$MEMORY_FILE")"
{
  echo ""
  echo "## $(date '+%Y-%m-%d %H:%M') の /compact カスタム指示"
  echo "$INSTRUCTIONS"
} >> "$MEMORY_FILE"
exit 0

{
  "hooks": {
    "PreCompact": [
      {
        "hooks": [
          { "type": "command", "command": ".claude/hooks/save-memory.sh" }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.slack.com/services/T00/B00/xxx",
            "headers": { "Content-Type": "application/json" }
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "^Bash$",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/pre-commit-lint.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
if echo "$CMD" | grep -q "git commit"; then
  cd "$CLAUDE_PROJECT_DIR" && npx lint-staged 2>&1 || {
    echo "lint-stagedが失敗しました。コードを修正してください。" >&2
    exit 2
  }
fi
exit 0

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo \"ブランチ: $(git branch --show-current) | Node: $(node -v) | 未コミット: $(git status --short | wc -l | tr -d ' ')件\""
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/audit-log.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
echo "$INPUT" | jq -c '{
  timestamp: now | todate,
  tool: .tool_name,
  command: .tool_input.command
}' >> "$CLAUDE_PROJECT_DIR/.claude/audit.jsonl"
exit 0

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "以下のツール実行結果を確認し、生成・変更されたコードにセキュリティ上の問題（ハードコードされた秘密情報、SQLインジェクション、XSS脆弱性）がないか判定してください。問題がなければ{\"ok\":true}、あれば{\"ok\":false,\"reason\":\"具体的な問題点\"}を返してください。: $ARGUMENTS",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "SubagentStop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/check-subagent.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
LAST_MSG=$(echo "$INPUT" | jq -r '.last_assistant_message // empty')
if echo "$LAST_MSG" | grep -qi "error\|failed\|couldn't"; then
  echo "サブエージェントがエラーで終了した可能性があります: $(echo "$LAST_MSG" | head -c 200)" >&2
  exit 2
fi
exit 0

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-prompt.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
INPUT=$(cat)
PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty')

# 機密情報の誤送信を防止
if echo "$PROMPT" | grep -qE '(sk-[a-zA-Z0-9]{20,}|ghp_[a-zA-Z0-9]{36}|AKIA[A-Z0-9]{16})'; then
  echo "プロンプトにAPIキーまたはシークレットが含まれています" >&2
  exit 2
fi

exit 0

# .zshrcの先頭に追加
[[ $- != *i* ]] && return

#!/bin/bash
# デバッグ用: 入力をファイルに保存
cat | tee /tmp/claude-hook-debug.json | jq .
exit 0