# .env·잠금 파일·.git 수정을 편집 전에 차단 (PreToolUse 훅)
id: claude-code-hooks-protect-files · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-hooks-protect-files
기준일: 2026-11-15 (여기서 고친 날)
도구: Claude Code
평가 점수: 32/100 (확인 없음 · 검수 대기)

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

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

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

본문:

## 준비

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

### 1. 보호 스크립트 파일 작성

프로젝트의 `.claude/hooks/protect-files.sh`에 아래 스크립트를 저장합니다. 보호할 목록은 `PROTECTED_PATTERNS` 배열에서 고칩니다.

```bash
#!/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에서는 실행 권한이 있어야 훅이 동작합니다.

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

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

### 3. 설정 파일에 PreToolUse 훅 등록

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

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

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

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

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

```prompt
.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 출력과 섞지 말고 한 가지 방식만 씁니다.

주의:
- 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 출력과 섞지 않고 한 가지 방식만 사용

출처:
- Automate actions with hooks https://code.claude.com/docs/en/hooks-guide