---
name: opencurrent-code-hooks-protect-files
description: "에이전트가 .env·잠금 파일·.git을 실수로 망가뜨리는 사고를 실행 전에 막아 줍니다. 이럴 때 사용: 수정하려는 파일이 보호 목록에 있으면 막는 작은 스크립트를 만들고, Claude Code 설정에 PreToolUse 훅으로 등록합니다. 마지막으로 보호 파일을 고쳐 달라고 해서 실제로 막히는지 시험합니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-hooks-protect-files"
  opencurrent-id: "claude-code-hooks-protect-files"
  verification: "pending"
  exported-at: "2026-11-21T11:16:13.208Z"
---

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

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-hooks-protect-files
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-hooks-protect-files")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.
3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.
4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

수정하려는 파일이 보호 목록에 있으면 막는 작은 스크립트를 만들고, 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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-hooks-protect-files 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
