AI/Claude

Claude Code Auto Memory vs Auto Dream 정리 : AI가 잠자면서 기억을 정리한다? Auto Dream 기능의 진실

안녕하세요! 갓대희 입니다.

"Claude Code Memory 2.0"이라는 표현이 돌고 있다. "Auto Dream"이라는 기능이 나왔고, AI가 잠자면서 기억을 정리한다는 것이다.

결론부터 말하면: "Memory 2.0"은 공식 용어가 아니고, Auto Dream은 공식 문서에 없다. 하지만 코드 안에는 실제로 존재한다.

Claude Code의 /memory 메뉴에 "Auto-dream: off"라는 토글이 표시된다. 내부 시스템 프롬프트에 "You are performing a dream — a reflective pass over your memory files"라는 문구가 있다.

일부 사용자에게는 이미 활성화되어 "last ran 1d ago"라고 표시된다 (GitHub #38461 커뮤니티 리포트 기준, 공식 문서 미기재).

하지만 자동 실행이 활성화된 사용자를 포함해 모든 사용자에서 /dream 수동 명령어는 "Unknown skill"을 반환한다 — 자동 실행과 수동 명령어는 별개로 구현되어 있다 (v2.1.84, #39135, 2026-03-26 확인).

이 글에서는 공식 문서와 소스 코드 분석을 기반으로, 현재 실제로 사용할 수 있는 메모리 기능과 아직 사용할 수 없는 Auto Dream을 정확히 구분한다. 그리고 Auto Dream이 없어도 메모리를 효과적으로 관리하는 실전 방법을 정리해보려 한다.

팩트체크: "Memory 2.0" 소문 vs 실체
- 왜 이런 혼동이 생겼는가
Auto Memory — 지금 사용할 수 있는 기능
- 작동 원리
- 저장 구조와 200줄 제한
- 뭘 기억하고, 뭘 안 기억하는가
- 설정 및 관리
Context Compaction: 컨텍스트 압축
- 자동 압축 동작
- 수동 제어
- CLAUDE.md와의 관계
Auto Dream — 코드에는 있지만 아직 잠겨 있다
- UI에 보이는 것
- 소스 코드가 말해주는 것
- 설계 의도: "쓰고 잊기" 문제의 해결
실전 튜토리얼: Auto Dream 없이 메모리 관리하기
실전 시나리오
CLAUDE.md vs Auto Memory vs Auto Dream 비교
이론적 배경: Sleep-time Compute
커뮤니티 반응: 기대와 우려
제한사항 및 주의사항
트러블슈팅 Q&A
결론: 언제 쓸 수 있을까

한눈에 보는 현재 상태 (2026-03-26 기준)

항목	상태	출처
Auto Memory	사용 가능 (v2.1.59+)	공식 문서
Auto Dream	자동 실행: 일부 활성화 · 수동 /dream: 전체 미작동 (v2.1.84, #39135)	소스 분석
"Memory 2.0"	비공식 용어	공식 문서/체인지로그에 없음
`/dream` 명령어	자동 실행 활성화 사용자 포함 모든 사용자에서 "unknown skill" (v2.1.84, #39135)	`/memory`에서 "Auto-dream: on · /dream to run" 안내되나, 실행 시 "unknown skill" — 자동 실행과 수동 명령어는 별개 구현

1. 팩트체크: "Memory 2.0" 소문 vs 실체

X(트위터)와 한국 커뮤니티에서 퍼지고 있는 주장들을 공식 문서와 대조한다.

커뮤니티 주장	판정	근거
"Memory 2.0이 나왔다"	과장	"Memory 2.0"은 공식 문서, 체인지로그(v2.1.84까지), 블로그 어디에도 없다. 커뮤니티가 만든 마케팅 용어.
"Auto Dream이라는 새 기능이 있다"	맞지만 미완성	`/memory` UI에 "Auto-dream" 토글이 존재하고, 내부 시스템 프롬프트에 4단계 정리 프로세스가 구현되어 있다. 일부 사용자에게는 활성화됨(GitHub #38461). 하지만 `/dream` 명령어가 동작하지 않는 등 버그가 있다.
"`/memory`에서 autodream on으로 바꾸면 된다"	사람마다 다름	서버 사이드 플래그(`tengu_onyx_plover`)로 제어된다. 일부 사용자에게는 토글이 활성화되어 있고(GitHub #38461 댓글에서 "Auto-dream: on · last ran 1d ago" 확인), 다른 사용자에게는 토글이 잠겨 있다. 점진적 롤아웃 중인 것으로 보인다.
"`/dream` 명령어로 실행한다"	틀림	`/dream`은 Claude Code의 빌트인 커맨드가 아니다. 실행하면 "unknown skill"이 표시된다. Auto Dream 자동 실행이 이미 켜진 사용자조차 동일하다 (v2.1.84, GitHub #39135, 2026-03-26).
"'run your autodream'이라고 하면 dreaming이 뜬다"	오해 소지	이것은 Claude에게 "메모리 파일을 정리해달라"고 자연어로 요청하는 것이다. Claude가 memory 폴더의 파일들을 읽고 정리하는 것은 기존 Auto Memory 기능의 범위 내이다. Auto Dream이라는 별도 기능이 동작하는 것이 아니다.
"AI가 잠자면서 기억을 정리한다"	비유로서 맞음	Auto Dream의 설계 의도가 정확히 이것이다. 다만 아직 동작하지 않는다.

핵심: "run your autodream" ≠ Auto Dream 기능

Claude에게 "메모리를 정리해줘"라고 요청하면, Claude는 ~/.claude/projects/*/memory/ 디렉토리의 파일들을 읽고 수정한다. 이것은 Auto Dream 기능이 아니라, Claude가 평소에도 할 수 있는 일반적인 파일 편집 작업이다. "dreaming"이라는 상태 표시는 Claude가 메모리 파일을 읽고 있을 때 나타나는 "Reading memory" 또는 "Writing memory" 상태와 동일한 맥락이다.

왜 이런 혼동이 생겼는가

2026년 3월 셋째 주, 여러 일이 동시에 일어났다.

Reddit에서 최초 발견 — 누군가가 /memory 메뉴에서 "Auto-dream: off" 토글을 발견하고 공유했다.
X 확산 시작 — @kr0der(Anthony)가 "just found out Claude Code has a new (unreleased?) feature called 'Auto-dream'"이라고 트윗. "unreleased?"에 물음표를 붙였다.
바이럴 확산 — @om_patel5가 상세 스레드를 작성하여 38K 뷰를 기록 (2026-03-26 확인 기준). @JeremyNguyenPhD, @rohanpaul_ai, @maksym_andr 등이 증폭.
심층 분석 — DEV Community에 akari_iku의 소스 분석 기사 게시(2026-03-24). Threads에서 @sakeeb.rahman이 4단계 프로세스와 Sleep-time Compute 논문 연결을 상세 분석.
"Memory 2.0" 명명 — YouTube 크리에이터 Nate Herk가 AI Automation Society에 "Claude Code Just Dropped Memory 2.0"이라는 제목으로 영상 게시. "Memory 2.0"은 이 영상에서 만들어진 마케팅 용어다.
한국 전파 — "unreleased"가 빠지고 "나왔다"로 바뀌어 확산. 한국 커뮤니티(GeekNews, GPTers)에서는 Auto Memory에 대한 논의는 있으나, Auto Dream 전용 한국어 심층 분석은 2026-03-26 기준 검색에서 찾기 어려웠다.

교훈

AI 도구 관련 정보는 전파 속도가 빠르고, "unreleased"와 "released"의 차이가 생략되기 쉽다. 공식 문서(docs.anthropic.com)와 체인지로그를 직접 확인하는 것이 가장 정확하다.

2. Auto Memory — 지금 사용할 수 있는 기능

"Memory 2.0"이라고 불리는 것의 대부분은 사실 Auto Memory다. v2.1.59(2026-02-26)에서 도입되었고, 현재 정식으로 사용 가능하다. (출처: 공식 문서)

작동 원리

Auto Memory는 Claude가 작업하면서 유용한 정보를 스스로 판단해서 디스크에 저장하는 기능이다. 매 세션마다 저장하는 것은 아니다. 미래 대화에서 유용할 것이라고 판단되는 정보만 선별적으로 저장한다.

공식 문서의 표현을 그대로 옮기면:

"Claude saves notes for itself as it works: build commands, debugging insights, architecture notes, code style preferences, and workflow habits. Claude doesn't save something every session. It decides what's worth remembering based on whether the information would be useful in a future conversation."

(Claude는 작업을 진행하면서 스스로 참고할 메모를 남깁니다. 예를 들면 빌드 명령어, 디버깅 과정에서 얻은 인사이트, 아키텍처 관련 메모, 코드 스타일 선호, 작업 습관 등이 여기에 포함됩니다. 다만 모든 세션마다 항상 무언가를 저장하는 것은 아닙니다. 나중의 대화나 작업에서 도움이 될 만한 정보인지 판단해서, 기억해둘 가치가 있는 내용만 선택적으로 저장합니다.)

— Anthropic 공식 문서

저장 구조와 200줄 제한

~/.claude/projects/<project>/memory/
├── MEMORY.md              # 핵심 인덱스 (매 세션 시작 시 자동 로딩)
├── debugging.md           # 디버깅 패턴 상세
├── api-conventions.md     # API 설계 결정사항
└── ...                    # Claude가 필요에 따라 생성하는 토픽 파일들

200줄 제한에 주의

MEMORY.md의 첫 200줄만 세션 시작 시 로딩된다. (체인지로그 v2.1.83 기준 25KB 트렁케이션 캡도 적용.)
200줄을 넘는 내용은 무시된다. Claude는 이를 알기 때문에, 상세한 내용은 별도 토픽 파일로 분리하고 MEMORY.md에는 인덱스만 유지한다. 토픽 파일은 필요할 때만 읽는다.

<project> 경로는 git 리포지토리에서 파생된다. git repo 외부에서는 현재 project root가 기준이 된다. 따라서 같은 머신에서 같은 리포의 모든 워크트리와 하위 디렉토리가 하나의 auto memory 디렉토리를 공유한다. 다만 다른 머신에서 같은 리포를 클론해도 메모리 파일은 공유되지 않는다 — Auto Memory는 로컬 디스크 전용이다. (출처: 공식 문서 Storage location)

뭘 기억하고, 뭘 안 기억하는가

기억하는 것	기억하지 않는 것
빌드 명령어, 테스트 실행 방법	일시적인 대화 컨텍스트
디버깅 인사이트, 해결 패턴	코드에서 직접 읽을 수 있는 정보 (구조, 함수명 등)
아키텍처 메모, 설계 결정 이유	git 히스토리에서 확인 가능한 정보
코드 스타일 선호도	CLAUDE.md에 이미 명시된 규칙
워크플로우 습관, 사용자 교정 내용	매 세션의 사소한 시행착오 내역

설정 및 관리

Auto Memory는 기본적으로 켜져 있다. 끄는 방법은 3가지다.

# 방법 1: 세션 내에서 토글
/memory
# → "Auto-memory: on" 옆의 토글로 끄기

# 방법 2: 환경변수로 비활성화
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

# 방법 3: 설정 파일로 비활성화
# ~/.claude/settings.json 또는 .claude/settings.json
{
  "autoMemoryEnabled": false
}

# 일회성 비활성화 (스크립트/CI에서, v2.1.81+)
# 주의: --bare는 메모리만 끄는 것이 아니라 hooks, LSP, 플러그인,
# CLAUDE.md 자동탐색 등도 모두 비활성화하는 "최소 모드"다.
# 메모리만 끄려면 위의 환경변수 방법을 사용한다.
claude --bare -p "one-shot task"

메모리 저장 경로를 변경하고 싶으면 autoMemoryDirectory를 설정한다 (v2.1.74+).

이 설정은 보안상 정책(managed policy), 사용자, 로컬 설정에서만 허용되고, 프로젝트 설정(.claude/settings.json)에서는 사용할 수 없다. (출처: 공식 문서)

// ~/.claude/settings.json (사용자 설정)
{
  "autoMemoryDirectory": "~/Library/Mobile Documents/com~apple~CloudDocs/claude-memory"
}

위 예시처럼 iCloud Drive나 Dropbox 경로를 지정하면 여러 머신에서 파일을 공유할 수 있지만, 이것은 비공식 우회이다.

공식 문서는 "Auto memory is machine-local"이라고 명시하며, 이 방법의 동작을 보장하지 않는다.

3. Context Compaction: 컨텍스트 압축

자동 압축 동작

Context Compaction은 "Auto Dream"의 나머지 절반이다. 세션 중 컨텍스트 윈도우가 한계에 가까워지면 자동으로 정리한다. 사용자가 직접 개입할 필요 없이 배경에서 동작한다.

구체적으로 무엇이 보존되고 무엇이 손실되는지가 중요하다.

보존되는 것	손실될 수 있는 것
CLAUDE.md 전체 (디스크에서 재로딩)	세션 초반의 상세 지시사항
사용자의 최근 요청	오래된 tool output (파일 읽기 결과 등)
핵심 코드 스니펫	시도했다 실패한 접근들의 상세 내역
세션 이름, Plan mode 상태	긴 대화에서 초반에 논의한 설계 결정

압축 과정은 다음과 같다.

컨텍스트 윈도우가 한계에 도달
  ↓
1단계: 오래된 tool output 삭제 (코드 읽기 결과 등)
  ↓
2단계: 대화 요약 (사용자 요청과 핵심 코드 스니펫은 보존)
  ↓
3단계: CLAUDE.md를 디스크에서 다시 읽어서 재주입
  ↓
압축된 컨텍스트로 작업 계속

CLAUDE.md는 압축에서 살아남는다

이것이 핵심이다. /compact 후에 Claude는 CLAUDE.md를 디스크에서 다시 읽어서 컨텍스트에 재주입한다. 따라서 프로젝트 규칙과 지침은 압축 후에도 유지된다. 반면 세션 초반의 상세한 지시사항은 손실될 수 있다.

수동 제어

# 수동으로 컨텍스트 압축
/compact

# 특정 주제에 집중하여 압축 (나머지는 덜 중요하게 처리)
/compact focus on the API changes

# 현재 컨텍스트 사용량 확인
/context

CLAUDE.md에 "Compact Instructions" 섹션을 추가하면, 압축 시 어떤 내용을 우선 보존할지 제어할 수 있다.

CLAUDE.md와의 관계

"메모리가 나쁜 습관을 강화하면 어떻게 되나?" 좋은 질문이다.

답은 CLAUDE.md가 Auto Memory보다 우선한다는 것이다. CLAUDE.md는 사용자가 직접 작성하는 규칙이고, Auto Memory는 Claude가 스스로 학습한 내용이다. 충돌이 생기면 CLAUDE.md의 명시적 지침이 이긴다. 잘못된 기억이 쌓이고 있다면 /memory로 확인하고 수정/삭제할 수 있다.

4. Auto Dream — 코드에는 있지만 아직 잠겨 있다

여기서부터가 이 글의 핵심이다. Auto Dream은 "있지만 없는" 기능이다.

UI에 보이는 것

Claude Code에서 /memory를 실행하면 다음과 같은 메뉴가 표시된다.

Memory

# 자동 실행 미활성화 사용자:
    Auto-memory: on
    Auto-dream: off · never

# 자동 실행 활성화 사용자 (점진적 롤아웃 중):
    Auto-memory: on
    Auto-dream: on · never · /dream to run
    # "never"는 아직 한 번도 실행되지 않았다는 의미
    # "/dream to run"이 안내되지만, 실행하면 여전히 "unknown skill"

  > 1. User memory          Saved in ~/.claude/CLAUDE.md
    2. Project memory        Checked in at ./CLAUDE.md
    3. Open auto-memory folder

Auto Dream이 활성화된 사용자는 Auto-dream: on · never · /dream to run이 표시된다. UI는 /dream으로 수동 실행을 안내하지만, 이 명령어는 현재 구현되지 않아 실행하면 "unknown skill"이 반환된다 (v2.1.84, GitHub #39135, 2026-03-26). 자동 실행(background)과 수동 /dream 명령어는 별개로 구현 중이다. (출처: DEV Community, akari_iku, 2026-03-24, 소스 코드 분석 기반)

ex) 나의 경우도 아직까지 킨적이 없으니, 지금 한번 켜보도록 하겠다. 다만 이후에 적용되기까지엔 조건이 있다고 한다.

소스 코드가 말해주는 것

DEV Community의 akari_iku가 Claude Code 소스를 분석하여 밝혀낸 내용이다.

파라미터	기본값	의미
`enabled`	`false`	서버 사이드 플래그. 로컬 `settings.json`으로는 변경 불가
`minHours`	`24`	마지막 실행 후 최소 24시간 경과 필요. 하루 1회가 최대
`minSessions`	`5`	최소 5개 세션이 쌓여야 실행. 소량 메모리를 자주 정리하는 것을 방지

서버 사이드 플래그의 코드네임은 tengu_onyx_plover이다 (소스 코드 분석 기반, Anthropic 미공식 확인).

Anthropic이 서버에서 이 플래그를 켜야 동작한다. 실제로 일부 사용자에게는 이미 활성화되어 있다 — GitHub #38461의 댓글에서 "Auto-dream: on · last ran 1d ago · /dream to run"이 확인되었다.

내부 시스템 프롬프트: 4단계 정리 프로세스

Claude Code의 내부에서 추출된 것으로 알려진 Auto Dream 시스템 프롬프트는 다음과 같이 시작한다.

(출처: Piebald-AI/claude-code-system-prompts)

"You are performing a dream — a reflective pass over your memory files. Synthesize what you've learned recently into durable, well-organized memories so that future sessions can orient quickly."

(지금 당신은 일종의 dream 단계, 즉 자신의 메모리 파일을 다시 검토하고 반추하는 과정을 수행하고 있습니다. 최근에 얻은 학습 내용을 정리·통합해서, 이후의 세션들이 빠르게 상황을 이해할 수 있도록 오래 활용 가능한 구조적인 기억으로 정리하라는 뜻입니다.)

이 프롬프트에 따르면, Auto Dream은 4단계로 동작한다.

단계	이름	하는 일
1	Orient	현재 메모리 파일 목록 파악, 프로젝트 맥락 이해
2	Gather recent signal	최근 세션에서 학습한 내용 수집
3	Consolidate	중복 병합, 모순 해결, 상대 날짜를 절대 날짜로 변환
4	Prune and Index	불필요한 항목 삭제, MEMORY.md 인덱스 200줄 이내 유지

시스템 프롬프트의 출처 주의

위 시스템 프롬프트는 Piebald-AI가 Claude Code 바이너리에서 추출한 것으로 알려져 있다. Anthropic이 공식적으로 공개한 것이 아니므로, 실제 구현과 다를 수 있다. 다만 이 4단계 구조는 DEV Community 기사, claudefa.st, 다수의 독립 분석에서 일관되게 확인되었다.

GitHub 이슈 — Auto Dream의 알려진 문제

#38426: /dream 명령어가 "Unknown skill"을 반환 — /memory에서 안내하지만 실행 불가
#38461: autoDreamEnabled: true로 설정해도 /dream이 동작하지 않음
#38493: Auto Dream의 3가지 갭 — 정체성(잘못된 프로젝트명 생성), 정확성(파일 수를 검증 없이 주장), 투명성(수정 이력 없음)

설계 의도: "쓰고 잊기" 문제의 해결

Auto Memory에는 구조적 한계가 있다. Claude가 MEMORY.md 인덱스를 간결하게 유지하고 상세 내용을 토픽 파일로 분리하는 기본 정리는 하지만, 모순 해결이나 오래된 항목 자동 삭제 같은 적극적 정리 메커니즘은 없다.

임시 작업 메모와 중요한 학습 내용이 구분 없이 저장된다
비슷한 내용이 반복 저장된다
해결된 이슈나 포기한 기술 스택에 대한 메모가 삭제되지 않고 남는다
MEMORY.md가 200줄 한도에 도달해도 자동 정리가 안 된다

세션이 쌓일수록 메모리 품질이 떨어진다. 이것이 사용자가 "20세션 넘게 쓰다 보면 모순이 생긴다"고 느끼는 이유이고, Auto Dream이 해결하려는 정확히 그 문제이다.

Auto Dream이 출시되면 다음을 자동으로 수행할 것으로 예상된다. 아래는 추출된 시스템 프롬프트와 DEV Community 분석에 기반한 추정이며, Anthropic이 공식 확인한 내용이 아니다.

상대 날짜를 절대 날짜로 변환 — "어제 Redis 쓰기로 했다" → "2026-03-15에 Redis 쓰기로 했다"
모순 항목 삭제 — Express에서 Fastify로 전환했으면 "API는 Express" 항목을 제거
중복 병합 — 같은 빌드 명령어에 대한 여러 메모를 하나로 통합
MEMORY.md 인덱스 200줄 이내 유지

쉽게 말하면: Auto Memory는 노트를 쓰는 손이고, Auto Dream은 노트를 정리하는 잠이다. 현재는 손만 있고 잠이 없는 상태다.

실행 조건 상세: 24시간 + 5세션이 정확히 무슨 뜻인가

Auto Dream이 자동으로 실행되려면 두 조건을 동시에 만족해야 한다.

조건	의미	왜 이 조건인가
`minHours: 24`	마지막 Auto Dream 실행 후 24시간 이상 경과	하루에 여러 번 정리가 반복되어 토큰을 낭비하는 것을 방지. 하루 1회가 상한.
`minSessions: 5`	마지막 Auto Dream 실행 후 5개 이상의 세션이 누적	정리할 내용이 충분히 쌓여야 의미 있다. 1~2번 사용 후 바로 정리하는 것은 비효율적.

"세션"이란 무엇인가

claude 명령어를 실행해서 시작하고, exit 또는 Ctrl+C로 종료할 때까지의 한 번의 대화 단위가 1세션이다. 짧은 세션이든 긴 세션이든 종료 한 번 = 1세션으로 카운트된다. 세션 카운트는 Auto Memory가 저장하는 메타데이터에 의해 추적된다.

두 조건은 AND 관계다. 5세션이 쌓여도 24시간이 안 지났으면 실행되지 않고, 24시간이 지나도 5세션이 안 쌓였으면 실행되지 않는다. 다음 세션 시작 시점에 두 조건을 모두 만족하면 세션이 시작될 때 자동으로 백그라운드에서 실행된다.

Auto Dream 실행 여부 확인 방법

실행 후 /memory 메뉴에서 상태가 바뀐다.

# 아직 실행되지 않은 상태
Auto-dream: on · never · /dream to run

# 실행된 이후 (예: 13시간 전에 실행됨)
Auto-dream: on · last ran 13h ago · /dream to run

"never"가 "last ran Xh ago"로 바뀌면 Auto Dream이 실제로 동작한 것이다. 실행 후 ~/.claude/projects/*/memory/ 디렉토리의 파일 수정 시간도 갱신된다.

Auto Dream 활성화 사용자를 위한 테스트 방법

/memory에서 "Auto-dream: on"이 표시되는 사용자라면 다음 순서로 직접 트리거할 수 있다.

# Step 1: 현재 상태 확인
/memory
# → "Auto-dream: on · never" 이면 조건 충족 대기 중

# Step 2: 세션을 5번 이상 쌓기
# claude를 시작하고 간단한 작업 후 종료를 반복 (하루에 몇 번이든 OK)
claude
# (작업 후 exit 또는 Ctrl+C)
# → 이걸 5번 이상 반복

# Step 3: 24시간 대기
# 첫 세션 이후 24시간이 지나야 함
# (이미 오늘 세션을 여러 번 했다면 내일 claude를 시작할 때 실행될 수 있음)

# Step 4: 새 세션 시작
claude
# → 세션 시작 시 백그라운드에서 Auto Dream이 자동 실행됨

# Step 5: 실행 확인
/memory
# → "Auto-dream: on · last ran 0h ago" 또는 "last ran Xh ago"로 변경됐으면 성공

실행 후 반드시 확인할 것

/memory에서 "last ran"으로 바뀌었는지 확인
~/.claude/projects/*/memory/MEMORY.md를 열어 내용이 정리됐는지 검토
모순되거나 잘못 병합된 항목이 있을 수 있으니 수동 검토 필수 (GitHub #38493 품질 이슈 참조)
중요한 프로젝트라면 실행 전 memory/ 디렉토리를 백업해두는 것을 권장

정확한 트리거 시점

Auto Dream이 정확히 "세션 시작 시" 실행되는지, "세션 종료 시" 실행되는지는 공식 문서에 없다.

소스 코드 분석(akari_iku, DEV Community)에 따르면 세션 시작 직후 백그라운드로 실행되는 것으로 추정된다. /memory에서 "last ran 0h ago"가 표시된다면 방금 세션에서 실행된 것이다.

5. 실전 튜토리얼: Auto Dream 없이 메모리 관리하기

Auto Dream이 아직 없다면, 직접 해야 한다. 다행히 어렵지 않다. 아래 3단계를 따라하면 메모리를 깔끔하게 유지할 수 있다.

Step 1: 현재 메모리 상태 확인

# Claude Code 세션에서
/memory

# 또는 터미널에서 직접 확인
ls -la ~/.claude/projects/*/memory/
cat ~/.claude/projects/*/memory/MEMORY.md | wc -l   # 줄 수 확인

/memory를 실행하면 현재 로딩된 모든 메모리 파일을 볼 수 있다. "Open auto-memory folder"를 선택하면 에디터에서 직접 열린다. 위 명령어의 * 부분에는 실제 프로젝트 경로가 들어간다. 정확한 경로를 모르면 /memory를 실행하여 확인하는 것이 가장 쉽다.

Step 2: 수동 메모리 정리

메모리가 쌓였다면 직접 정리한다. 두 가지 방법이 있다.

방법 A: Claude에게 요청하기

# Claude Code 세션에서 자연어로 요청
"메모리 파일들을 확인해서, 오래되거나 모순되는 항목을 정리해줘.
상대 날짜는 절대 날짜로 바꾸고, 중복은 합쳐줘."

이것이 커뮤니티에서 "run your autodream"이라고 부르는 것의 정체다. Auto Dream 기능이 아니라, Claude에게 메모리 정리를 수동으로 요청하는 것이다. Claude는 ~/.claude/projects/*/memory/ 디렉토리의 파일들을 읽고 수정할 수 있다.

방법 B: 직접 편집하기

# 메모리 디렉토리 열기
open ~/.claude/projects/*/memory/    # macOS
# 또는
code ~/.claude/projects/*/memory/    # VS Code

# 오래된 토픽 파일 삭제
rm ~/.claude/projects/my-project/memory/outdated-topic.md

# MEMORY.md 직접 편집 — 오래된 항목 삭제, 중복 병합
vim ~/.claude/projects/my-project/memory/MEMORY.md

Step 3: 주기적 정리 습관

Auto Dream이 하려는 것(24시간 간격, 5세션 이상 축적 후 정리)을 수동으로 모방한다.

주간 메모리 정리 체크리스트

모순 확인: "Redis 사용" vs "Memcached로 전환" 같은 항목이 공존하면 오래된 쪽 삭제
상대 날짜 수정: "어제", "지난주" → 절대 날짜로 변환
중복 병합: 같은 주제의 메모가 여러 개면 하나로 통합
해결된 이슈 삭제: 이미 해결된 버그나 포기한 접근에 대한 메모 제거
줄 수 확인: wc -l MEMORY.md가 200줄 이내인지 확인

팁: 중요한 규칙은 CLAUDE.md에

Auto Memory에 쌓이는 건 Claude의 "학습"이다. 팀 규칙, 코딩 표준, 프로젝트 아키텍처 같은 명시적 지침은 CLAUDE.md(./CLAUDE.md 또는 ./.claude/CLAUDE.md)에 작성한다. CLAUDE.md는 압축(/compact) 후에도 디스크에서 재로딩되어 완전 보존된다. (출처: 공식 문서)

6. 실전 시나리오

시나리오 1: 새 팀원이 프로젝트에 합류

이전 개발자가 Claude Code를 사용하며 쌓인 Auto Memory가 있다면, 새 팀원이 같은 머신에서 작업한다면, Claude를 통해 "이 프로젝트의 빌드 명령어가 뭐야?"라고 물으면 기존 메모리에서 즉시 답을 받을 수 있다. 다만 Auto Memory는 로컬 디스크에 저장되므로, 다른 머신에서 같은 리포를 클론해도 메모리는 공유되지 않는다. 팀 공유가 필요한 규칙은 CLAUDE.md에 기록하여 리포에 커밋하는 것이 정답이다.

시나리오 2: 긴 디버깅 세션

3시간짜리 디버깅 세션 중간에 컨텍스트가 차면 자동 압축이 발동한다. 이때 초반에 시도했던 실패한 접근들은 요약되고, CLAUDE.md의 규칙은 다시 로딩된다. 특정 디버깅 맥락을 보존하고 싶으면 /compact focus on the auth bug investigation로 수동 압축한다.

시나리오 3: 자동화 스크립트에서 Claude 호출

CI/CD나 스크립트에서 claude -p "task"로 호출할 때는 --bare 플래그를 쓰면 auto memory가 완전히 비활성화된다. 일회성 작업에서 불필요한 메모리 쓰기를 방지한다.

7. CLAUDE.md vs Auto Memory vs Auto Dream 비교

항목	CLAUDE.md	Auto Memory	Auto Dream (미출시)
누가 쓰는가	사용자	Claude	Claude (백그라운드 정리 작업으로 추정)
하는 일	지침과 규칙 명시	학습 내용 저장	저장된 메모리 정리/가지치기
범위	프로젝트, 사용자, 조직	워킹 트리 단위	워킹 트리 단위 (동일)
실행 시점	매 세션 시작 시	세션 중 수시로	세션 사이 (24시간 간격, 5세션 축적 후)
세션 로딩	전체 로딩 (파일 크기 제한 없으나, 컨텍스트 윈도우 소비)	MEMORY.md 첫 200줄(또는 25KB)	해당 없음 (메모리 파일을 정리하는 역할)
버전관리/공유	git 커밋 가능 → 팀 공유	로컬 디스크 전용	로컬 디스크 전용
우선순위	가장 높음	CLAUDE.md보다 낮음	Auto Memory를 수정하는 역할
압축(`/compact`) 후	디스크에서 재로딩 (완전 보존)	MEMORY.md 첫 200줄 재로딩	해당 없음
현재 상태	사용 가능	사용 가능 (v2.1.59+)	미출시

비유하면: CLAUDE.md는 "이렇게 해라"(명시적 지침), Auto Memory는 "지난번에 이렇게 했더니 잘 됐다"(경험 학습), Auto Dream은 "학습한 것을 정리하는 잠"(기억 정리)이다.

8. 이론적 배경: Sleep-time Compute

Auto Dream의 설계 철학은 우연이 아니다. 2025년 4월에 발표된 연구 논문과 직접적인 대응 관계가 있다.

Sleep-time Compute 논문

"Sleep-time Compute: Beyond Inference Scaling at Test-time"

(Kevin Lin, Charlie Snell et al., Letta + UC Berkeley, arXiv:2504.13171)

핵심 아이디어: LLM이 사용자의 질문을 받기 전에 미리 생각해두면, 질문이 왔을 때 더 빠르고 정확하게 답할 수 있다.

논문 (Sleep-time Compute)	Auto Dream (Claude Code)
사용자 쿼리를 예측하여 미리 계산	축적된 메모리를 정리/통합
테스트 타임 컴퓨팅 ~5배 절감 (논문 Table 1 기준)	세션 시작 시 더 효율적인 컨텍스트 로딩
오프라인(사용자 유휴 시간)에 처리	세션 사이에 비동기 실행 (`minHours: 24`)
여러 쿼리에 걸쳐 비용 분산	여러 세션에 걸쳐 정리 (`minSessions: 5`)

직접적 연관성은 미확인

Auto Dream과 Sleep-time Compute 논문의 대응 관계는 DEV Community 기사의 분석이다. Anthropic이 이 논문을 참조했다는 공식 확인은 없다. 다만 "사용자 유휴 시간에 컴퓨팅을 투자하여 다음 세션의 효율을 높인다"는 설계 철학은 동일하다.

인간의 수면과 기억 정리

"Dream"이라는 이름은 인간의 수면 중 기억 강화(memory consolidation during sleep) 과정에서 따온 것이다. 인간은 잠자는 동안 해마에서 대뇌피질로 정보를 옮기며, 중요한 기억은 강화하고 불필요한 기억은 잊는다. Auto Dream은 이 과정을 Auto Memory에 적용한 것이다 — 세션 사이("수면 시간")에 메모리를 정리하여, 다음 세션이 더 깨끗한 기억으로 시작하게 한다.

9. 커뮤니티 반응: 기대와 우려

긍정적 반응

반응	출처	검증
"인간의 REM 수면처럼 단기 기억을 장기 기억으로 정리한다. 네이밍이 의도적이다."	Threads @sakeeb.rahman	비유로서 적절. 실제 REM 수면 메커니즘과 1:1 대응은 아니지만, "세션 사이에 정리"라는 설계 의도는 맞다.
"Sleep-time Compute 논문이 떠오른다. 아름답다."	X @maksym_andr	논문과의 직접 연관은 미확인. 다만 "유휴 시간에 컴퓨팅 투자" 설계 철학은 유사하다 (섹션 8 참조).
"이미 OpenClaw로 매일 메모리 정리를 자동화하고 있었는데, 공식 기능으로 나와서 좋다."	X @JeremyNguyenPhD	파워 유저들이 이미 수동으로 하던 작업을 자동화한다는 점에서 실질적 가치가 있다.
"20세션 넘으면 메모리가 엉망이 된다. 이걸 해결해주는 기능이 필요했다."	Threads @sakeeb.rahman	Auto Memory의 "쓰고 잊기" 문제는 실제로 존재한다. 이 글의 섹션 3에서 다룬 구조적 문제이다.

우려 및 비판

우려	출처	검증 및 행동 지침
정확성 문제: 잘못된 프로젝트명 생성, 파일 수를 검증 없이 주장, 오래된 항목을 삭제하지 않음	GitHub #38493	실제 버그 리포트. Auto Dream 결과물은 반드시 수동 검토가 필요하다. `/memory`로 정리 결과를 확인할 것.
투명성 부족: 무엇을 수정했는지 변경 이력(changelog)이 없음	GitHub #38493	정리 전후를 비교할 수 없다. 중요 프로젝트에서는 정리 전 `memory/` 디렉토리를 백업해두는 것을 권장한다.
토큰 비용: 메모리 정리에 많은 토큰이 소비될 수 있다	커뮤니티 논의	사용자가 요청하지 않은 서브에이전트 실행의 비용 모델은 미공개. Anthropic이 부담하는지, 사용자 토큰에서 차감되는지 확인되지 않았다.
프라이버시: 메모리 내용이 정리 과정에서 API로 전송됨	커뮤니티 논의	Auto Memory 자체가 세션 중 API로 전송되므로, Auto Dream도 동일한 프라이버시 범위 내이다. 민감 정보가 메모리에 저장되지 않도록 주의.
/dream 명령어 미작동: UI에서 안내하지만 실행하면 "Unknown skill"	GitHub #38426, #38461	알려진 버그. `/dream` 대신 자연어로 "메모리를 정리해줘"라고 요청하면 수동으로 동일한 작업을 할 수 있다.

독자 행동 지침 요약

Auto Dream이 활성화된 경우: 정리 후 반드시 /memory로 결과 검토. 정리 전 memory/ 백업 권장.
Auto Dream이 비활성화된 경우: 섹션 5의 수동 정리 방법으로 동일한 효과를 얻을 수 있다.
민감 프로젝트: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1로 메모리 자체를 끄는 것을 고려.

10. 제한사항 및 주의사항

항목	내용	대응
Auto Dream 미출시	UI에 보이지만 활성화 불가. 출시 일정 미정.	섹션 5의 수동 정리 방법 사용
200줄 한도	MEMORY.md의 첫 200줄(또는 25KB)만 세션에 로딩	인덱스만 유지, 상세 내용은 토픽 파일로 분리
잘못된 기억	Claude가 잘못된 패턴을 학습할 수 있다	`/memory`로 주기적 검토. CLAUDE.md 규칙이 우선
로컬 전용	Auto Memory는 로컬 디스크에만 저장. 다른 머신과 공유 불가	`autoMemoryDirectory`로 클라우드 스토리지 경로 지정 (사용자 설정만)
프라이버시	Auto Memory는 로컬 저장이지만, 세션 중 API로 전송됨	민감 정보 저장 주의. 메모리만 끄려면 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` 또는 `autoMemoryEnabled: false`
커뮤니티 정보 혼동	"Memory 2.0", "Auto Dream 사용법" 등 미출시 기능을 출시된 것처럼 다루는 콘텐츠가 많다	공식 문서와 체인지로그 직접 확인

11. 트러블슈팅 Q&A

Q1. /memory에서 Auto-dream 토글이 안 보인다

원인: Claude Code 버전이 오래되었거나, 서버 사이드 feature flag가 비활성화된 상태일 수 있다. 최신 버전으로 업데이트해도 토글이 보이지 않을 수 있다 — Auto Dream은 공식 문서에 없는 서버 게이트 기능이다.

# 버전 확인
claude --version

# 최신 버전으로 업데이트
claude update
# legacy npm 설치인 경우
# npm update -g @anthropic-ai/claude-code

Q2. Auto-dream을 켤 수 없다

점진적 롤아웃이 진행 중인 것으로 보인다. Auto Dream은 서버 사이드 feature flag로 제어된다. 일부 사용자에게는 활성화되어 있고("Auto-dream: on · last ran 1d ago"), 다른 사용자에게는 잠겨 있다. settings.json에 "autoDreamEnabled": true를 추가해볼 수 있지만, 이 키는 공식 설정 문서에 기재되어 있지 않으며(2026-03-26 기준), 서버 플래그가 꺼져 있으면 효과가 없다. 활성화되기를 기다리면서, 섹션 5의 수동 정리 방법을 사용한다.

Q3. /dream을 실행하면 "unknown skill"이 나온다

정상이다. /dream 수동 명령어는 Auto Dream 자동 실행이 이미 켜진 사용자조차 "unknown skill"을 반환한다 (v2.1.84, GitHub #39135). 자동 실행과 수동 명령어는 별개로, 현재 후자는 미구현이다. 메모리 정리를 원하면 자연어로 "메모리 파일을 정리해줘"라고 요청하면 된다.

Q4. Claude가 이전 세션의 내용을 기억하지 못한다

확인사항:

claude --version이 v2.1.59 이상인지 확인
/memory에서 Auto-memory가 "on"인지 확인
~/.claude/projects/*/memory/MEMORY.md 파일이 존재하는지 확인
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 환경변수가 설정되어 있지 않은지 확인

Q5. 메모리가 쌓여서 모순이 생겼다

Auto Dream이 해결하려는 정확히 이 문제다. 출시 전까지는 섹션 5의 수동 정리 방법을 사용한다. Claude에게 "메모리를 확인해서 모순되는 항목을 정리해줘"라고 요청하면 된다.

Q6. "run your autodream"이라고 했더니 Claude가 뭔가 했다. 이게 Auto Dream인가?

아니다. Claude가 메모리 파일을 읽고 수정한 것이다. 이것은 Auto Dream 기능이 아니라, Claude의 일반적인 파일 편집 능력이다. Auto Dream은 세션 사이에 자동으로 실행되는 서브에이전트인데, 현재는 활성화되어 있지 않다.

Q7. 메모리에 잘못된 정보가 저장되어 있다

해결: /memory로 열어서 직접 수정하거나 삭제한다. 또는 CLAUDE.md에 "이 규칙을 따라라"고 명시하면, 잘못된 Auto Memory보다 CLAUDE.md가 우선한다.

Q8. 긴 세션에서 Claude가 초반 지시를 잊어버린다

원인: Context Compaction이 발동하면서 초반 대화가 요약됨 (섹션 3 참조).

해결:

중요 지시는 CLAUDE.md에 기록 (압축 후 재로딩됨)
/compact focus on [핵심 주제]로 보존할 내용 지정
/context로 현재 컨텍스트 사용량 모니터링

Q9. 팀원과 Auto Memory를 공유하고 싶다

현재: Auto Memory는 ~/.claude/ 아래에 로컬로 저장되므로 직접 공유되지 않는다. 같은 git 리포를 클론하면 같은 프로젝트 경로를 가지지만, 메모리 파일 자체는 각자의 로컬 머신에 있다.

대안: 팀 전체가 공유해야 하는 규칙은 CLAUDE.md에 작성하여 리포에 커밋한다.

Q10. 다른 머신으로 메모리를 옮기고 싶다

해결: Auto Memory는 ~/.claude/projects/<project>/memory/에 일반 마크다운 파일로 저장된다. 해당 디렉토리를 복사하면 된다. 또는 autoMemoryDirectory 설정으로 커스텀 경로(예: Dropbox, iCloud Drive)를 지정하여 머신 간 동기화할 수 있다.

{
  "autoMemoryDirectory": "~/Library/Mobile Documents/com~apple~CloudDocs/claude-memory"
}

다만 autoMemoryDirectory는 보안상 사용자/로컬 설정에서만 허용되고, 프로젝트 설정(.claude/settings.json)에서는 사용할 수 없다.

12. 결론: 언제 쓸 수 있을까

Auto Dream은 "있지만 없는" 기능이다. UI에 존재하고, 코드베이스에 구현되어 있고, 일부 사용자에게는 이미 활성화되어 있다. 하지만 대부분의 사용자에게는 아직 잠겨 있으며, /dream 명령어 핸들러가 연결되지 않은 등 미완성 상태다.

이미 준비된 것

이론적 기반: Sleep-time Compute 논문 (2025년 4월)
실행 인프라: Cloud Scheduled Tasks, Desktop Scheduled Tasks 등 기존 스케줄링 기능이 활용될 수 있을 것으로 보인다 (공식 확인되지 않음)
UI: /memory 메뉴에 이미 표시
Feature flag: 서버에서 켜기만 하면 됨

남은 질문

비용: 사용자가 요청하지 않은 서브에이전트 실행 비용을 누가 부담하는가?
투명성: 메모리 내용이 정리 과정에서 API로 전송된다는 사실을 어떻게 고지하는가?
기본값: opt-in(사용자가 켜야 함)인가, opt-out(기본 켜짐)인가?

출시 시기 추정

기술적으로는 출시 준비가 되어 있다. 남은 것은 비즈니스 결정(비용 모델, 프라이버시 정책, 기본값 설정)이다. 2026년 상반기 내 출시될 가능성이 있지만, 정확한 일정은 Anthropic만 알고 있다. feature flag가 보이지만 출시되지 않는 기능도 존재할 수 있다.

지금 할 수 있는 것

시점	행동
오늘	`/memory`로 현재 메모리 확인. Claude가 뭘 기억하고 있는지 한번 훑어보기
이번 주	CLAUDE.md에 프로젝트 규칙 정리. Auto Memory와 역할 분담 명확히 하기
매주	섹션 4의 체크리스트로 수동 메모리 정리 (Auto Dream이 할 일을 직접 하기)
Auto Dream 출시 후	`/memory`에서 Auto-dream 토글 확인. 켜져 있으면 수동 정리를 줄여도 된다

참고 자료

공식 문서: How Claude remembers your project
체인지로그: Claude Code Changelog
DEV Community: Does Claude Code Need Sleep? Inside the Unreleased Auto-dream Feature (akari_iku, 2026-03-24)
X: @JeremyNguyenPhD — "Claude Code's unreleased auto-dream feature"
GitHub: Issue #38426 — /dream returns "Unknown skill"
GitHub: Issue #38461 — autoDreamEnabled true but /dream broken
GitHub: Issue #38493 — Auto-dream: 3 gaps (2026-03-25)
GitHub: Issue #39135 — v2.1.84에서도 /dream 미작동 재확인 (2026-03-26)
시스템 프롬프트: Piebald-AI — Auto Dream 시스템 프롬프트
X: @kr0der — 최초 발견 트윗
X: @om_patel5 — 바이럴 스레드 (38K views)
Threads: @sakeeb.rahman — 4단계 프로세스 심층 분석
claudefa.st: Claude Code Auto Dream: Memory Consolidation Feature Explained
논문: Sleep-time Compute: Beyond Inference Scaling at Test-time (arXiv:2504.13171)

저작자표시 비영리 변경금지 (새창열림)

'AI > Claude' 카테고리의 다른 글

Claude Code 신기능 'Auto mode' 리뷰 : 승인 팝업 없이 Claude Code 쓰는 법 (--dangerously-skip-permissions 없이 자동 실행) (1)	2026.03.26
Claude 신기능 리뷰 - 대화중 인터랙티브(차트·다이어그램·시각화) 자료 실시간 생성 기능 리뷰 : 말 한마디로 웹앱이 나오는 시대 (0)	2026.03.25
Claude Computer Use 리뷰 : AI가 내 컴퓨터를 조작한다 - 폰에서 지시하면 Mac이 혼자 일한다 (1)	2026.03.25
Claude Channels vs OpenClaw - 텔레그램으로 Claude Code 제어하기(Anthropic이 OpenClaw에 선전포고?) (0)	2026.03.24
Claude Cowork Dispatch 리뷰 - 외출 중에도 AI가 내 컴퓨터에서 일 시키기 (3)	2026.03.23

Contents