CLAUDE.md 를 '3 계층 구조'로 작성하면 Claude Code 의 지능이 급격히 향상되는 이야기

요약

Claude Code는 프로젝트의 지능 향상을 위해 '3 계층 구조'로 작성된 `CLAUDE.md` 파일을 활용합니다. 이 구조는 전역(Global), 프로젝트(Project), 하위 디렉토리(Sub-directory) 세 가지 레벨에서 각각 다른 유형의 규칙과 지시사항을 정의할 수 있게 합니다. 이를 통해 AI가 전체 프로젝트 공통 규칙, 회사 정책, 그리고 특정 모듈의 고유한 규칙까지 체계적으로 이해하여 코딩 및 작업 능력을 극대화합니다.

핵심 포인트

• Claude Code는 전역/프로젝트/하위 디렉토리 3단계 구조의 `CLAUDE.md` 파일을 순차적으로 읽어 지능을 향상시킵니다.
• 이 계층적 접근 방식은 '전체 프로젝트 공통 규칙', '회사 정책', '특정 모듈 고유 규칙'을 명확하게 분리할 수 있게 합니다.
• 최상위(Global) `CLAUDE.md`에 '디스패치 규칙'을 추가하면, AI 팀이 자연어 지시사항만으로 움직일 수 있는 능력을 갖게 됩니다.