Claude Managed Agent는 메모리 저장소를 통해 세션 사이에 메모를 전달할 수 있지만, 메모가 반복되거나 오래된 정보가 될 수 있습니다. Anthropic의 Dreams 연구 미리보기 는 저장소 하나와 과거 세션을 읽고 별도의 제안 저장소를 만들 수 있습니다. 이 가이드는 필요한 접근 권한이 있는 개발자가 Dream을 수동으로 한 번 실행하고, 남겨진 내용을 확인한 뒤 승인한 메모리만 이후 세션에 연결하는 방법을 설명합니다.

이 절차는 문서를 바탕으로 하며, 2026년 10월 20일 Anthropic의 최신 Managed Agents 가이드와 대조했습니다. BIG CHANGE는 Dream 실행, 실제 출력 확인, 계정 접근 권한 테스트, 비용이나 개선 효과 측정을 수행하지 않았습니다. 절차는 검토한 저장소 하나를 이후 세션 하나에서 사용하는 데서 끝납니다. 반복 실행, 채점, 다른 에이전트와의 자동 메모리 공유는 설정하지 않습니다.

큰 변화

  • 달라진 점: Dream은 입력을 바꾸지 않고 기존 메모리 저장소와 선택한 세션 기록 1~100개를 새 메모리 저장소로 종합할 수 있습니다.
  • 중요한 이유: 출력이 분리되어 있어 소유자는 다른 세션이 읽기 전에 새 메모나 요약한 메모를 원래 근거와 비교할 수 있습니다.
  • 주의할 점: Dreams에는 별도의 연구 미리보기 접근 권한이 필요합니다. 작업이 완료되었다고 사실이나 선호 사항이 승인되는 것은 아니며, 후보 저장소가 만들어진 것입니다.

시작 전 준비

Claude Console 계정과 API 키, 에이전트 도구 모음을 갖춘 기존 Managed Agent, 환경, 그리고 빠른 시작 문서에 설명된 Managed Agents 베타 접근 권한이 필요합니다. 또한 Dreams 연구 미리보기의 별도 접근 권한도 필요합니다. Managed Agents 베타 권한만으로는 이 자격을 확인할 수 없습니다. 요청을 보내기 전에 Dreams 접근 절차 를 통해 확인하세요.

기존 메모리 저장소 하나와, 내용을 함께 처리할 권한이 있는 실제 관련 세션 중 완료된 것 1~100개를 선택하세요. 기록은 있지만 저장소가 없다면 메모리 가이드 에서 빈 저장소를 만드는 방법을 확인하세요. 범위를 알 수 있는 이름과 설명을 붙입니다. 에이전트가 연결된 저장소를 읽거나 쓰려면 문서에 명시된 도구 모음이 필요합니다. 입력 세션을 생성할 때 저장소를 연결하세요. 실행 중인 세션에는 나중에 추가할 수 없습니다. 메모리 저장이 필요할 때만 read_write 를 사용하세요. 기본값은 read_write이므로 참조만 해야 하는 자료에는 read_only 를 지정합니다. 추측하지 말고 반환된 리소스의 mount_path 를 확인하세요.

입력 후보를 데이터 책임자와 검토하세요. 세션에는 고객 자료, 비공개 프로젝트 정보, 신뢰할 수 없는 텍스트가 포함될 수 있습니다. Anthropic은 공격자가 제어하는 프롬프트나 도구 결과가 쓰기 가능한 저장소를 오염시켜 이후 세션에 영향을 줄 수 있다고 경고합니다. 누가 Dream 출력을 검토할 수 있는지, 어떤 사실을 계속 보관해도 되는지 정하세요. 원본 세션, 이전 메모리 내용, 검토 중 내린 결정을 사람이 확인할 수 있는 기록으로 남깁니다.

