Claude Code 실전 (2): Hooks로 워크플로우 자동화

Claude가 코드를 생성할 때마다 자동으로 린트, 테스트, 보안 검사를 실행한다면? Hooks로 팀 워크플로우를 자동화하는 법.

TL;DR

• Hooks: Claude Code의 도구 실행 전후에 자동으로 스크립트 실행
• PreToolCall: 위험한 작업 전 확인, 민감한 파일 보호
• PostToolCall: 코드 생성 후 자동 린트/포맷, 보안 스캔
• Notification: Slack/Discord 알림으로 팀과 실시간 공유

1. Hooks가 뭔가요?

기존 워크플로우의 문제

1. Claude가 코드 작성 완료
2. 개발자가 수동으로 npm run lint 실행
3. 린트 에러 10개 발견
4. "Claude, 이거 고쳐줘"
5. 수정 후 또 수동으로 린트 실행... 무한 반복

Hooks를 사용하면

1. Claude가 코드 작성 완료
2. Hook이 자동으로 lint 실행 → 에러 발견 → Claude에게 피드백
3. Claude가 린트 에러 자동 수정
4. Hook이 다시 lint 실행 → 통과

Hooks는 Claude의 도구 실행에 연결되는 자동화 스크립트입니다.

2. Hook 종류와 실행 시점

4가지 Hook 타입

Hook 설정 파일 위치

프로젝트/
├── .claude/
│   └── settings.json    # 프로젝트별 Hooks
└── ~/.claude/
    └── settings.json    # 전역 Hooks

3. 실전 예제: PostToolCall

예제 1: 자동 린트 + 포맷

`.claude/settings.json`

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "command": "npm run lint:fix -- $CLAUDE_FILE_PATH",
        "description": "Auto-fix lint errors after file changes"
      }
    ]
  }
}

작동 방식:

1. Claude가 Edit 또는 Write 도구 사용
2. Hook이 해당 파일에 npm run lint:fix 실행
3. 결과가 Claude에게 피드백됨

예제 2: 보안 스캔 (Trivy)

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.tf|*.yaml|Dockerfile",
        "command": "trivy config $CLAUDE_FILE_PATH --severity HIGH,CRITICAL",
        "description": "Security scan for IaC files"
      }
    ]
  }
}

인프라 코드 변경 시 자동으로 보안 취약점 검사!

예제 3: TypeScript 타입 체크

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.ts|*.tsx",
        "command": "npx tsc --noEmit $CLAUDE_FILE_PATH 2>&1 | head -20",
        "description": "Type check TypeScript files"
      }
    ]
  }
}

4. 실전 예제: PreToolCall

예제 1: 민감한 파일 보호

{
  "hooks": {
    "PreToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.env*|*secret*|*credential*",
        "command": "echo '⚠️ BLOCKED: Attempting to modify sensitive file' && exit 1",
        "description": "Prevent modification of sensitive files"
      }
    ]
  }
}

`.env` 파일 수정 시도 시 자동 차단!

예제 2: 위험한 Bash 명령어 차단

{
  "hooks": {
    "PreToolCall": [
      {
        "matcher": "Bash",
        "command": "scripts/check-dangerous-commands.sh \"$CLAUDE_BASH_COMMAND\"",
        "description": "Block dangerous bash commands"
      }
    ]
  }
}

`check-dangerous-commands.sh`

#!/bin/bash
COMMAND="$1"

# 위험한 패턴 체크
DANGEROUS_PATTERNS=(
  "rm -rf /"
  "rm -rf ~"
  ":(){ :|:& };:"  # fork bomb
  "> /dev/sda"
  "mkfs."
  "dd if=/dev/zero"
)

for pattern in "${DANGEROUS_PATTERNS[@]}"; do
  if [[ "$COMMAND" == *"$pattern"* ]]; then
    echo "🚫 BLOCKED: Dangerous command detected: $pattern"
    exit 1
  fi
done

exit 0

5. 실전 예제: Notification

Slack 알림 설정

{
  "hooks": {
    "Notification": [
      {
        "event": "TaskComplete",
        "command": "scripts/notify-slack.sh \"$CLAUDE_TASK_SUMMARY\"",
        "description": "Notify Slack when task completes"
      }
    ]
  }
}

`notify-slack.sh`

#!/bin/bash
MESSAGE="$1"
WEBHOOK_URL="${SLACK_WEBHOOK_URL}"

curl -X POST -H 'Content-type: application/json' \
  --data "{\"text\":\"🤖 Claude completed: ${MESSAGE}\"}" \
  "$WEBHOOK_URL"

Discord 알림

#!/bin/bash
MESSAGE="$1"
WEBHOOK_URL="${DISCORD_WEBHOOK_URL}"

