Claude AI의 컨텍스트 불안감을 줄이기 위한 CLAUDE.md 최적화

CLAUDE.md 최적화 핵심 전략

Anthropic의 문서를 분석한 레딧 토론에 따르면, 몇 가지 구체적인 개선 사항이 CLAUDE.md의 효과를 크게 높이고 컨텍스트 불안을 줄일 수 있습니다.

파일 구조와 길이

• CLAUDE.md를 200줄 이하로 유지하세요. Anthropic의 지침에 따르면, 더 긴 파일은 준수도를 낮추어 Claude가 규칙이 너무 많을 때 이를 건너뛰게 만듭니다.
• .claude/rules/ 디렉터리를 사용하여 규칙을 특정 파일 경로에 맞게 분리된 별도 파일로 나누세요. 이러한 규칙은 Claude가 일치하는 파일을 다룰 때만 로드되어 컨텍스트 노이즈를 줄입니다.
• 행동 규칙과 프로젝트 구조를 분리하세요. CLAUDE.md는 행동 규칙을 처리해야 하며, 아키텍처 세부 사항은 @/path/to/architecture.md 형식을 사용하여 외부 문서를 참조해야 합니다. 이렇게 하면 Claude가 시작 시 이를 로드하되 메인 파일을 부풀리지 않습니다.
• 인간용 메모에는 <!-- 관리자 참고 -->와 같은 HTML 주석을 사용하세요. 이는 컨텍스트에 들어가기 전에 제거되어 토큰 비용 없이 팀 커뮤니케이션을 위한 여유 공간을 제공합니다.

지침의 구체성

• 지침을 검증할 수 있을 만큼 구체적으로 만드세요. "2칸 들여쓰기 사용"은 효과적으로 작동하지만, "깨끗한 코드 작성"과 같은 모호한 지침은 무시되어 토큰 낭비를 유발하는 수정 루프로 이어집니다.
• 한 번의 수정 루프는 이를 방지했을 줄보다 쉽게 10~50배 더 많은 토큰을 소모할 수 있습니다.

자동 메모리 활용

• 버전 2.1.59부터 Claude는 빌드 명령, 디버그 패턴, 사용자 선호도에 대한 자체 메모를 저장합니다.
• 중복 정보를 CLAUDE.md에 추가하기 전에 /memory로 Claude가 이미 학습한 내용을 확인하세요.
• 자동 메모리가 이미 처리하는 내용을 중복해서 추가하지 말아 불필요한 컨텍스트 부풀림을 피하세요.

구현

CLAUDE.md 파일이 없는 팀의 경우, /init이 괜찮은 시작점을 생성하며, 여기서부터 다듬을 수 있습니다. CLAUDE.md는 어차피 모든 세션에 로드되므로 추가 비용이 들지 않으며, 명확한 사전 지침은 상당한 토큰을 소모하는 되돌아가는 수정을 방지합니다.