Claude Code는 세션 간 컨텍스트를 유지하고 사용자의 선호사항을 기억하기 위한 메모리 시스템을 제공합니다.
메모리 종류
Claude Code에는 두 가지 메모리 종류가 있습니다.
자동 메모리
세션 간에 유지되는 개념으로, Claude가 답변하면서 프로젝트 패턴, 주요 명령어, 사용자 선호 내용 등 여러 컨텍스트를 자동으로 저장하고 참고합니다.
CLAUDE.md 파일
사용자가 직접 작성하는 마크다운 파일로, Claude가 따라야 할 규칙이나 선호사항을 작성합니다.
자동 메모리 상세
저장되는 내용
자동 메모리에는 다음과 같은 내용이 자동으로 저장됩니다.
- 프로젝트 패턴
- 디버깅 인사이트
- 아키텍처 노트
- 사용자 선호사항
저장 위치
~/.claude/projects/<project>/memory/
├── MEMORY.md # 간결한 인덱스, 매 세션마다 로드
├── debugging.md # 디버깅 패턴 상세 노트
├── api-conventions.md # API 설계 결정사항
└── ...
작동 방식
MEMORY.md의 첫 200줄만 세션이 시작될 때 로드됩니다. debugging.md와 같은 특정 주제에 대한 파일들은 필요할 때 Claude가 읽습니다.
따라서 MEMORY.md에는 가장 중요하고 자주 참조되는 정보만 간결하게 작성하는 것이 좋습니다. 200줄을 초과하는 상세한 내용은 별도의 주제별 파일로 분리해서 관리하는 것을 권장합니다. 예를 들어 디버깅 관련 상세 패턴은 debugging.md에, API 설계 규칙은 api-conventions.md에 작성하는 식입니다.
기능 제어
자동 메모리 기능의 사용을 다음과 같이 제어할 수 있습니다.
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 # 강제 비활성화
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=0 # 강제 활성화
CLAUDE.md 파일 관리
기본 개념
프로젝트에 대한 지침을 여러 파일로 분리해서 관리할 수 있습니다. 코드 스타일 선호도, 개인 도구 단축키 등을 정의할 때 사용합니다.
디렉토리 구조
your-project/
├── .claude/
│ ├── CLAUDE.md
│ └── rules/
│ ├── code-style.md # 코드 스타일 가이드라인
│ ├── testing.md # 테스팅 규칙
│ └── security.md # 보안 요구사항
주제별로 모듈화된 프로젝트 지침을 /rules 폴더에 모아서 관리할 수 있습니다.
CLAUDE.local.md
개인용 설정 파일로 git에서 자동으로 제외되며, 프로젝트별 개인 선호사항을 담을 때 사용합니다.
ref:
