자동 메모리

자동 메모리를 통해 Claude는 아무것도 작성하지 않고도 세션 간에 지식을 축적할 수 있습니다. Claude는 작업할 때 자신을 위해 노트를 저장합니다: 빌드 명령, 디버깅 인사이트, 아키텍처 노트, 코드 스타일 선호도 및 워크플로우 습관. Claude는 모든 세션마다 뭔가를 저장하지 않습니다. 정보가 향후 대화에서 유용할지 여부에 따라 기억할 가치가 있는지 결정합니다.

자동 메모리는 Claude Code v2.1.59 이상이 필요합니다. claude --version으로 버전을 확인합니다.

Subagent도 자신의 자동 메모리를 유지할 수 있습니다. 자세한 내용은 subagent 구성을 참조하세요.

자동 메모리

자동 메모리는 수정 및 선호도에 따라 Claude가 자신을 위해 작성하는 노트입니다. 저장소당 하나의 메모리 디렉토리를 사용하며, 같은 저장소의 작업 트리 전체에서 공유됩니다. 세션 시작 시 MEMORY.md의 처음 200줄 또는 25KB 중 먼저 도달하는 부분이 로드됩니다.

자동 메모리 활성화 또는 비활성화

자동 메모리는 기본적으로 켜져 있습니다. 토글하려면 세션에서 /memory를 열고 자동 메모리 토글을 사용하거나 프로젝트 설정에서 autoMemoryEnabled를 설정합니다:

{
  "autoMemoryEnabled": false
}

환경 변수를 통해 자동 메모리를 비활성화하려면 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1을 설정합니다.

저장소 위치

각 프로젝트는 ~/.claude/projects/<project>/memory/에서 자신의 메모리 디렉토리를 가집니다. <project> 경로는 git 저장소에서 파생되므로 동일한 저장소 내의 모든 worktree 및 하위 디렉토리는 하나의 자동 메모리 디렉토리를 공유합니다. git 저장소 외부에서는 프로젝트 루트가 대신 사용됩니다.

자동 메모리를 다른 위치에 저장하려면 사용자 설정의 ~/.claude/settings.json에서 autoMemoryDirectory를 설정합니다:

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

값은 절대 경로이거나 ~/로 시작해야 합니다. 이 설정은 정책 및 사용자 설정과 --settings 플래그에서 허용됩니다. 프로젝트 디렉토리 내에 있는 두 파일 모두 복제된 저장소가 자동 메모리 쓰기를 민감한 위치로 리디렉션하는 것을 방지하기 위해 프로젝트 또는 로컬 설정에서는 허용되지 않습니다.

디렉토리에는 MEMORY.md 진입점과 선택적 주제 파일이 포함됩니다:

~/.claude/projects/<project>/memory/
├── MEMORY.md          # 간결한 인덱스, 모든 세션에 로드됨
├── debugging.md       # 디버깅 패턴에 대한 자세한 노트
├── api-conventions.md # API 설계 결정
└── ...                # Claude가 만드는 다른 주제 파일

MEMORY.md는 메모리 디렉토리의 인덱스 역할을 합니다. Claude는 세션 전체에서 이 디렉토리의 파일을 읽고 쓰며 MEMORY.md를 사용하여 저장된 내용을 추적합니다.

자동 메모리는 컴퓨터 로컬입니다. 동일한 git 저장소 내의 모든 worktree 및 하위 디렉토리는 하나의 자동 메모리 디렉토리를 공유합니다. 파일은 컴퓨터 또는 클라우드 환경 간에 공유되지 않습니다.

작동 방식

MEMORY.md의 처음 200줄 또는 처음 25KB(둘 중 먼저 오는 것)는 모든 대화의 시작 시 로드됩니다. 해당 임계값을 초과하는 콘텐츠는 세션 시작 시 로드되지 않습니다. Claude는 자세한 노트를 별도의 주제 파일로 이동하여 MEMORY.md를 간결하게 유지합니다.

이 제한은 MEMORY.md에만 적용됩니다.

debugging.md 또는 patterns.md와 같은 주제 파일은 시작 시 로드되지 않습니다. Claude는 필요한 정보가 필요할 때 표준 파일 도구를 사용하여 필요에 따라 읽습니다.

Claude는 세션 중에 메모리 파일을 읽고 씁니다. Claude Code 인터페이스에서 "Writing memory" 또는 "Recalled memory"를 보면 Claude가 ~/.claude/projects/<project>/memory/에서 활발히 업데이트하거나 읽고 있습니다.

메모리 감사 및 편집

자동 메모리 파일은 언제든지 편집하거나 삭제할 수 있는 일반 마크다운입니다. /memory를 실행하고 자동 메모리 폴더를 선택하여 세션 내에서 Claude가 저장한 내용을 찾아봅니다.

Claude에게 "항상 npm이 아닌 pnpm을 사용합니다" 또는 "API 테스트에 로컬 Redis 인스턴스가 필요하다는 것을 기억합니다"와 같이 뭔가를 기억하도록 요청하면 Claude는 자동 메모리에 저장합니다.

메모리 문제 해결

자동 메모리가 저장한 내용을 모릅니다

/memory를 실행하고 자동 메모리 폴더를 선택하여 Claude가 저장한 내용을 찾아봅니다. 모든 것이 읽고, 편집하거나 삭제할 수 있는 일반 마크다운입니다.