저는 Claude 메모리에 대해 실제로 작동하는 모든 것(공식 문서, Dreaming 연구 프리뷰, 실제 프로덕션 설정)을 하나의 워크스루로 통합했습니다.
최신 AI 알파 소식을 받아보려면 제 Substack을 팔로우하세요: movez.substack.com
북마크하고 저장하세요. 이 글을 다 읽고 나면, "채팅 내에서"가 아니라 몇 주 동안 영구적으로 기억하는 에이전트를 갖게 될 것입니다.
과장이 아닙니다. 2026년 3월까지는 일반 사용자에게 불가능했던 일입니다. 이제 12단계면 됩니다.
당신이 만든 모든 에이전트가 금붕어인 이유
새 Claude 채팅을 열 때마다 에이전트는 제로부터 시작합니다.
당신의 이름을 모릅니다. 어제 당신이 세 번 수정한 내용, 지난주에 발견한 해결 방법, 당신이 글머리 기호 요약을 싫어한다는 사실도 기억하지 못합니다.
매 세션마다 같은 것을 다시 발견하고, 같은 실수를 반복하며, 당신이 이미 답한 질문을 또 묻습니다.
이는 Claude 마케팅의 결함이 아닙니다. 언어 모델이 작동하는 근본적인 속성입니다: 명시적으로 컨텍스트를 다시 주입하지 않으면 각 세션은 새롭게 시작됩니다.
챗봇에게는 괜찮습니다. 하지만 실제로 반복 작업을 실행하는 에이전트에게는, 이것이 당신의 설정이 정체되는 가장 큰 단일 원인입니다. 기억이 없는 에이전트는 1회 실행 때와 100회 실행 때의 유용성이 정확히 동일합니다.
1단계는 포스트잇입니다. 4단계는 매주 금요일마다 한 주를 되돌아보고 더 날카로워지는 직원입니다. 이 12단계는 세 부분으로 나누어 네 가지 계층을 모두 구축합니다.
기초 - 1단계 및 2단계
01. Claude의 내장 메모리를 켜세요
대부분의 사람들이 이미 존재한다는 사실을 모르는 것부터 시작하세요. 2026년 3월, Anthropic은 영구 메모리("Chat Memory")를 모든 Claude 계정(무료 및 Pro 모두)에 출시했습니다.
이제 Claude는 당신이 잊으라고 말할 때까지 모든 대화에서 당신의 선호도, 진행 중인 프로젝트 및 작업 스타일을 자동으로 기억합니다.
프로필 아이콘 → 설정 → 기능 → 메모리 섹션으로 스크롤하고 "채팅 기록에서 메모리 생성"이 켜져 있는지 확인하세요.
내부적으로는 메모리 합성(Memory Synthesis)이 실행됩니다. Claude는 약 24시간마다 당신의 대화를 프로필로 요약합니다. 이것이 다른 모든 것이 구축되는 베이스라인입니다.
02. 기다리지 말고 의도적으로 메모리를 시드하세요
문서에 명시된 직관에 반하는 부분: Claude가 기록에서 선호도를 유추하도록 기다리지 마세요. 해당 합성은 약 24시간에 한 번만 실행됩니다.
새 대화에서 직접 알려주세요. 명시적인 것이 항상 추론된 것보다 낫고, 하루 후가 아닌 즉시 적용됩니다.
Claude는 이것들을 메모리에 기록합니다. 다음 대화는 이미 그것들을 알고 시작합니다. 하나의 메시지로 반복 설명의 전체 범주를 제거합니다.
03. 에이전트의 홈으로 프로젝트(Project)를 생성하세요
프로젝트는 내부의 모든 대화에서 지침이 로드된 상태로 유지되는 영구 작업 공간입니다. 이것이 가장 강력한 형태의 1단계입니다.
프로젝트 → 새 프로젝트로 이동하세요. 주제가 아닌 작업의 이름을 지정하세요. 그런 다음 사용자 정의 지침 상자에 에이전트의 역할, 기준 및 제약 조건을 입력하세요. 해당 프로젝트 내의 모든 채팅이 이를 상속받습니다.
04. 프로젝트가 기억하지 못하는 것을 이해하세요
대부분의 사람들이 실수하는 부분입니다. 프로젝트는 지침을 유지합니다. 기본적으로 대화 메모리를 유지하지는 않습니다.
프로젝트를 설정하고, 상세한 컨텍스트를 제공하고, 몇 번의 대화를 진행한 후, 같은 프로젝트에서 새 채팅을 시작하면 이전에 논의한 모든 것이 사라집니다.
아키텍처 결정, 절반 완료된 작업, 디버깅 세션 - 모두 사라집니다. 프로젝트는 지침을 기억할 뿐, 당신의 기록은 기억하지 않습니다.
영구 메모리 - 3단계 (개발자용)
05. 라이브 메모리 파일을 추가하세요
실제로 작동하는 가장 간단한 영구 메모리는 에이전트가 시작 시 읽고 종료 시 추가하는 단일 파일입니다.
Claude Code에서는 CLAUDE.md이고, 모든 에이전트의 경우 프로젝트 지식(Project Knowledge)의 memory.md일 수 있습니다.
문서가 강조하는 규칙: 간결하게 유지하세요. 새로운 세션은 아무것도 입력하기 전에 지침을 로드하는 데 약 20,000 토큰을 사용할 수 있습니다.
이 파일을 위키 덤프처럼 취급하지 마세요. Claude Code의 /init를 사용하여 시작 파일을 생성하는 경우, 직관에 반하는 다음 단계는 생성된 내용의 대부분을 삭제하는 것입니다. 모델이 이미 볼 수 있는 명백한 내용을 진술하기 때문입니다.
06. 자동 메모리를 켜세요
Claude Code에는 자동 메모리(auto-memory) 메커니즘이 있습니다. 당신의 수정 및 선호도를 기반으로 스스로에게 메모를 작성하고, 매 세션 시작 시 로드합니다.
이제 에이전트는 가벼운 자체 문서화를 수행합니다. 당신이 수정하면, 그 수정 사항은 증발하는 대신 다음 세션까지 생존할 수 있습니다.
07. 메모리 파일을 유용하게 유지되도록 구조화하세요
구조 없이 성장하는 메모리 파일은 노이즈가 됩니다. 섹션을 제공하세요:
각 항목은 그 자리를 차지할 가치가 있어야 합니다. 이것은 에이전트가 어제의 실수를 반복하지 않기 위해 참고하는 파일입니다.
08. 무엇을 기억할 가치가 있는지 결정하세요
모든 것을 저장해서는 안 됩니다. 여기의 규율이 전부입니다. 각 중요한 세션 후에 에이전트는 무슨 일이 일어났는지 검토하고 저장할 가치가 있는 것만 추출합니다: 결정, 해결 방법, 선호도, 실패 모드. 다른 모든 것은 의도적으로 잊혀집니다.
좋은 필터: 이것이 다음 번에 에이전트의 행동 방식을 바꿀 것인가? 그렇다면 저장하세요. 아니라면 놓아주세요. 모든 것을 저장하는 메모리는 아무것도 저장하지 않는 메모리만큼 쓸모없습니다.
자기 개선 메모리 - 4단계: Dreaming
09. Dreaming이 실제로 무엇인지 이해하세요
2026년 5월 6일, Code with Claude에서 Anthropic은 Managed Agents를 위한 연구 프리뷰로 Dreaming을 출시했습니다. 이름은 의도적으로 신경과학에서 빌려왔습니다: 인간이 잠잘 때 뇌는 하루의 경험을 장기 기억으로 통합합니다. Dreaming은 에이전트에 대해 동일한 작업을 수행합니다.
예약된 백그라운드 프로세스입니다. 에이전트의 기존 메모리 저장소와 과거 세션 기록을 읽은 다음, 새롭게 재구성된 메모리 저장소(중복 제거, 오래된 항목을 최신 값으로 교체, 진정한 새로운 통찰력 표면화)를 생성합니다.
신경 쓰기 전에 한 가지 조건이 중요합니다: Dreaming은 동일한 종류의 작업을 반복적으로 실행하는 에이전트에게만 도움이 됩니다. 여러 세션에 걸쳐 패턴을 통합하므로, 일회성 에이전트는 통합할 것이 없습니다. 임시 방문객이 아닌, 주요 작업을 수행하는 에이전트에 실행하세요.
10. Dream을 실행하세요 - 정확한 API 절차
Dreaming은 연구 프리뷰이므로 코드를 작성하기 전에 세 가지 전제 조건이 있습니다: Managed Agents API 키, Anthropic의 양식을 통해 요청된 Dreaming 액세스(게이트 적용됨), 최신 Anthropic SDK가 포함된 Python 또는 TypeScript 환경.
모든 Dream 호출에는 함께 쌓인 두 개의 베타 헤더가 필요합니다. SDK는 Dreaming 인식 버전을 사용 중인 경우 자동으로 둘 다 설정합니다:
호출 자체는 두 가지 종류의 입력을 받습니다: 통합하려는 기존 메모리 저장소와 최대 100개의 세션 ID(Claude가 패턴을 마이닝할 최근 에이전트 실행).
Dream이 집중할 대상을 지정하기 위해 지침을 전달할 수도 있습니다:
프리뷰 기간 동안 지원되는 모델은 claude-opus-4-7 및 claude-sonnet-4-6입니다. Dream은 선택한 모델에 대한 표준 API 토큰 요율로 청구되며, 비용은 입력 세션의 수와 길이에 따라 대략 선형적으로 증가합니다.
문서는 명시적입니다: 소규모 세션 배치로 시작하고, 큐레이션 품질에 만족하면 규모를 확장하세요.
11. 커밋하기 전에 출력 저장소를 검사하세요
입력 메모리 저장소는 전체 시간 동안 읽기 전용으로 유지됩니다. Dream은 별도의 출력 저장소를 생성하며, 실행이 시작되면 해당 ID가 Dream의 outputs[] 배열에 나타납니다:
이제 읽어보세요. 병합된 항목이 올바른지, 교체된 항목이 실제로 오래된 것인지, 표면화된 통찰력이 실제이고 노이즈가 아닌지 확인하세요.
이 검토 단계가 에이전트가 더 똑똑해지는 것과 조용히 표류하는 것의 차이입니다. 출력은 당신이 옵트인하는 완전히 새로운 저장소이기 때문에 Dream은 기존 데이터를 조용히 손상시킬 수 없습니다.
12. 전환하고, 스케줄링하고, 복리 효과를 누리세요
출력을 신뢰하게 되면 프로덕션으로의 전환은 한 줄 변경입니다. 에이전트가 이전 ID 대신 새 저장소 ID를 가리키도록 하면 됩니다.
그런 다음 Dream을 스케줄에 넣으세요: 에이전트가 얼마나 자주 실행되는지에 따라 야간 또는 주간으로 설정하세요.
이제 루프가 닫혔습니다. 에이전트는 낮에 작업하고, 실행 사이에 Dream을 수행하며, 재교육이나 수동 재구성 없이 각 주기마다 더 날카로워져 돌아옵니다.
오래된 Dream을 보관해도 출력 저장소에는 영향을 미치지 않습니다. 해당 저장소는 Memory Stores API를 통해 별도로 관리합니다.
대규모로 작동한다는 증거: 법률 AI 회사 Harvey는 법률 문서 작성 워크플로우에 Dreaming을 활성화한 후 에이전트 작업 완료율이 약 6배 증가했다고 보고했습니다.
Claude가 세션 간에 파일 형식 특성과 도구 해결 방법을 계속 잊어버려서 실패하던 동일한 작업이 갑자기 안정적으로 완료되기 시작했습니다.
에이전트 메모리를 망가뜨리는 실수들
- 프로젝트를 메모리로 취급하는 것. 프로젝트는 지침을 유지하고 대화 기록은 유지하지 않습니다. 그렇지 않다고 가정하면 이유를 모른 채 컨텍스트를 잃게 됩니다.
- 모든 것을 CLAUDE.md에 덤프하는 것. 비대해진 메모리 파일은 토큰을 낭비하고 신호를 묻어버립니다. 길고 완벽한 것보다 간결하고 구조화된 것이 낫습니다.
- 필터 없이 메모리를 저장하는 것. 모든 것이 기억할 가치가 있다면 아무것도 기억할 가치가 없는 것입니다. 미래의 행동을 바꿀 것만 저장하세요.
- Dream 출력을 자동 배포하는 것. 별도 출력 저장소의 핵심은 검토입니다. 건너뛰면 안전망을 잃게 됩니다.
- 빈도가 낮은 에이전트에서 Dreaming을 실행하는 것. Dreaming은 여러 세션에 걸친 패턴을 통합합니다. 한 달에 두 번 실행되는 에이전트는 누적될 만큼 충분히 쌓이지 않습니다.
결론
대부분의 사람들은 지금까지 그래왔던 방식대로 Claude를 계속 사용할 것입니다. 매번 새롭고 건망증 심한 채팅을 열고, 실행할 때마다 스스로를 다시 설명하며, 에이전트가 왜 나아지지 않는지 궁금해할 것입니다.
네 가지 계층을 구축하는 사람들은 다른 무언가를 갖게 될 것입니다: 자신을 알고, 배운 것을 축적하며, 매주 더 날카로워지기 위해 자신의 메모리를 다시 쓰는 에이전트 말입니다.
처음 네 단계를 선택하세요. 오늘 밤 설정하세요. 그것만으로도 다음 세션의 느낌이 완전히 달라질 것입니다.
