16. Hooks 실전 가이드¶

#!/bin/bash
# .claude/hooks/lint-on-save.sh
INPUT=$(cat)
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

if [[ "$FILE" == *.ts || "$FILE" == *.tsx ]]; then
  pnpm eslint --fix "$FILE"
fi

#!/bin/bash
# .claude/hooks/protect-files.sh
INPUT=$(cat)
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

PROTECTED=(".env" ".env.local" ".env.production" "credentials.json")

for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE" == *"$pattern"* ]]; then
    echo "보호된 파일입니다: $FILE"
    exit 2  # exit 2 = Claude에게 도구 실행 중단 신호
  fi
done

exit 0

#!/bin/bash
# .claude/hooks/pre-commit-check.sh
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

if [[ "$COMMAND" == git\ commit* ]]; then
  echo "타입 체크 중..."
  if ! pnpm exec tsc --noEmit; then
    echo "타입 에러가 있습니다. 커밋을 중단합니다."
    exit 2
  fi
  echo "타입 체크 통과"
fi

exit 0

#!/bin/bash
# .claude/hooks/inject-context.sh
BRANCH=$(git branch --show-current 2>/dev/null)
LAST_ERROR=$(cat /tmp/last-build-error.txt 2>/dev/null | tail -5)

# stdout으로 출력하면 Claude의 컨텍스트에 자동 추가됨
echo "=== 자동 주입 컨텍스트 ==="
echo "현재 브랜치: ${BRANCH:-알 수 없음}"
if [ -n "$LAST_ERROR" ]; then
  echo "최근 빌드 에러:"
  echo "$LAST_ERROR"
fi
echo "========================="

#!/bin/bash
# .claude/hooks/final-check.sh
echo "작업 완료 검증 시작..."

ERRORS=""

if ! pnpm exec tsc --noEmit 2>/dev/null; then
  ERRORS="${ERRORS}타입 에러가 남아있습니다. "
fi

if ! pnpm test:run 2>/dev/null; then
  ERRORS="${ERRORS}실패한 테스트가 있습니다."
fi

if [ -n "$ERRORS" ]; then
  # JSON으로 차단 결정 반환
  echo "{\"decision\": \"block\", \"reason\": \"검증 실패: ${ERRORS}\"}"
  exit 0
fi

echo "모든 검증 통과"

#!/bin/bash
# .claude/hooks/auto-approve.sh
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# 읽기 전용 명령은 자동 허용
SAFE_PATTERNS=("^git status" "^git log" "^git diff" "^pnpm test" "^pnpm lint" "^ls " "^cat ")

for pattern in "${SAFE_PATTERNS[@]}"; do
  if [[ "$COMMAND" =~ $pattern ]]; then
    echo '{"decision": "approve"}'
    exit 0
  fi
done

# 나머지는 기본 동작 (사용자에게 확인)
exit 0

#!/bin/bash
# .claude/hooks/recovery-hint.sh
INPUT=$(cat)
ERROR=$(echo "$INPUT" | jq -r '.error // empty')

if echo "$ERROR" | grep -q "ENOSPC"; then
  echo "디스크 공간 부족입니다. 'docker system prune'으로 정리해보세요."
elif echo "$ERROR" | grep -q "ECONNREFUSED"; then
  echo "연결 거부. 서버가 실행 중인지 확인하세요."
elif echo "$ERROR" | grep -q "MODULE_NOT_FOUND"; then
  echo "모듈을 찾을 수 없습니다. 'pnpm install'을 먼저 실행하세요."
fi

#!/bin/bash
# .claude/hooks/quality-gate.sh

if ! pnpm lint 2>/dev/null; then
  echo '{"decision": "block", "reason": "lint 에러가 있습니다. 수정 후 다시 시도하세요."}'
  exit 0
fi

if ! pnpm test:run 2>/dev/null; then
  echo '{"decision": "block", "reason": "테스트 실패. 수정 후 다시 시도하세요."}'
  exit 0
fi

echo "품질 게이트 통과"

#!/bin/bash
INPUT=$(cat)

TOOL=$(echo "$INPUT" | jq -r '.tool_name // empty')
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
SESSION=$(echo "$INPUT" | jq -r '.session_id // empty')

echo "도구: $TOOL, 파일: $FILE"

# 스크립트 실행 권한 확인
chmod +x .claude/hooks/*.sh

# stdin JSON을 직접 넘겨서 동작 확인
echo '{"tool_name":"Edit","tool_input":{"file_path":"src/test.ts"}}' \
  | .claude/hooks/lint-on-save.sh

# 로그 남기기
echo "$(date): 훅 실행됨" >> /tmp/claude-hooks.log

#!/bin/bash
LOG="/tmp/claude-hooks-$(date +%Y%m%d).log"
INPUT=$(cat)

TOOL=$(echo "$INPUT" | jq -r '.tool_name // empty')
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

echo "[$(date +%H:%M:%S)] 도구: ${TOOL}, 파일: ${FILE}" >> "$LOG"

# 실제 로직 실행
# ...