명령 예제는 Bash 호환 셸에서 실행하세요. cURL은 --fail-with-body 를 지원해야 하며, 수정 및 마지막 세션 확인에는 Python 3도 필요합니다. PowerShell은 따옴표와 환경 변수 문법이 달라 명령을 조정해야 합니다. Anthropic Python SDK는 pip install anthropic 로 설치합니다. 방법은 빠른 시작 문서 에 있습니다. 설정하고 내보낼 변수는 ANTHROPIC_API_KEY 입니다. 평소 사용하는 비밀 정보 관리 방식으로 처리하여 cURL과 Python SDK가 모두 사용할 수 있게 하세요. 다음으로 store_id, session_a, session_b, agent_id , environment_id 에는 자신의 작업 공간이 반환한 ID를 설정하세요. 예제는 세션 두 개를 사용합니다. 실제 세션 ID를 1~100개 사용하세요. 키를 공유 로그나 초안에 남기지 마세요. 정확한 베타 헤더가 중요합니다. 직접적인 메모리 저장소 호출에는 agent-memory-2026-07-22 만 사용하고, 세션 호출에는 managed-agents-2026-04-01를 사용하며, Dream 호출에는 managed-agents-2026-04-01 와 dreaming-2026-04-21를 함께 사용합니다. 최신 전용 메모리 가이드에 따르면 메모리 저장소 요청에 앞의 두 헤더를 함께 쓰면 HTTP 400이 반환됩니다. Anthropic SDK는 해당 헤더를 자동으로 설정합니다.

Dream 한 번 실행하고 추적하기

  1. 먼저 입력 저장소와 선택한 세션을 읽으세요. 실제 ID와 작업에 중요한 메모리 경로 및 내용을 기록합니다. 문서화된 프로젝트 관례를 유지하고 대체된 메모를 버리는 등 정리 목표를 좁게 정하세요. 실행이 끝날 때까지 저장소와 세션을 사용할 수 있게 유지합니다. 실행 중 입력 저장소를 보관 처리하거나 삭제하거나, 입력 세션을 삭제하면 Dream이 실패할 수 있습니다.
  2. 기존 저장소와 세션으로 Dream을 생성합니다. 이 예제에서 사용하는 문서상의 모델은 claude-opus-5-5입니다. Anthropic은 다른 지원 미리보기 모델도 안내합니다. 선택 사항인 instructions 는 전반적인 종합 방향을 안내할 수 있으며 4,096자로 제한됩니다. 메모리의 특정 문장을 확실하게 편집하는 방법은 아닙니다.
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/dreams \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21" \
  -H "content-type: application/json" \
  --data '{
    "inputs": [
      {"type": "memory_store", "memory_store_id": "'"$store_id"'"},
      {"type": "sessions", "session_ids": ["'"$session_a"'", "'"$session_b"'"]}
    ],
    "model": "claude-opus-5-5",
    "instructions": "Preserve documented project conventions; drop superseded or one-off notes."
  }'
  1. 반환된 drm_... ID를 dream_id로 저장하세요. pending 응답은 작업이 생성되어 대기열에 들어갔다는 뜻입니다. 동일한 ID 로 상태가 completed, failed 또는 canceled가 될 때까지 주기적으로 조회하세요.
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/dreams/$dream_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21"

응답의 status, outputs, usage , error 를 읽으세요. outputs 는 Dream이 대기 중이거나 실행 초기의 짧은 시간 동안 비어 있을 수 있습니다. 그것만으로 다른 작업을 제출하지 마세요. Anthropic에 따르면 실행에는 수분에서 수시간이 걸릴 수 있으며 선택한 모델의 표준 API 토큰 요금이 적용됩니다. usage 필드는 토큰을 보고하지만 최종 요금은 실제 사용량과 가격에 따라 달라집니다. 이 가이드에서 비용이나 완료 시간을 측정하지는 않았습니다.

