본문으로 건너뛰기

.env·잠금 파일·.git 수정을 편집 전에 차단 (PreToolUse 훅)

에이전트가 .env·잠금 파일·.git을 실수로 망가뜨리는 사고를 실행 전에 막아 줍니다.

수정하려는 파일이 보호 목록에 있으면 막는 작은 스크립트를 만들고, Claude Code 설정에 PreToolUse 훅으로 등록합니다. 마지막으로 보호 파일을 고쳐 달라고 해서 실제로 막히는지 시험합니다.

준비

  • Claude Code가 설치된 프로젝트 폴더
  • jq 설치 (macOS는 brew install jq, Debian·Ubuntu는 apt-get install jq)

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

2. 스크립트에 실행 권한 부여

macOS·Linux에서는 실행 권한이 있어야 훅이 동작합니다.

터미널에 붙여 넣기
chmod +x .claude/hooks/protect-files.sh

ls -l .claude/hooks/protect-files.sh 결과에 x 표시가 보이면 됩니다.

3. 설정 파일에 PreToolUse 훅 등록

프로젝트 루트의 .claude/settings.json에 아래 hooks 블록을 추가합니다. 기존 설정이 있으면 hooks 키만 합칩니다. 이제 Edit·Write 호출 전에 스크립트가 실행됩니다.

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

Claude Code 안에서 /hooks를 입력해 PreToolUse 아래에 훅이 보이면 등록된 것입니다.

4. 보호 파일 편집 요청으로 시험

새 세션에서 .env 수정을 요청합니다.

AI에게 보내기
.env 파일에 주석 한 줄 추가해 줘

편집 전에 막히고 차단 메시지가 Claude에게 전달됩니다. .env 내용이 그대로이고 응답에 'Blocked: … matches protected pattern' 문구가 보이면 성공입니다.

주의

  • Edit·Write 도구만 막힙니다. 셸 명령으로는 여전히 보호 파일을 고칠 수 있으므로, 막으려면 .claude/settings.json의 permissions.deny에 경로별 Edit 규칙을 추가합니다(예: Edit(/.env)).
  • deny 규칙을 더해도 다른 경로로 .env가 바뀔 여지는 남습니다. 명령이 쓸 수 있는 파일 범위는 샌드박스 설정으로 제한합니다.
  • jq가 없으면 'jq: command not found' 오류가 납니다. jq를 설치하거나 Python·Node.js로 JSON을 해석합니다.
  • 막을 때는 종료 코드 2와 stderr 메시지를 씁니다. JSON 출력과 섞지 말고 한 가지 방식만 씁니다.

업무 분야 · 필요한 기능

이 기능을 가진 도구