Cmd. /memory
CLAUDE.md 메모리 파일을 편집하고, 자동 메모리(auto-memory)를 켜고 끄며, 자동 메모리 항목을 확인하는 명령
핵심 요약
/memory는 CLAUDE.md 메모리 파일 편집, 자동 메모리 토글, 자동 메모리 항목 확인을 한 화면에서 처리하는 명령이다.- CLAUDE.md는 사용자가 직접 쓰는 영구 지시문이고, 자동 메모리는 Claude가 교정·선호를 학습해 스스로 작성하는 내용으로 서로 보완한다.
- 자동 메모리는 기본 켜져 있으며 v2.1.59 이상에서만 동작하고,
autoMemoryEnabled: false나CLAUDE_CODE_DISABLE_AUTO_MEMORY=1로 끌 수 있다. - 자동 메모리는 머신 로컬
~/.claude/projects/<project>/memory/에 저장되고, 같은 저장소의 worktree·하위 디렉터리는 디렉터리 하나를 함께 쓴다. - MEMORY.md 인덱스는 세션 시작 시 앞 200줄(또는 25KB)까지만 로드되고, 메모리는 강제가 아닌 컨텍스트이므로 반드시 막을 동작은 PreToolUse 훅으로 처리한다.
명령어 원본 선언
/memory공식 설명 요약
공식 문서의 설명은 다음과 같습니다.
Edit
CLAUDE.mdmemory files, enable or disable auto-memory, and view auto-memory entries.
/memory는 다음 세 가지를 한 화면에서 처리합니다.
- CLAUDE.md 메모리 파일 편집: 현재 세션에 로드된
CLAUDE.md,CLAUDE.local.md,.claude/rules/파일 목록을 보여주고, 항목을 선택하면 편집기로 열어줍니다. - 자동 메모리(auto-memory) 토글: 자동 메모리를 켜거나 끌 수 있는 토글을 제공합니다.
- 자동 메모리 항목 확인: 자동 메모리 폴더를 여는 링크를 제공합니다. Claude가 스스로 저장한 메모리 항목을 직접 확인·편집·삭제할 수 있습니다.
Claude Code에는 서로 보완하는 두 가지 메모리 시스템이 있으며, /memory는 두 가지를 모두 관리합니다.
- CLAUDE.md 파일: 사용자가 직접 작성하는 영구 지시문(코딩 표준, 워크플로, 프로젝트 구조 등).
- 자동 메모리: Claude가 사용자의 교정·선호를 바탕으로 스스로 작성하는 학습 내용(빌드 명령, 디버깅 인사이트, 작업 습관 등).
CLAUDE.md를 찾지 못하거나 지시문이 안 먹힐 때 어떤 파일이 실제로 로드됐는지 확인하는 용도로도 자주 씁니다.
최소 지원 버전
/memory명령 자체는 내장 명령으로, 공식 명령어 표에 별도의 최소 버전 표기가 없습니다.- 다만 자동 메모리(auto-memory) 기능은 Claude Code v2.1.59 이상이 필요합니다.
claude --version으로 버전을 확인할 수 있습니다.
사용법
세션 안에서 인자 없이 단독으로 실행합니다. 자유 텍스트 인자를 받지 않습니다.
/memoryCLAUDE.md에 기억시키거나 자동 메모리에 저장하려는 내용은 명령 인자가 아니라 일반 대화로 요청합니다.
항상 pnpm을 쓰고 npm은 쓰지 마. (→ Claude가 자동 메모리에 저장)
이 내용을 CLAUDE.md에 추가해줘. (→ CLAUDE.md에 기록)자동 메모리를 설정 파일로 끄려면 autoMemoryEnabled를 사용합니다.
{
"autoMemoryEnabled": false
}환경 변수로 비활성화할 수도 있습니다.
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1좋은 사용 예
- 현재 세션에 로드된
CLAUDE.md/CLAUDE.local.md/규칙 파일 목록 점검 (지시문이 안 먹힐 때 디버깅) - 자동 메모리 켜기/끄기 토글
- 자동 메모리 폴더를 열어 Claude가 저장한 항목을 검토·수정·삭제
- 메모리 파일을 편집기로 바로 열어 팀 규칙·코드 스타일·빌드 명령 갱신
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/memory | CLAUDE.md 편집 + 자동 메모리 관리 | 영구 지시문/자동 메모리 점검·관리 |
/init | CLAUDE.md 초기 생성 | 저장소 첫 세션에서 가이드 만들기 |
/compact | 현재 대화 요약으로 컨텍스트 절약 | 토큰/컨텍스트 정리 |
/context | 컨텍스트 사용량 시각화(메모리 부하 포함) | 컨텍스트 점유 원인 파악 |
활용 사례
- 저장소 첫 세션에서
/init으로 CLAUDE.md를 만든 뒤/memory로 다듬기 - 지시문이 적용되지 않을 때
/memory로 실제 로드된 메모리 파일 확인 - 자동 메모리가 무엇을 저장했는지 폴더를 열어 감사(audit)하고 불필요한 항목 정리
- 민감 정보가 자동 메모리에 남지 않도록 토글을 끄거나 항목을 삭제
주의사항
/memory는 자유 텍스트 인자를 받지 않습니다. 기억시킬 내용은 일반 대화로 요청하세요.- 자동 메모리는 기본값으로 켜져 있으며 v2.1.59 이상에서만 동작합니다.
- 자동 메모리는 머신 로컬
~/.claude/projects/<project>/memory/에 저장됩니다.<project>는 git 저장소를 기준으로 정해지므로 같은 저장소의 모든 worktree·하위 디렉터리가 자동 메모리 디렉터리 하나를 함께 씁니다. MEMORY.md는 자동 메모리의 인덱스로, 세션을 시작할 때마다 앞 200줄(또는 25KB)까지만 로드됩니다. 그 뒤는 시작 시점에 읽지 않고 필요할 때 온디맨드로 읽습니다.- CLAUDE.md/자동 메모리는 강제 설정이 아니라 컨텍스트입니다. 반드시 차단해야 하는 동작은 PreToolUse 훅으로 처리하세요.
- 민감 정보는 메모리에 남기지 않도록 정책화하고, 오래된 기억은 정기적으로 재검토하세요.
출처
- Claude Code Docs — Commands: https://code.claude.com/docs/en/commands
- Claude Code Docs — How Claude remembers your project (Memory): https://code.claude.com/docs/en/memory