AI 요약
핵심 인사이트
- Claude Code는 세션 간 과거 코드를 기억하지 못하기 때문에, CLAUDE.md 파일이 코드베이스 및 규칙을 LLM이 이해하는 데 필요한 외부 기억 영역(온보드 패키지) 역할을 수행한다.
- CLAUDE.md는
/init명령어를 통해 프로젝트 구조를 분석하여 생성할 수 있으며, 세션 시작 시에만 콘텍스트에 로드되는 특징을 갖는다. - 대규모 코드베이스 관리를 위해 CLAUDE.md를 하위 디렉토리에 계층적으로 배치할 수 있으며, 하위 디렉토리 파일은 해당 디렉토리의 파일이 접촉될 때만 읽히는 지연 로딩(LazyLoad) 메커니즘을 통해 컨텍스트 윈도우를 효율적으로 사용한다.
주요 디테일
- CLAUDE.md에 기재할 내용은 코드베이스 개요, 사용 기술, 인프라 구성, 코드 규약 및 테스트 규약 등이다.
- CLAUDE.md가 콘텍스트에 로드되는 타이밍은
claude명령으로 대화 모드를 시작하거나/clear명령으로 새로운 세션을 시작할 때뿐이다. - 사용자 전체에 적용되는 글로벌 규칙을 설정하려면 홈 디렉토리 하위 경로인
~/.claude/CLAUDE.md에 파일을 배치해야 하며, 이는 어떤 프로젝트에서 작업하든 항상 읽어들인다. - 현재 워킹 디렉토리의 상위 방향에 존재하는 CLAUDE.md는 세션 시작 시 일괄 로드되며, 하위 방향에 있는 CLAUDE.md는 해당 디렉토리 내 파일을 Claude가 읽을 때 처음으로 로드된다.
/memory명령을 실행하면 현재 로드되어 있는 CLAUDE.md 목록을 확인할 수 있다.