8 레이어 컨텍스트 (Claude Code 가 매 요청에 쌓는 8 층)
Term (용어)aidraftTue May 12

8 레이어 컨텍스트 (Claude Code 가 매 요청에 쌓는 8 층)

별칭: 8 레이어 · Claude Code 컨텍스트 8 층 · 8-layer context stack

#context-stack#priority#claude-code#claudemd-locations#youtube-lecture

정의

Claude Code 가 매 요청마다 컨텍스트에 자동으로 쌓는 8 개 레이어 — 실벨 개발자 YouTube 강의 출처.

8 레이어 (위 → 아래)

1. 시스템 프롬프트
2. 도구 (Tool) 정의
3. 전역 CLAUDE.md           (~/.claude/CLAUDE.md)
4. 프로젝트 CLAUDE.md       (<repo>/CLAUDE.md)
5. CLAUDE.local.md          (<repo>/CLAUDE.local.md)
6. 서브디렉토리 CLAUDE.md   (<sub>/CLAUDE.md)
7. 대화 히스토리
8. 현재 사용자 메시지        ← 가장 강력

★ 우선순위 — 아래로 갈수록 강력

  • 서브디렉토리 ↔ 전역 충돌 → 서브디렉토리 이긴다
  • 현재 사용자 메시지 = 가장 강력

작성 판단:

  • 보편적 → 위 레벨 (전역)
  • 특수할수록 → 아래 레벨 (서브디렉토리)

★ 헌법 메타포와의 방향 차이 (강의 핵심 주의)

비유우선순위 방향
법체계위 우선 (헌법 > 법률 > 시행령)
8 레이어아래 우선 (서브디렉토리 > 전역)

두 비유의 방향이 반대. 강의 Ch2 에서 명확 분리 필요. ([[synthesis_horim_claudemd-as-constitution-of-vibe-coding]] §주의 절)

강의 활용

  • Ch2 §2.3~§2.4 — 8 레이어 + 두 비유 방향 차이
  • Ch3 — 안티 패턴 표 ("사람 읽기 좋게" 가 아니라 어느 레이어에 둘 것인가 가 핵심)