Claude Code, 세션 간 기억 유지하는 Auto Memory 기능 공개

Claude Code(v2.1.59 이상)에 도입된 Auto Memory는 사용자가 대화 중 내린 지시사항(예: 특정 패키지 사용 강제, 스타일 교정 등)을 저장하고 다음 세션에서 이를 재로드하는 기능이다.

주요 특징 및 작동 방식:

• CLAUDE.md와의 차이: CLAUDE.md는 프로젝트 전용 규칙을 담는 파일인 반면, Auto Memory는 Claude가 학습한 내용을 스스로 기록하는 별도의 메모리 시스템이다.
• 저장 위치: 프로젝트 폴더 내의 .claude/가 아닌, 사용자의 홈 디렉토리(~/.claude/projects/<project-name>/memory/)에 저장된다.
• 효율적인 컨텍스트 관리: MEMORY.md 인덱스 파일의 상위 200행(약 25KB)만 세션 로드 시 사용하며, 세부 주제 파일은 필요할 때만 읽어들이는 Lazy Loading 방식을 채택하여 컨텍스트 팽창을 방지한다.
• 제어 명령어: /memory 명령어로 메모리 상태 확인 및 토글이 가능하며, "remember: [내용]" 또는 "forget: [내용]"과 같은 자연어로 메모리를 관리할 수 있다.
• 로컬 저장: 메모리는 머신 로컬에 저장되므로 다른 기기나 클라우드와는 동기화되지 않는다.