curl -X POST -H 'Content-type: application/json' \
  --data "{\"content\":\"🤖 Claude completed: ${MESSAGE}\"}" \
  "$WEBHOOK_URL"

6. 팀을 위한 Hook 설정 예시

프론트엔드 팀

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.tsx|*.ts",
        "command": "npm run lint:fix -- $CLAUDE_FILE_PATH && npm run format -- $CLAUDE_FILE_PATH",
        "description": "Lint and format TypeScript files"
      },
      {
        "matcher": "Edit|Write",
        "pattern": "*.css|*.scss",
        "command": "npx stylelint --fix $CLAUDE_FILE_PATH",
        "description": "Lint CSS files"
      }
    ],
    "PreToolCall": [
      {
        "matcher": "Write",
        "pattern": "src/components/ui/*",
        "command": "echo '⚠️ UI component 생성은 디자인 시스템 가이드를 참고하세요' && exit 0",
        "description": "Warn about UI component creation"
      }
    ]
  }
}

백엔드 팀

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.py",
        "command": "black $CLAUDE_FILE_PATH && ruff check --fix $CLAUDE_FILE_PATH",
        "description": "Format and lint Python files"
      },
      {
        "matcher": "Edit|Write",
        "pattern": "*.sql",
        "command": "sqlfluff fix $CLAUDE_FILE_PATH",
        "description": "Format SQL files"
      }
    ],
    "PreToolCall": [
      {
        "matcher": "Bash",
        "pattern": "*migrate*|*migration*",
        "command": "echo '⚠️ DB 마이그레이션은 반드시 리뷰 후 실행하세요' && exit 0",
        "description": "Warn about migrations"
      }
    ]
  }
}

DevOps 팀

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit|Write",
        "pattern": "*.tf",
        "command": "terraform fmt $CLAUDE_FILE_PATH && terraform validate",
        "description": "Format and validate Terraform"
      },
      {
        "matcher": "Edit|Write",
        "pattern": "*.yaml|*.yml",
        "command": "yamllint $CLAUDE_FILE_PATH",
        "description": "Lint YAML files"
      },
      {
        "matcher": "Edit|Write",
        "pattern": "Dockerfile*|*.dockerfile",
        "command": "hadolint $CLAUDE_FILE_PATH",
        "description": "Lint Dockerfiles"
      }
    ],
    "PreToolCall": [
      {
        "matcher": "Bash",
        "pattern": "*kubectl*delete*|*terraform*destroy*",
        "command": "echo '🚨 프로덕션 리소스 삭제 명령입니다. 정말 실행하시겠습니까?' && exit 1",
        "description": "Block destructive commands"
      }
    ]
  }
}

7. Hook 디버깅 팁

1) 명령어 테스트

Hook을 설정하기 전에 명령어가 제대로 작동하는지 테스트:

# 환경 변수 시뮬레이션
CLAUDE_FILE_PATH="src/components/Button.tsx"
npm run lint:fix -- $CLAUDE_FILE_PATH

2) 로깅 추가

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Edit",
        "command": "echo \"[$(date)] Edited: $CLAUDE_FILE_PATH\" >> ~/.claude/hook.log && npm run lint:fix -- $CLAUDE_FILE_PATH",
        "description": "Log and lint"
      }
    ]
  }
}

3) exit 코드 이해

• exit 0: 성공, Claude 계속 진행
• exit 1: 실패, Claude에게 에러 피드백
• 출력 내용이 Claude에게 전달됨

8. 환경 변수 레퍼런스

Hook에서 사용 가능한 환경 변수:

9. 실전 시나리오: CI/CD 파이프라인 연동

PR 생성 시 자동 체크

{
  "hooks": {
    "PostToolCall": [
      {
        "matcher": "Bash",
        "pattern": "*git push*|*gh pr create*",
        "command": "scripts/pre-push-checks.sh",
        "description": "Run checks before push"
      }
    ]
  }
}

`pre-push-checks.sh`

#!/bin/bash
set -e

echo "🔍 Running pre-push checks..."

# 1. 린트
echo "  → Lint check..."
npm run lint

# 2. 타입 체크
echo "  → Type check..."
npm run typecheck

# 3. 테스트
echo "  → Running tests..."
npm run test

# 4. 빌드 확인
echo "  → Build check..."
npm run build

echo "✅ All checks passed!"

마무리

Hooks는 단순한 자동화가 아닙니다.

팀의 품질 기준을 코드로 강제하는 방법입니다.

다음 편에서는 Custom Skills를 활용해 팀만의 표준 명령어를 만드는 방법을 다룹니다.

시리즈 목차

1. Context가 전부다
2. Hooks로 워크플로우 자동화 (현재 글)
3. Custom Skills로 팀 표준 만들기
4. MCP 서버 구축하기
5. 모델 믹스 전략