Memory tool이 해결하는 문제
매 세션 시작 시 같은 컨텍스트를 다시 설명해야 하는 비효율이 있습니다. Memory tool은 사용자·프로젝트의 잘 변하지 않는 사실과 반복 피드백을 영구 저장하여, 다음 세션에서 자동 복원합니다.
저장 위치
~/.claude/projects/<sanitized-cwd>/memory/
├── MEMORY.md # 인덱스 (모든 메모리의 1줄 포인터)
├── feedback_*.md # 피드백 메모리
├── user_*.md # 사용자 정보
├── project_*.md # 프로젝트 사실
└── reference_*.md # 외부 시스템 참조MEMORY.md는 항상 컨텍스트에 로드되는 인덱스입니다. 본문 파일은 필요 시점에 참조됩니다.
자동 저장되는 정보
사용자 (user)
역할, 선호, 책임 범위, 보유 지식
- 예: “데이터 사이언티스트, 현재 관측성/로깅에 집중”
피드백 (feedback)
교정·확인 내역과 그 이유
- 예: “통합 테스트는 mock DB 대신 실제 DB 사용 — 작년 마이그레이션 실패 사례”
프로젝트 (project)
목표·결정·일정 (절대 날짜로 변환해 저장)
- 예: “2026-03-05부터 모바일 릴리스 컷을 위한 머지 프리즈”
참조 (reference)
외부 시스템과 그 용도
- 예: “파이프라인 버그는 Linear의 INGEST 프로젝트에서 추적”
저장하지 않는 정보
- 코드에서 알 수 있는 패턴·구조·파일 경로
- git log/blame으로 알 수 있는 변경 이력
- 디버깅 해결책 (코드와 커밋 메시지에 남음)
- 일시적·세션 한정 작업 상태
직접 추가·삭제
이 결정 기억해줘: 결제 프로세서로 Stripe 사용. PayPal은 예전에 검토했지만 한국 법인 처리 한계로 제외.Claude가 적절한 메모리 파일로 저장합니다.
Stripe 결정 메모리 삭제해줘해당 메모리를 찾아 제거합니다.
또는 직접 디렉토리에서 .md 파일을 편집·삭제할 수 있습니다.
메모리 확인
/memory현재 로드된 메모리 상태를 보여줍니다. 비활성화하고 싶으면 settings.json의 autoMemoryEnabled: false로 설정합니다.
좋은 메모리의 특징
- 비명시적 사실 — 코드만으로 알 수 없는 결정·배경
- 이유 포함 — “왜 그렇게 정했는지”가 같이 적혀 있음
- 절대 날짜 — “내일”, “다음 주” 대신
2026-05-15 - 간결 — 인덱스 1줄 + 본문 짧은 단락
활용 패턴
팀 표준 기록
“우리 팀은 PR 머지 전에 항상 Plan mode로 검토” 같은 규칙을 메모리에 두면, 새 작업마다 자동 적용됩니다.
사고 사후 기록
인시던트 후 “X 마이그레이션은 항상 Y 도구로 검증” 같은 교훈을 메모리에 저장하면 재발 방지에 도움.
외부 시스템 매핑
“디자인 리뷰는 Figma의 ‘Design QA’ 채널에서” 같은 매핑을 저장해두면 Claude가 관련 작업 시 바로 안내.
다음 단계
- claude-mem — 더 적극적인 세션 간 메모리 압축
- Claude Code Setup — 프로젝트 분석 후 Memory·Skill·Hook 자동 추천
- CLAUDE.md 잘 쓰는 법 — 정적 컨텍스트(CLAUDE.md)와 동적 메모리의 역할 분리