CLAUDE.md는 AI 에이전트에게 프로젝트의 맥락을 주입하는 가장 단순하면서도 강력한 방법이다. 복잡한 벡터 데이터베이스나 지식 그래프를 구축하기 전에, 프로젝트 루트에 텍스트 파일 하나를 두는 것만으로 에이전트의 행동 양식을 교정할 수 있다. 이는 AI가 코드베이스를 읽을 때마다 참조해야 할 ‘헌법’과 같은 역할을 수행한다.
특히 이 방식은 에이전트에게 매번 같은 지시를 반복할 필요를 없애준다. 코딩 컨벤션, 자주 사용하는 라이브러리, 배포 절차 등을 명시해 두면 AI는 마치 오래 함께 일한 동료처럼 팀의 규칙을 준수하며 코드를 작성한다. 이는 ‘지식의 파편화’ 문제를 해결하는 로컬 기반의 우아한 솔루션이다.
근거
Anthropic은 공식 문서를 통해 에이전트에게 기억(Memory)을 부여하는 핵심 방법으로 CLAUDE.md를 제안하고 있다.
“CLAUDE.md & how to give Claude memory: https://code.claude.com/docs/en/claude-md”
연결된 생각
- 20260528-claude-agent-ecosystem — 전체 생태계 내에서 컨텍스트 유지의 핵심 모듈.
- 20260528-agent-architecture-beyond-prompts — 에이전트가 자율적으로 동작하기 위해 필요한 정적 컨텍스트의 가치.