Claude Code 가이드 #12 — Hooks로 워크플로우 자동화

settings.json — 기본 Hook 설정 구조
// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "echo '파일이 수정됐습니다: ' $CLAUDE_TOOL_OUTPUT"
          }
        ]
      }
    ]
  }
}

PostToolUse — JS/TS 파일 자동 lint (스크립트 방식 권장)
// .claude/settings.json
// 복잡한 인라인 명령보다 bash 스크립트로 분리하는 방식을 권장합니다
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash scripts/hook-lint.sh",
            "timeout": 15000
          }
        ]
      }
    ]
  }
}

scripts/hook-lint.sh — 별도 스크립트로 분리
#!/bin/bash
# scripts/hook-lint.sh
# PostToolUse Write|Edit 이벤트에서 호출됨

# CLAUDE_TOOL_INPUT 환경변수에서 파일 경로 추출
FILE=$(echo "$CLAUDE_TOOL_INPUT" | python3 -c "
import sys, json
try:
    d = json.load(sys.stdin)
    print(d.get('path') or d.get('file_path') or '')
except:
    print('')
")

if [[ -z "$FILE" ]]; then
    exit 0
fi

# JS/TS 파일만 검사
if [[ "$FILE" == *.js || "$FILE" == *.ts || "$FILE" == *.tsx ]]; then
    node --check "$FILE"
    if [ $? -ne 0 ]; then
        echo "SYNTAX ERROR: $FILE" >&2
        exit 1
    fi
    echo "OK: $FILE"
fi

settings.json — 스크립트 방식 Hook 등록
// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash scripts/hook-lint.sh",
            "timeout": 15000
          }
        ]
      }
    ]
  }
}

Notification Hook — 터미널 벨 소리 + macOS 알림
// .claude/settings.json
{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code가 응답을 기다립니다\" with title \"Claude Code\"\''"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "printf '\\a'"
          }
        ]
      }
    ]
  }
}

Stop Hook — 슬랙 웹훅 알림
#!/bin/bash
# scripts/hook-notify-slack.sh
# Stop 이벤트 시 슬랙으로 완료 알림

SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

curl -s -X POST "$SLACK_WEBHOOK_URL" \
  -H 'Content-type: application/json' \
  --data '{
    "text": "Claude Code 작업이 완료됐습니다.",
    "username": "Claude Code",
    "icon_emoji": ":robot_face:"
  }' > /dev/null

PreToolUse — 프로덕션 파일 수정 차단
#!/bin/bash
# scripts/hook-guard.sh
# PreToolUse Write|Edit 이벤트에서 호출됨
# 특정 파일(settings.json, .env 등)을 실수로 수정하는 것을 차단

FILE=$(echo "$CLAUDE_TOOL_INPUT" | python3 -c "
import sys, json
try:
    d = json.load(sys.stdin)
    print(d.get('path') or d.get('file_path') or '')
except:
    print('')
")

# 보호할 파일 목록
PROTECTED_FILES=(
    ".env"
    ".env.production"
    "vercel.json"
)

for protected in "${PROTECTED_FILES[@]}"; do
    if [[ "$FILE" == *"$protected"* ]]; then
        echo "BLOCKED: $FILE 는 보호된 파일입니다. 직접 수정이 필요하면 수동으로 편집하세요." >&2
        exit 2  # exit 2 = 도구 실행 차단
    fi
done

exit 0

settings.json — PreToolUse 가드 Hook 등록
// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash scripts/hook-guard.sh",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}