별도 저장소 확인하고 수정하기

  1. 먼저 status 가 completed에 도달하면 가져올 값은 memory_store_id 입니다. 이 값은 memory_store 항목에 있으며 해당 항목은 outputs 에 있습니다. 이 값을 output_store_id로 설정하세요. 해당 저장소의 메모리를 나열할 때는 메모리용 베타 헤더를 사용한 뒤 검토할 개별 메모리를 가져옵니다. 목록의 모든 페이지를 확인하고 경로와 해시를 포함한 전체 내용을 검토하세요. Console에서도 저장소를 검토할 수 있습니다.
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories?path_prefix=/" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"

curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"
  1. 유지되거나 종합된 각 주장을 관련 원본 세션과 이전 저장소에 대조하세요. 실제 근거가 있는지, 올바른 사용자나 프로젝트에 해당하는지, 더 최근 지시가 모순되는지 확인합니다. 비밀 정보, 개인 정보, 신뢰할 수 없는 자료에 숨겨진 지시를 찾으세요. 중요한 메모리마다 유지·수정·폐기 결정을 기록합니다. Dream은 어느 쪽도 변경하지 않습니다 . 입력 저장소와 원본 세션은 그대로이며 검토한 출력만 다음 단계에 사용해야 합니다.

특정 내용을 수정하려면 먼저 출력 메모리의 현재 content_sha256를 가져오세요. 실제 mem_id, 최신 해시, 수정한 내용을 문서에 명시된 메모리 업데이트 절차로 제출합니다. 해시 불일치는 다른 쓰기가 발생했다는 뜻입니다. 다시 읽고 차이를 해결한 뒤 새 해시로 재시도하세요. 다음 문법은 이 사전 조건을 보여줍니다. 검토한 수정 내용을 corrected_content 로 JSON 인코더에 전달하세요. 이 예제는 Python 3로 내용을 안전하게 이스케이프합니다.

Terminal
python3 -c 'import json,os; print(json.dumps({"content": os.environ["corrected_content"], "precondition": {"type": "content_sha256", "content_sha256": os.environ["mem_sha"]}}))' > correction.json

curl -sS --fail-with-body -X POST "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22" \
  -H "content-type: application/json" \
  --data-binary @correction.json

인코딩 전에 설정하고 내보낼 변수는 corrected_content 와 mem_sha 입니다. correction.json을 확인하고 메모리와 동일한 비공개 데이터 경계 안에 보관하세요. 읽어 확인한 후 보존 정책에 따라 로컬 사본을 삭제합니다. 편집한 메모리는 모두 다시 읽으세요. 저장소에는 메모리 최대 10,000개를 저장하며 각각 최대 100 kB입니다. 저장소 한도에 도달하면 새 메모리 쓰기는 실패하지만 기존 메모리는 계속 읽고 편집할 수 있습니다. 새 쓰기에 의존하기 전에 범위를 좁히거나 가득 찬 저장소를 안전하게 정리하세요.

승인한 메모리만 이후 세션에 연결하기

  1. 출력이 검토를 통과하면 해당 저장소로 새로운 세션을 생성하세요. 이 예제에서는 read_only로 연결하며, 검토한 기록을 바꾸지 않아야 하는 확인에 적합합니다. 나중에 에이전트가 메모리를 추가해야 한다면 의도적으로 read_write 를 부여하고 이후 쓰기도 검토하세요.
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  --data '{
    "agent": "'"$agent_id"'",
    "environment_id": "'"$environment_id"'",
    "resources": [
      {"type": "memory_store", "memory_store_id": "'"$output_store_id"'", "access": "read_only"}
    ]
  }'

새 세션이 반환한 리소스에서 의도한 저장소 ID와 실제 mount_path를 확인합니다. 반환된 세션 ID를 new_session_id 로 저장하고 Python이 읽을 수 있게 해당 셸 변수를 내보내세요. 출처를 확인한 유지된 사실 하나에 대해 일상 언어로 질문을 작성한 뒤, 이를 설정하고 내보낼 변수는 memory_question입니다. Anthropic의 빠른 시작 메시지 흐름 은 이벤트 스트림을 열고 user.message를 보내며 agent.message 텍스트를 출력하고 session.status_idle에서 멈춥니다. 이 문서화된 인터페이스로 질문을 보내고 답변을 읽으세요.

