Claude Code Hooks — 開発ワークフローを自動化する実践テクニック集

#!/bin/bash
# .claude/hooks/security-guard.sh
# PreToolUse フック — 機密ファイルへの書き込みを防止
 
FILEPATH="$1"
 
# 機密ファイルのパターン
SENSITIVE_PATTERNS=(
  "*.env"
  "*.env.*"
  "*credentials*"
  "*secret*"
  "*.pem"
  "*.key"
  "*config/production*"
)
 
for pattern in "${SENSITIVE_PATTERNS[@]}"; do
  if [[ "$FILEPATH" == $pattern ]]; then
    echo "🚫 セキュリティ警告: 機密ファイル '$FILEPATH' への書き込みをブロックしました"
    echo "手動で編集するか、明示的に許可してください。"
    exit 2  # exit 2 = ツール実行をブロック
  fi
done
 
# ファイル内容に機密情報が含まれていないかチェック
if [ -f "$FILEPATH" ]; then
  if grep -qiE '(api[_-]?key|secret[_-]?key|password|token)\s*[:=]\s*["\x27][^\s]+' "$FILEPATH" 2>/dev/null; then
    echo "⚠️ 警告: ファイルにハードコードされた認証情報が検出されました"
    echo "環境変数を使用してください。"
    exit 2
  fi
fi
 
exit 0  # 問題なし — ツール実行を許可

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/security-guard.sh \"$FILEPATH\""
        }
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/post-edit-lint.sh
# PostToolUse フック — 編集後に自動リント＆フォーマット
 
FILEPATH="$1"
EXTENSION="${FILEPATH##*.}"
 
case "$EXTENSION" in
  ts|tsx)
    echo "🔍 TypeScript: ESLintを実行中..."
    npx eslint --fix "$FILEPATH" 2>&1
    echo "💅 Prettierでフォーマット中..."
    npx prettier --write "$FILEPATH" 2>&1
    ;;
  py)
    echo "🔍 Python: Ruffを実行中..."
    ruff check --fix "$FILEPATH" 2>&1
    ruff format "$FILEPATH" 2>&1
    ;;
  rs)
    echo "🔍 Rust: cargo fmtを実行中..."
    rustfmt "$FILEPATH" 2>&1
    ;;
  go)
    echo "🔍 Go: gofmtを実行中..."
    gofmt -w "$FILEPATH" 2>&1
    ;;
  *)
    echo "📝 リント対象外のファイル形式です: .$EXTENSION"
    ;;
esac
 
exit 0

#!/bin/bash
# .claude/hooks/auto-test.sh
# PostToolUse フック — 関連テストを自動実行
 
FILEPATH="$1"
DIR=$(dirname "$FILEPATH")
BASENAME=$(basename "$FILEPATH" | sed 's/\.[^.]*$//')
 
# テストファイルの候補を探す
TEST_FILES=()
for pattern in \
  "${DIR}/${BASENAME}.test.ts" \
  "${DIR}/${BASENAME}.test.tsx" \
  "${DIR}/${BASENAME}.spec.ts" \
  "${DIR}/__tests__/${BASENAME}.test.ts" \
  "tests/${BASENAME}.test.ts"; do
  if [ -f "$pattern" ]; then
    TEST_FILES+=("$pattern")
  fi
done
 
if [ ${#TEST_FILES[@]} -eq 0 ]; then
  echo "📝 対応するテストファイルが見つかりませんでした"
  exit 0
fi
 
echo "🧪 関連テストを実行中..."
for test_file in "${TEST_FILES[@]}"; do
  echo "  → $test_file"
  npx vitest run "$test_file" --reporter=verbose 2>&1
done
 
# テスト失敗時もフック自体は成功とする（Claudeにフィードバックとして伝わる）
exit 0

#!/bin/bash
# .claude/hooks/git-safety.sh
# PreToolUse フック — 危険なGit操作をブロック
 
COMMAND="$1"
 
# 危険なGitコマンドのパターン
DANGEROUS_PATTERNS=(
  "git push.*--force"
  "git push.*-f "
  "git reset --hard"
  "git checkout \."
  "git clean -fd"
  "git branch -D"
  "git rebase.*main"
)
 
for pattern in "${DANGEROUS_PATTERNS[@]}"; do
  if echo "$COMMAND" | grep -qE "$pattern"; then
    echo "🚫 危険なGit操作を検出しました: $COMMAND"
    echo "この操作はデータ損失のリスクがあります。"
    echo "手動で実行するか、安全な代替コマンドを使用してください。"
    exit 2
  fi
done
 
exit 0

#!/bin/bash
# .claude/hooks/notify-slack.sh
# Notification フック — Slack Webhookで通知
 
MESSAGE="$1"
SLACK_WEBHOOK_URL="${SLACK_WEBHOOK_URL:-}"
 
if [ -z "$SLACK_WEBHOOK_URL" ]; then
  exit 0  # Webhook未設定の場合はスキップ
fi
 
# メッセージを整形してSlackに送信
PAYLOAD=$(cat <<EOF
{
  "text": "🤖 Claude Code 通知",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*Claude Code からの通知:*\n${MESSAGE}"
      }
    },
    {
      "type": "context",
      "elements": [
        {
          "type": "mrkdwn",
          "text": "📁 プロジェクト: $(basename $(pwd)) | ⏰ $(date '+%Y-%m-%d %H:%M')"
        }
      ]
    }
  ]
}
EOF
)
 
curl -s -X POST "$SLACK_WEBHOOK_URL" \
  -H 'Content-type: application/json' \
  -d "$PAYLOAD" > /dev/null 2>&1
 
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/security-guard.sh \"$FILEPATH\""
        }
      },
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/git-safety.sh \"$COMMAND\""
        }
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/post-edit-lint.sh \"$FILEPATH\""
        }
      },
      {
        "matcher": "Edit|Write",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/auto-test.sh \"$FILEPATH\""
        }
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/notify-slack.sh \"$MESSAGE\""
        }
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hook": {
          "type": "command",
          "command": "bash .claude/hooks/on-stop.sh"
        }
      }
    ]
  }
}

#!/bin/bash
# 重い処理はバックグラウンドで実行
nohup bash -c "npm run test:coverage" > /tmp/test-results.log 2>&1 &
echo "🧪 テストをバックグラウンドで実行中（結果: /tmp/test-results.log）"
exit 0

#!/bin/bash
# デバッグログ
LOG_FILE="/tmp/claude-hooks.log"
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Hook: $0 | Args: $@" >> "$LOG_FILE"
 
# 本来の処理...
 
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Hook completed: $0 | Exit: $?" >> "$LOG_FILE"

#!/bin/bash
# 環境に応じてフックの厳格さを変更
HOOK_MODE="${CLAUDE_HOOK_MODE:-strict}"
 
if [ "$HOOK_MODE" = "permissive" ]; then
  echo "📝 許容モード: チェックをスキップします"
  exit 0
fi
 
# strict モードの処理...