Lesson (강의 단원)lecturedraftTue May 12
단원 — CLAUDE.md 4 위치 (관리정책·프로젝트·사용자·로컬)
별칭: 4 위치 · four-locations · hierarchical-claudemd
#claudemd#4-locations#hierarchy#override#priority
요약
Anthropic 공식 — CLAUDE.md 는 4 위치 에 둘 수 있고, 더 구체적인 위치가 더 광범위한 위치보다 우선. 헌법 메타포: 헌법 > 법률 > 시행령 > 시행규칙.
4 위치 표 (Anthropic 공식)
| 범위 | 위치 | 공유 |
|---|---|---|
| 관리 정책 | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md / Linux: /etc/claude-code/CLAUDE.md / Windows: C:\Program Files\ClaudeCode\CLAUDE.md | 조직 전체 (개별 제외 ❌) |
| 프로젝트 | ./CLAUDE.md 또는 ./.claude/CLAUDE.md | git 체크인 → 팀 |
| 사용자 | ~/.claude/CLAUDE.md | 본인만 (모든 프로젝트) |
| 로컬 | ./CLAUDE.local.md | 본인만 (.gitignore 필수) |
★ 헌법 메타포 매핑
| CLAUDE.md 위치 | 한국 법체계 | 특징 일치점 |
|---|---|---|
| 관리 정책 | 헌법 | 모든 하위 우선, 개별 제외 ❌ |
| 프로젝트 | 법률 | 팀 공유 (git 체크인), 프로젝트 전체 구속 |
| 사용자 | 시행령 (대통령령) | 개인 환경, 모든 프로젝트 횡단 |
| 로컬 | 시행규칙 (부령) | 특정 환경 구체 운영, gitignored |
.claude/rules/<path>.md | 행정규칙·고시 | 특정 영역만 (glob 패턴) |
→ 상위법 우선 원칙 ↔ CLAUDE.md 우선순위 정확 일치.
추가 메커니즘
- 상위 디렉토리 — 자동 가져옴 (모노레포 지원)
- 하위 디렉토리 — 해당 폴더 파일 작업 시 lazy load
claudeMdExcludes— 다른 팀 CLAUDE.md 건너뛰기 (관리 정책은 제외 불가)
강의 활용
- Ch2 — 본 단원 전체 활용. 헌법 메타포의 핵심 챕터.
- Ch6 —
.claude/rules/경로 범위 규칙 추가 설명.