Memory tool 시작하기

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)와 동적 메모리의 역할 분리