Claude Managed Agents 개요

Claude Managed Agents 개요

Claude Managed Agents는 클로드(Claude)를 자율 에이전트로 실행하기 위한, 미리 구성된 실행 프레임워크(harness)와 인프라를 제공해요. 에이전트 루프나 도구 실행, 런타임을 직접 만들 필요 없이, 클로드가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 얻을 수 있어요. 수 분에서 수 시간씩 걸리는 장기 실행 작업과 비동기 작업에 특히 잘 맞는 구조랍니다. Messages API와 달리 세션 상태가 서버에 유지되어 중단 후에도 자연스럽게 이어갈 수 있는 것이 특징이에요.

출처: 문서

본문

Anthropic은 클로드와 함께 개발하는 두 가지 방식을 제공하며, 각각 서로 다른 사용 사례에 적합해요:

Messages API Claude Managed Agents
What it is Direct model prompting access Pre-built, configurable agent harness that runs in managed infrastructure
Best for Custom agent loops and fine-grained control Long-running tasks and asynchronous work

Claude Managed Agents는 클로드를 자율 에이전트로 실행하기 위한 실행 프레임워크와 인프라를 제공해요. 에이전트 루프, 도구 실행, 런타임을 직접 구축하는 대신, 클로드가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 얻을 수 있어요. 이 실행 프레임워크는 내장 프롬프트 캐싱(prompt caching), 컴팩션(compaction) 등 고품질·고효율 에이전트 출력을 위한 여러 성능 최적화를 지원해요. 대신 직접 모델에 접근해 나만의 에이전트 루프를 만들고 싶다면 Using the Messages API 문서를 참고하세요.

Claude Managed Agents는 기능 가용성과 세션 동작에 일부 차이가 있지만 Claude Platform on AWS에서도 사용할 수 있어요. 자세한 내용은 Claude Platform on AWS 가이드의 [Claude Managed Agents](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#claude-managed-agents) 섹션을 참고하세요. Create your first agent session Create a session and send your first event Event types, rate limits, CLI flags, and other lookup tables

Core concepts

Claude Managed Agents는 네 가지 핵심 개념을 중심으로 구성돼요:

Concept Description
Agent The model, system prompt, tools, MCP servers, and skills
Environment Configuration for where sessions run: an Anthropic-managed cloud sandbox, or a self-hosted sandbox on your own infrastructure
Session A running agent instance within an environment, performing a specific task and generating outputs
Events Messages exchanged between your application and the agent (user turns, tool results, status updates)

How it works

Define the model, system prompt, tools, MCP servers, and skills. Create the agent once and reference it by ID across sessions. Configure where the agent runs: a cloud sandbox, or a [self-hosted sandbox](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) on your own infrastructure. Launch a session that references your agent and environment configuration. Send user messages as events. Claude autonomously runs tools and streams back results through server-sent events (SSE). Event history is persisted server-side and can be fetched in full. Send additional user events to guide the agent mid-execution, or interrupt it to change direction.

When to use Claude Managed Agents

Claude Managed Agents는 다음을 필요로 하는 작업에 가장 잘 어울려요:

  • Long-running execution: Tasks that run for minutes or hours with multiple tool calls
  • Cloud infrastructure: Secure sandboxes with pre-installed packages and network access
  • Self-hosted execution: Sandboxes on infrastructure you control for compliance or data-residency requirements
  • Minimal infrastructure: No need to build your own agent loop, sandbox, or tool execution layer
  • Stateful sessions: Persistent filesystems and conversation history across multiple interactions
  • Scheduled execution: Recurring agent runs on a cron schedule through scheduled deployments

Supported tools

Claude Managed Agents는 클로드에게 다음과 같은 내장 도구 세트를 제공해요:

  • Bash: Run shell commands in the sandbox
  • File operations: Read, write, edit, glob, and grep files in the sandbox
  • Web search and fetch: Search the web and retrieve content from URLs, optionally restricted to an allowlist or blocklist of domains
  • MCP servers: Connect to external tool providers

전체 목록과 설정 옵션은 Tools 문서를 참고하세요.

Beta access

Claude Managed Agents는 현재 베타 단계예요. 모든 Managed Agents 엔드포인트는 `managed-agents-2026-04-01` 베타 헤더를 요구해요. SDK가 이 베타 헤더를 자동으로 설정해 주니 걱정하지 않아도 돼요. 출력 품질 향상을 위해 릴리스 사이에 동작이 다듬어질 수 있어요.

시작하려면 다음이 필요해요:

  1. A Claude API key
  2. The managed-agents-2026-04-01 beta header on all requests
  3. Access to Claude Managed Agents (enabled by default for all API accounts)

베타 기간 동안 MCP tunnels와 dreaming은 더 제한된 리서치 프리뷰로 제공돼요. 활성화하려면 Request access에서 신청하세요.

Claude Managed Agents는 설계상 상태를 유지해요: 세션은 오래 실행되고, 일시 중지 후에도 깨끗하게 재개되며, 대화 기록·샌드박스 상태·출력물을 서버에 저장해요. 그래서 Managed Agents는 현재 Zero Data Retention이나 HIPAA Business Associate Agreement (BAA) 적용 대상이 아니에요. 이 데이터에 대한 통제권은 여러분에게 있어요: 세션 삭제는 물론, 업로드한 파일도 언제든 API를 통해 별도로 삭제할 수 있어요. 모든 기능의 적용 범위는 API and data retention 문서를 확인하세요.

참고 문서의 Rate limits와 Branding guidelines도 확인해 보세요.

더 알아보기 (Learn more)

  • Quickstart — 첫 에이전트 세션 만들기
  • Start a session — 세션 만들고 첫 이벤트 보내기
  • Reference — 이벤트 종류, 속도 제한, CLI 플래그 등 참고 자료
  • Tools — 내장 도구 전체 목록과 설정 옵션