Cmd. /memory
CLAUDE.md 메모리 파일을 편집하고, 자동 메모리(auto-memory)를 켜고 끄며, 자동 메모리 항목을 확인하는 명령
핵심 요약
CLAUDE.md·auto memory 관리- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
CLAUDE.md·auto memory 관리
/memory사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/memory세션 안에서 인자 없이 단독으로 실행합니다. 자유 텍스트 인자를 받지 않습니다.
CLAUDE.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 | 컨텍스트 사용량 시각화(메모리 부하 포함) | 컨텍스트 점유 원인 파악 |
실행 결과와 유지 범위
CLAUDE.md와 자동 메모리를 관리합니다. 저장한 프로젝트 지침은 이후 세션의 맥락에도 영향을 줄 수 있습니다.
공식 문서의 설명은 다음과 같습니다.
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를 찾지 못하거나 지시문이 안 먹힐 때 어떤 파일이 실제로 로드됐는지 확인하는 용도로도 자주 씁니다.
주의사항
자동 메모리는 autoMemoryEnabled: false 또는 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1로 끌 수 있습니다. 사용자 지침인 CLAUDE.md와 자동 메모리의 역할을 구분합니다.
/memory는 자유 텍스트 인자를 받지 않습니다. 기억시킬 내용은 일반 대화로 요청하세요.- 자동 메모리는 기본값으로 켜져 있으며 v2.1.59 이상에서만 동작합니다.
- 자동 메모리는 머신 로컬
~/.claude/projects/<project>/memory/에 저장됩니다.<project>는 git 저장소를 기준으로 정해지므로 같은 저장소의 모든 worktree·하위 디렉터리가 자동 메모리 디렉터리 하나를 함께 씁니다. MEMORY.md는 자동 메모리의 인덱스로, 세션을 시작할 때마다 앞 200줄(또는 25KB)까지만 로드됩니다. 그 뒤는 시작 시점에 읽지 않고 필요할 때 온디맨드로 읽습니다.- CLAUDE.md/자동 메모리는 강제 설정이 아니라 컨텍스트입니다. 반드시 차단해야 하는 동작은 PreToolUse 훅으로 처리하세요.
- 민감 정보는 메모리에 남기지 않도록 정책화하고, 오래된 기억은 정기적으로 재검토하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록