클로드가 .env 같은 파일 못 건드리게 막기

준비jq 설치

1. 훅 스크립트가 JSON을 읽을 때 jq라는 작은 도구를 써요. 맥은 이렇게 설치해요.
   복사

   brew install jq

• 데비안·우분투는 apt-get install jq 로 설치해요.

1단계검사 스크립트 만들기

1. 프로젝트 안 .claude/hooks/protect-files.sh 로 저장합니다. 막고 싶은 이름은 PROTECTED_PATTERNS 괄호 안에 더하면 돼요.
   복사

   #!/bin/bash
   # protect-files.sh
   
   INPUT=$(cat)
   FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
   
   # Normalize Windows backslash separators so the patterns below match
   FILE_PATH="${FILE_PATH//\\//}"
   
   PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")
   
   for pattern in "${PROTECTED_PATTERNS[@]}"; do
     if [[ "$FILE_PATH" == *"$pattern"* ]]; then
       echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2
       exit 2
     fi
   done
   
   exit 0

• exit 2 가 '막아라'라는 신호예요. 그때 >&2 로 내보낸 문장이 클로드에게 이유로 전달돼요.

2단계실행 권한 주기

1. 맥·리눅스에선 실행 권한이 있어야 돌아가요.
   복사

   chmod +x .claude/hooks/protect-files.sh

3단계훅 등록

1. 프로젝트의 .claude/settings.json 에 넣어요. Edit|Write 는 '파일을 고치거나 새로 쓸 때'만 검사하라는 뜻이에요.
   복사

   {
     "hooks": {
       "PreToolUse": [
         {
           "matcher": "Edit|Write",
           "hooks": [
             {
               "type": "command",
               "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
             }
           ]
         }
       ]
     }
   }

4단계시험

1. 클로드에게 '.env 파일에 주석 한 줄 추가해 줘'라고 해 보세요. 고치기 전에 막히고, Blocked: 로 시작하는 이유가 클로드에게 전달되면 성공이에요.

• 이 훅은 클로드의 편집 도구만 검사해요. 셸 명령으로 파일을 바꾸는 경우까지 막진 못해요.

같이 걸어 두면 좋은 훅