MEMORY.md

• CLAUDE.md — 사용자가 Claude에게 무엇을 할지 알려주는 곳
• MEMORY.md — Claude가 스스로를 위해 노트를 기록하는 곳

MEMORY.md란?

• Claude가 저장한 모든 내용의 인덱스 역할
• 기존에는 CLAUDE.md를 통해 세션 간에 공유할 정보 작성
• 별도 설치 X, 업데이트 시 기본값(버전 2.1.76 이상)
• 어떤 내용을 향후 세션을 위해 저장할지 Claude 스스로 결정
• 각 세션이 시작될 때 자동으로 로드되는 유일한 메모리 파일

MEMORY.md 저장 정보

• 프로젝트 패턴 — 빌드 명령어, 테스트 워크플로우, 코드베이스의 구성 방식 등
• 디버깅 인사이트 — 까다로운 문제의 해결책, 특정 에러의 근본 원인 등
• 아키텍처 노트 — 중요한 파일, 모듈 간 관계, 핵심 추상화 등
• 사용자의 선호 사항 — 커뮤니케이션 스타일, 워크플로우 습관, 도구 선택 등
  +)
• 잘 동작했던 명령어
• 실패했던 명령어
• 이전 세션에서 얻은 유용한 노트

MEMORY.md 저장 위치

~/.claude/projects/<project>/memory/  
├── MEMORY.md # 각 세션 시작 시 로드되는 메인 인덱스  
├── debugging.md # 디버깅 이력과 반복되는 이슈에 대한 노트  
└── ... # Claude가 필요할 때 만드는 다른 주제 파일들

• <project> 경로는 Git 저장소의 루트 기준
• 같은 저장소 내 모든 하위 디렉터리는 같은 메모리 위치 공유
• Git 저장소 바깥에서 작업할 때는 Claude가 현재 작업 디렉터리를 대신 사용
• Git worktree를 사용하는 경우, 각 worktree는 별도의 메모리 디렉터리를 가짐

MEMORY.md 유의 사항

• 새 세션이 시작될 때 MEMORY.md의 처음 200줄까지만 시스템 프롬프트에 로드
• MEMORY.md가 너무 길어지는 경우 내용을 debugging.md나 api-conventions.md 같은 별도의 주제 파일로 옮김
• 메인 파일은 짧고 유용하게 유지

세션 워크플로우

• 조직의 정책(존재하는 경우) 로드
• 팀이 공유하는 지시 사항이 담긴 프로젝트 수준 CLAUDE.md 로드
• 개인 ~/.claude/CLAUDE.md 선호 사항 로드
• Claude가 저장한 노트가 담긴 MEMORY.md의 처음 200줄 로드
• 특정 주제에 관련한 내용이 필요해지면 관련 파일 ex) debugging.md 읽음
• 새로운 무언가를 알게 되면 MEMORY.md나 주제 파일 업데이트

/memory

Options

1. User Memory
   - Saved in ~/.claude/CLAUDE.md
   • 개인용 메모리 파일
   • 선호하는 코딩 스타일, 즐겨 쓰는 도구 등
2. Project Memory
   • Checked in at ./CLAUDE.md
   • 프로젝트 공유 파일
   • 코딩 표준, 아키텍처 결정, 공통 워크 플로우 등
3. Open Auto-Memory Folder
   • MEMORY.md와 세션 전반에 걸쳐 만들어진 주제 파일들

참고 아티클

# Claude Code — MEMORY.md: 알아야 할 모든 것과 시작하는 법