3.3경로별 규칙

Claude Code의 동작 설정은 여러 위치의 settings.json이 계층적으로 병합되어 결정됩니다.

파일	범위	용도
엔터프라이즈 관리 정책	조직 전체	관리자가 강제, 사용자가 덮어쓸 수 없음
~/.claude/settings.json	사용자 전역	개인 기본값
.claude/settings.json	프로젝트 (커밋)	팀 공유 규칙
.claude/settings.local.json	프로젝트 (개인)	커밋하지 않는 개인 오버라이드, 자동으로 gitignore 처리

우선순위는 엔터프라이즈 정책 > 명령줄 인자 > 로컬 프로젝트 설정 > 공유 프로젝트 설정 > 사용자 설정 순입니다. 즉 관리자가 금지한 것은 누구도 로컬에서 풀 수 없고, 같은 항목이라면 프로젝트 로컬 설정이 사용자 전역 설정을 이깁니다.

// .claude/settings.json — 팀 공유
{
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

이 파일을 저장소에 커밋하면 팀원 전체가 같은 허용·금지 규칙 아래에서 작업하게 됩니다. 개인적으로 더 허용하고 싶은 것이 있으면 settings.local.json에 추가합니다.

permissions에는 allow(자동 허용), ask(확인 후 실행), deny(항상 거부) 세 목록이 있으며, 각 규칙은 도구이름(지정자) 형태입니다.

Bash 규칙은 명령 접두사로 매칭합니다.

• Bash(npm run test:*) — npm run test로 시작하는 모든 명령 허용
• Bash(git push:*)를 deny에 넣으면 푸시를 항상 차단

파일 도구 규칙(Read, Edit 등)은 gitignore 스타일 경로 패턴을 씁니다.

• Read(./.env) — 프로젝트 루트의 .env 읽기
• Edit(./src/**) — src 아래 모든 파일 편집
• Read(~/Documents/*.pdf) — 홈 디렉터리 문서

그 외 도구는 WebFetch(domain:example.com)처럼 도구별 지정자를 갖거나, 지정자 없이 WebSearch처럼 도구 전체를 지정할 수 있습니다.

{
  "permissions": {
    "allow": ["Bash(npm run:*)", "WebFetch(domain:docs.anthropic.com)"],
    "ask": ["Bash(git push:*)"],
    "deny": ["Read(./.env*)", "Read(./secrets/**)", "Bash(curl:*)"]
  }
}

주의할 점: deny가 항상 allow보다 우선합니다. 그리고 Bash 접두사 매칭은 셸 문법을 완전히 해석하는 것이 아니므로, 보안 경계로 삼기보다는 실수 방지 장치로 이해해야 합니다. 진짜 보안 격리가 필요하면 샌드박스나 컨테이너 수준에서 격리해야 합니다.

실무에서 가장 중요한 패턴은 비밀 정보 접근 차단입니다. .env, 인증서, 클라우드 자격증명 파일은 deny 목록에 명시하는 것이 표준 관행입니다.

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./config/credentials/**)",
      "Read(~/.aws/**)"
    ]
  }
}

deny의 Read 규칙에 걸린 파일은 Claude가 읽으려 할 때 차단되므로, 실수로 비밀 값이 컨텍스트(그리고 대화 로그)에 들어가는 것을 막습니다.

작업 디렉터리 확장도 경로 제어의 일부입니다. Claude Code는 기본적으로 실행된 디렉터리를 기준으로 작업하며, 그 밖의 경로에 접근할 때는 추가 승인이 필요합니다. 여러 저장소를 오가는 작업이라면 --add-dir 플래그나 /add-dir 명령으로 추가 디렉터리를 명시적으로 열어 줄 수 있습니다. 설정의 additionalDirectories 항목으로 상시 허용할 수도 있습니다.

마지막으로 경로별 '규칙'과 경로별 '지침'의 구분을 다시 짚어야 합니다. 특정 디렉터리에서의 코딩 컨벤션은 그 디렉터리의 CLAUDE.md(3.1 수업)로 전달하는 지침이고, 특정 경로의 읽기·쓰기 차단은 permissions로 거는 강제입니다. 전자는 모델이 따르도록 유도하는 것, 후자는 시스템이 차단하는 것입니다. 시험에서는 이 둘을 바꿔 놓은 오답이 자주 출제됩니다.