[Claude Code 입문 E22] 메모리 시스템: Auto memory, MEMORY.md, /memory 명령, /compact 재주입

Claude Code의 메모리 시스템 전체를 정리합니다. 사용자가 직접 쓰는 CLAUDE.md와 Claude가 스스로 쓰는 Auto memory가 어떻게 다른지, 어디에 저장되고 어디까지 로드되는지, 켜고 끄고 옮기는 방법과 /compact 이후 동작, 서브에이전트 persistent memory까지 다룹니다. 📌 다루는 내용 - 두 가지 메모리 비교: CLAUDE.md(사용자 작성, 전체 로드) vs Auto memory(Claude 작성, 200줄/25KB 로드) - Auto memory 저장 구조: ~/.claude/projects/PROJECT/memory/ + MEMORY.md 인덱스 + 토픽 파일 - 활성화/비활성화 3가지 방법: /memory 토글, autoMemoryEnabled 설정, CLAUDE_CODE_DISABLE_AUTO_MEMORY 환경 변수 - 저장 위치 바꾸기: autoMemoryDirectory (user/local/policy만 허용, project settings 거부) - /memory 명령어 기능: 로드된 파일 확인, 토글, 폴더 열기, 파일 편집 - "기억해줘" vs "CLAUDE.md에 추가해줘" — 팀 공유가 필요한지로 판단 - /compact 이후: 프로젝트 루트 CLAUDE.md·auto memory 재주입, 중첩/경로 스코프는 로스트 - 서브에이전트 persistent memory: memory: user/project/local 필드 - 메모리 감사와 편집: 민감 정보 점검, 잘못된 학습 수정, 디렉토리 초기화 - 트러블슈팅: 원치 않는 저장, 동작 안 할 때, 팀 공유 우회 📌 환경 정보 - Claude Code v2.1.59 이상 (Auto memory 지원) - claude --version으로 버전 확인 - ~/.claude/projects/ 쓰기 권한 📌 챕터 0:00 두 가지 메모리: CLAUDE.md vs Auto memory 1:30 Auto memory가 무엇을 기억하는가 2:51 저장 구조: MEMORY.md 인덱스와 토픽 파일 3:22 200줄/25KB 로드 한계 4:23 활성화/비활성화 3가지 방법 5:16 저장 위치 바꾸기 (autoMemoryDirectory) 6:25 /memory 명령어 기능 7:21 "기억해줘" vs "CLAUDE.md에 추가해줘" 8:32 /compact 이후 무엇이 살아남는가 9:42 서브에이전트 persistent memory 12:20 트러블슈팅과 정리 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-22-memory-system - 공식 문서 Memory: https://code.claude.com/docs/en/memory - Commands reference: https://code.claude.com/docs/en/commands - Context window: https://code.claude.com/docs/en/context-window - Subagents: https://code.claude.com/docs/en/sub-agents - Environment variables: https://code.claude.com/docs/en/env-vars #ClaudeCode #AutoMemory #MEMORYmd