Terminal
python3 - <<'PY'
import os
from anthropic import Anthropic

client = Anthropic()
session_id = os.environ["new_session_id"]
question = os.environ["memory_question"]

with client.beta.sessions.events.stream(session_id) as stream:
    client.beta.sessions.events.send(
        session_id,
        events=[{"type": "user.message", "content": [{"type": "text", "text": question}]}],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                if block.type == "text":
                    print(block.text, end="")
        elif event.type == "session.status_idle":
            print()
            break
PY

스트림으로 받은 답변을 저장된 텍스트 및 원본 세션 모두와 비교합니다. 근거를 추적할 수 없다면 그럴듯한 답변만으로는 충분하지 않습니다. Dream ID, 승인한 출력 저장소 ID, 비교 결정, 새 세션 ID, 결과를 기록하세요. 대체 저장소가 이 검사를 통과할 때까지 입력 저장소를 유지합니다.

생성 시 접근 또는 검증 오류가 반환되면 요청을 바꾸기 전에 연구 미리보기 자격, 정확한 입력 ID, 세션 수를 확인하세요. 실행이 대기 중이거나 진행 중이면 같은 ID의 상태를 계속 조회합니다. failed 또는 canceled 실행은 일부만 생성된 출력 저장소를 남길 수 있습니다. 오류를 확인하고 해당 저장소를 승인한 메모리로 연결하지 마세요. 이후 세션이 승인한 메모리를 사용할 수 없다면 리소스와 마운트 경로를 확인할 대상은 바로 그 세션입니다. 이미 실행 중인 세션에는 저장소를 추가할 수 없습니다.

메모리 변경은 버전을 생성합니다. Anthropic에 따르면 일반 버전은 30일간 보관되며, 현재 존재하는 메모리의 일부 최근 버전은 더 오래 보관됩니다. 현재 메모리를 삭제해도 보관된 기록이 삭제되지는 않습니다 . 보관된 이전 버전을 복원하려면 읽은 뒤 현재 메모리를 업데이트하거나 삭제된 메모리를 다시 만드세요. 별도 복원 호출은 없습니다. 필요한 기록은 보존 기간이 끝나기 전에 내보내고, 민감한 과거 내용에는 문서화된 가림 처리 절차를 사용하세요. 저장소 보관 처리는 되돌릴 수 없고 읽기 전용으로 바꾸며 새 연결을 막습니다. 저장소 삭제는 메모리와 버전을 영구 제거합니다. 두 보존 결정은 이후 세션을 검증한 뒤 데이터 소유자의 정책에 따라 내리세요.

이전의 별도 Managed Agents 작업은 병렬 문서 검토 가이드를 참고하세요. Hy Memory 2.0 기사 는 별도의 메모리 SDK와 그 자체의 범위를 제한한 회상 절차를 다룹니다.

출처와 추가 읽을거리

  • Anthropic의 Dreams 가이드 는 연구 미리보기 접근, 입력, 생성 및 상태 조회 요청, 상태, 별도 출력, 과금, 실패 동작을 설명합니다. 메모리 저장소 베타 헤더에 대한 일반적인 설명은 최신 전용 메모리 가이드와 충돌합니다. 직접 메모리 저장소 호출에는 후자를 따르세요.
  • Anthropic의 메모리 가이드 는 저장소 생성, 세션 연결, 메모리 전용 헤더, 목록 조회, 해시로 보호하는 편집, 버전, 보존을 설명합니다. 쓰기 가능한 저장소 오염과 되돌릴 수 없는 보관 및 삭제도 경고합니다.
  • Anthropic의 Managed Agents 빠른 시작 문서 는 계정, API 키, 에이전트, 환경, 세션의 사전 조건을 설명합니다. 어느 페이지도 이 가이드의 실제 실행 관찰이나 품질 개선을 입증하지 않습니다.