Claude Code Auto Dream 설정부터 활용까지 완벽 정리 — 메모리 충돌 해결법

어떤 기능인가요?

꿈이라는 단어가 적힌 로고

Claude Code Auto Dream은 Claude Code의 메모리 파일을 자동으로 정리·병합·삭제하는 백그라운드 메모리 통합 기능입니다. 사람의 REM 수면이 낮에 쌓인 기억을 정리하듯, Auto Dream은 세션 사이사이에 Claude의 메모리를 깨끗하게 유지합니다.

바이브 코딩 중 누군가가 이 기능을 우연히 발견했고, Ray Amjad 채널(구독자 4.15만명)에서 조회수 8.2만을 기록하며 빠르게 퍼지고 있습니다.



핵심 기능

1. 메모리 자동 통합

세션이 쌓이면서 발생하는 메모리 충돌 문제를 자동으로 해결합니다. 오래된 메모와 새로운 메모가 모순될 때, Auto Dream이 어떤 정보가 최신인지 판단하고 정리합니다.

2. 4단계 정리 프로세스

단계

이름

설명

1단계

방향 설정(Orient)

현재 메모리 디렉토리 상태를 파악하고 MEMORY.md 인덱스를 읽음

2단계

신호 수집(Gather Signal)

세션 기록에서 사용자 수정사항, 반복 패턴, 중요 결정을 추출

3단계

통합(Consolidate)

새 정보를 기존 파일에 병합, 상대 날짜를 절대 날짜로 변환

4단계

정리(Prune & Index)

MEMORY.md를 200줄 이하로 유지, 모순·중복 제거

3. 안전한 백그라운드 실행

Auto Dream이 작동하는 동안 프로젝트 코드는 절대 수정하지 않습니다. 메모리 파일만 읽고 쓸 수 있는 읽기 전용 모드로 동작하며, 락(lock) 파일로 동시 실행도 방지합니다.


이렇게 써보세요 — 실전 활용법

활용 1: Auto Dream 활성화하기

게임 설정을 보여주는 컴퓨터 화면의 스크린샷

Claude Code 터미널에서 /memory 명령어를 실행하면 메모리 설정 화면이 나옵니다. 여기서 auto-dream을 on으로 변경하면 끝입니다.

/memory → auto-dream: on

자동 실행 조건은 24시간 경과 + 5세션 이상 진행 — 두 조건이 모두 충족되면 백그라운드에서 자동으로 작동합니다.

조건 충족 전에 수동으로 실행하고 싶다면 /dream 명령어를 직접 입력하면 됩니다.


활용 2: 대규모 프로젝트에서 메모리 부채 청산하기

20세션 이상 작업한 프로젝트는 메모리가 엉망이 되어 있을 가능성이 높습니다. 실제 관찰 사례에서 913개 세션의 메모리를 약 9분 만에 통합한 기록이 있습니다.

Auto Dream이 처리하는 작업:

  • "어제"를 "2026-03-25"로 변환 (시간이 지나도 의미가 보존됨)

  • 모순된 사실 자동 삭제

  • 더 이상 존재하지 않는 파일 참조 제거

  • 중복 항목 병합

활용 3: 팀 프로젝트에서 메모리 일관성 유지하기

여러 사람이 같은 프로젝트에서 Claude Code를 사용하면, 각자의 세션에서 축적된 메모리가 충돌할 수 있습니다. Auto Dream은 이런 상황에서도 프로젝트 메모리의 일관성을 자동으로 유지합니다.


Claude Code의 4가지 메모리 시스템

Auto Dream은 Claude Code의 메모리 아키텍처 중 하나입니다. 전체 구조를 이해하면 더 효과적으로 활용할 수 있습니다.

시스템

역할

실행 시점

저장 위치

CLAUDE.md

규칙·명령 (사용자가 직접 작성)

수동 편집

프로젝트 루트

Auto Memory

패턴·선호도 학습

매 세션 자동

~/.claude/projects/

Session Memory

대화 맥락 요약

5K 토큰 초과 시

세션 내부

Auto Dream

메모리 정리·통합

24h + 5세션 후

~/.claude/projects/memory/

네 가지를 모두 활성화하는 것이 가장 효과적입니다. CLAUDE.md로 기본 규칙을 설정하고, Auto Memory가 세션별로 학습하고, Session Memory가 긴 대화를 요약하고, Auto Dream이 주기적으로 전체를 정리하는 구조입니다.

요금 & 시작하기

Auto Dream은 Claude Code에 내장된 무료 기능입니다. Claude Code 사용자라면 별도 비용 없이 바로 활성화할 수 있습니다.

시작 방법:

  1. Claude Code 터미널 실행

  2. /memory 입력

  3. auto-dream → on 변경

  4. 24시간 + 5세션 후 자동 실행 (또는 /dream으로 즉시 실행)

자주 묻는 질문

Claude Code Auto Dream은 무료인가요?

네, Claude Code에 포함된 기본 기능입니다. Claude Code를 사용하고 있다면 추가 비용 없이 /memory에서 활성화할 수 있습니다.

Auto Dream이 내 코드를 수정하지는 않나요?

Auto Dream은 메모리 파일만 수정할 수 있습니다. 소스 코드, 설정 파일, 테스트 코드 등 프로젝트 파일은 절대 건드리지 않는 안전한 읽기 전용 모드로 동작합니다.

/dream 명령어를 직접 실행해도 되나요?

물론입니다. 자동 실행 조건(24시간 + 5세션)을 기다리지 않고 /dream을 입력하면 즉시 메모리 통합을 시작합니다. 오래된 프로젝트의 메모리를 한 번에 정리할 때 유용합니다.

Auto Dream과 Auto Memory의 차이점은?

Auto Memory는 매 세션마다 Claude가 배운 내용을 자동으로 기록하는 기능입니다. Auto Dream은 그 기록들이 쌓여서 어지러워졌을 때 주기적으로 정리하는 기능입니다. Auto Memory가 "노트 필기"라면, Auto Dream은 "노트 정리"입니다.

Auto Dream 실행 중에 다른 작업을 해도 되나요?

Auto Dream은 백그라운드에서 작동하므로, 실행 중에도 다른 Claude Code 세션에서 작업을 계속할 수 있습니다. 작업 흐름을 방해하지 않습니다.



원문: YouTube - Ray Amjad | AX 콕집! by GPTers