요약

Anthropic 공식 — CLAUDE.md 의 3 가지 로드 규칙: ① 트리 위로 올라가며 수집, ② 하위 디렉토리는 lazy load, ③ HTML 주석은 컨텍스트 주입 전 제거.

① 트리 위로 — foo/bar/ 에서 실행 시

1. foo/bar/CLAUDE.md
2. foo/CLAUDE.md
3. 그 옆의 모든 CLAUDE.local.md

모두 컨텍스트에 연결 (재정의 ❌). 정렬: 루트 → 작업 디렉토리 순서. → 시작 위치에 더 가까운 지침이 마지막 에 읽힘.

각 디렉토리 내: CLAUDE.local.md 가 CLAUDE.md 후에 추가 → 그 수준의 마지막.

② 하위 디렉토리 — Lazy Load

"Claude 가 현재 작업 디렉토리 아래 하위 디렉토리 에서도 CLAUDE.md 를 발견 + 시작 시 로드 ❌ + Claude 가 해당 하위 디렉토리 파일을 읽을 때 포함."

→ 모노레포 토큰 절약 핵심.

③ HTML 주석 제거

<!-- maintainer notes for human only -->

• 블록 수준 HTML 주석 = 컨텍스트 주입 전 제거
• 코드 블록 내 주석 = 보존
• Read 도구로 CLAUDE.md 직접 열 때 = 표시

→ 컨텍스트 토큰 소비 없이 인간 유지보수자 노트 남기는 공식 트릭.

★ 압축 생존 (강의 결론 연결)

• 프로젝트 루트 CLAUDE.md = 압축 완전 생존 → /compact 후 디스크에서 다시 읽고 새로 주입
• 하위 디렉토리 중첩 CLAUDE.md = 자동 재주입 ❌ → 해당 폴더 파일 다시 읽을 때 로드
• 대화 전용 지침 → CLAUDE.md 에 작성해야 압축 후 생존

강의 활용

• Ch5 — 로드 메커니즘 상세 + 압축 생존 (왜 CLAUDE.md 가 영구적인가)
• Ch6 §6.4 — 하위 디렉토리 lazy load 의 토큰 절약 효과