{"id":"claude-code-hooks-protect-files","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/claude-code-hooks-protect-files","title":".env·잠금 파일·.git 수정을 편집 전에 차단 (PreToolUse 훅)","summary":"에이전트가 .env·잠금 파일·.git을 실수로 망가뜨리는 사고를 실행 전에 막아 줍니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code"],"whenToUse":"수정하려는 파일이 보호 목록에 있으면 막는 작은 스크립트를 만들고, Claude Code 설정에 PreToolUse 훅으로 등록합니다. 마지막으로 보호 파일을 고쳐 달라고 해서 실제로 막히는지 시험합니다.","body":"## 준비\n\n- Claude Code가 설치된 프로젝트 폴더\n- jq 설치 (macOS는 brew install jq, Debian·Ubuntu는 apt-get install jq)\n\n### 1. 보호 스크립트 파일 작성\n\n프로젝트의 `.claude/hooks/protect-files.sh`에 아래 스크립트를 저장합니다. 보호할 목록은 `PROTECTED_PATTERNS` 배열에서 고칩니다.\n\n```bash\n#!/bin/bash\n# protect-files.sh\n\nINPUT=$(cat)\nFILE_PATH=$(echo \"$INPUT\" | jq -r '.tool_input.file_path // empty')\n\n# Normalize Windows backslash separators so the patterns below match\nFILE_PATH=\"${FILE_PATH//\\\\//}\"\n\nPROTECTED_PATTERNS=(\".env\" \"package-lock.json\" \".git/\")\n\nfor pattern in \"${PROTECTED_PATTERNS[@]}\"; do\n  if [[ \"$FILE_PATH\" == *\"$pattern\"* ]]; then\n    echo \"Blocked: $FILE_PATH matches protected pattern '$pattern'\" >&2\n    exit 2\n  fi\ndone\n\nexit 0\n```\n\n### 2. 스크립트에 실행 권한 부여\n\nmacOS·Linux에서는 실행 권한이 있어야 훅이 동작합니다.\n\n```bash\nchmod +x .claude/hooks/protect-files.sh\n```\n\n`ls -l .claude/hooks/protect-files.sh` 결과에 x 표시가 보이면 됩니다.\n\n### 3. 설정 파일에 PreToolUse 훅 등록\n\n프로젝트 루트의 `.claude/settings.json`에 아래 hooks 블록을 추가합니다. 기존 설정이 있으면 hooks 키만 합칩니다. 이제 Edit·Write 호출 전에 스크립트가 실행됩니다.\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Edit|Write\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"\\\"$CLAUDE_PROJECT_DIR\\\"/.claude/hooks/protect-files.sh\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\nClaude Code 안에서 `/hooks`를 입력해 PreToolUse 아래에 훅이 보이면 등록된 것입니다.\n\n### 4. 보호 파일 편집 요청으로 시험\n\n새 세션에서 .env 수정을 요청합니다.\n\n```prompt\n.env 파일에 주석 한 줄 추가해 줘\n```\n\n편집 전에 막히고 차단 메시지가 Claude에게 전달됩니다. .env 내용이 그대로이고 응답에 'Blocked: … matches protected pattern' 문구가 보이면 성공입니다.\n\n## 주의\n\n- Edit·Write 도구만 막힙니다. 셸 명령으로는 여전히 보호 파일을 고칠 수 있으므로, 막으려면 `.claude/settings.json`의 `permissions.deny`에 경로별 Edit 규칙을 추가합니다(예: `Edit(/.env)`).\n- deny 규칙을 더해도 다른 경로로 .env가 바뀔 여지는 남습니다. 명령이 쓸 수 있는 파일 범위는 샌드박스 설정으로 제한합니다.\n- jq가 없으면 'jq: command not found' 오류가 납니다. jq를 설치하거나 Python·Node.js로 JSON을 해석합니다.\n- 막을 때는 종료 코드 2와 stderr 메시지를 씁니다. JSON 출력과 섞지 말고 한 가지 방식만 씁니다.","prerequisites":["Claude Code 설치된 프로젝트 폴더","jq 설치 (macOS는 brew install jq, Debian·Ubuntu는 apt-get install jq)"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"보호 스크립트 파일 작성","body":"프로젝트의 .claude/hooks/protect-files.sh에 아래 스크립트 저장. 보호 목록은 PROTECTED_PATTERNS 배열에서 조정","prompt":"#!/bin/bash\n# protect-files.sh\n\nINPUT=$(cat)\nFILE_PATH=$(echo \"$INPUT\" | jq -r '.tool_input.file_path // empty')\n\n# Normalize Windows backslash separators so the patterns below match\nFILE_PATH=\"${FILE_PATH//\\\\//}\"\n\nPROTECTED_PATTERNS=(\".env\" \"package-lock.json\" \".git/\")\n\nfor pattern in \"${PROTECTED_PATTERNS[@]}\"; do\n  if [[ \"$FILE_PATH\" == *\"$pattern\"* ]]; then\n    echo \"Blocked: $FILE_PATH matches protected pattern '$pattern'\" >&2\n    exit 2\n  fi\ndone\n\nexit 0","expected":".claude/hooks/protect-files.sh 파일","check":"파일 첫 줄이 #!/bin/bash인지 확인","tool":"Claude Code"},{"n":2,"kind":"command","title":"스크립트에 실행 권한 부여","body":"macOS·Linux에서는 실행 권한이 있어야 훅이 동작","prompt":"chmod +x .claude/hooks/protect-files.sh","expected":"실행 가능한 스크립트","check":"ls -l .claude/hooks/protect-files.sh 결과에 x 표시","tool":"Claude Code"},{"n":3,"kind":"command","title":"설정 파일에 PreToolUse 훅 등록","body":"프로젝트 루트의 .claude/settings.json에 아래 hooks 블록 추가. 기존 설정이 있으면 hooks 키만 합침","prompt":"{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Edit|Write\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"\\\"$CLAUDE_PROJECT_DIR\\\"/.claude/hooks/protect-files.sh\"\n          }\n        ]\n      }\n    ]\n  }\n}","expected":"Edit·Write 호출 전에 스크립트를 부르는 훅","check":"Claude Code 안에서 /hooks 입력 · PreToolUse 아래에 훅이 보이면 등록됨","tool":"Claude Code"},{"n":4,"kind":"ai","title":"보호 파일 편집 요청으로 시험","body":"새 세션에서 .env 수정 요청. 편집 전에 막히고 Blocked: 메시지가 Claude에게 피드백으로 전달","prompt":".env 파일에 주석 한 줄 추가해 줘","expected":".env 내용 그대로 · 차단 메시지","check":"응답에 'Blocked: … matches protected pattern' 문구가 보이면 성공","tool":"Claude Code"}],"pitfalls":["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 출력과 섞지 않고 한 가지 방식만 사용"],"sources":[{"title":"Automate actions with hooks","url":"https://code.claude.com/docs/en/hooks-guide"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":36,"likes":0}