---
title: Claude Managed Agents 개요
url: https://platform.claude.com/docs/ko/managed-agents/overview
description: 관리형 인프라에서 실행되는, 사전 구축되고 구성 가능한 에이전트 하네스입니다. 장기 실행 작업과 비동기 작업에 가장 적합합니다.
featureMetadata:
  topic:
    title: Managed Agents
    url: https://platform.claude.com/docs/en/managed-agents/overview
  status: beta
  betaHeader: managed-agents-2026-04-01
  zdr:
    eligibility: not-eligible
    note: 자체 호스팅 Managed Agents를 제외하고 ZDR 적격 대상이 아닙니다. 세션은 상태를 유지하는 리소스이며, 트랜스크립트는 삭제할 때까지 유지됩니다.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed): beta
---

Anthropic은 Claude로 빌드하는 두 가지 방법을 제공하며, 각각 서로 다른 사용 사례에 적합합니다:

|  | Messages API | Claude Managed Agents |
| ----- | ----- | ----- |
| **무엇인가** | 모델에 직접 프롬프트를 보낼 수 있는 액세스 | 관리형 인프라에서 실행되는, 사전 구축되고 구성 가능한 에이전트 하네스 |
| **적합한 용도** | 커스텀 에이전트 루프 및 세밀한 제어 | 장기 실행 작업 및 비동기 작업 |

Claude Managed Agents는 Claude를 자율 에이전트로 실행하기 위한 하네스와 인프라를 제공합니다. 자체 에이전트 루프, 도구 실행, 런타임을 직접 구축하는 대신, Claude가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 이용할 수 있습니다. 하네스는 고품질의 효율적인 에이전트 출력을 위해 내장된 “prompt caching”(프롬프트 캐싱), “compaction”(압축) 및 기타 성능 최적화를 지원합니다. 대신 모델에 직접 접근하여 자체 에이전트 루프를 구축하려면 [Messages API 사용하기](https://platform.claude.com/docs/ko/build-with-claude/working-with-messages)를 참조하세요.

<Note>
  Claude Managed Agents는 Claude Models on Google Cloud (Anthropic managed) 및 Claude Platform on AWS에서도 사용할 수 있으며, 기능 가용성과 세션 동작에 일부 차이가 있습니다. [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed#claude-managed-agents) 가이드 또는 Claude Platform on AWS 가이드의 [Claude Managed Agents](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws#claude-managed-agents)를 참조하세요.
</Note>

<CardGroup cols={3}>
  <Card title="빠른 시작" icon="play" href="https://platform.claude.com/docs/ko/managed-agents/quickstart">
    첫 번째 에이전트 세션 만들기
  </Card>

  <Card title="세션 시작하기" icon="code-brackets" href="https://platform.claude.com/docs/ko/managed-agents/sessions">
    세션을 만들고 첫 번째 이벤트 보내기
  </Card>

  <Card title="레퍼런스" icon="book" href="https://platform.claude.com/docs/ko/managed-agents/reference">
    이벤트 유형, 속도 제한, CLI 플래그 및 기타 조회 테이블
  </Card>
</CardGroup>

## 핵심 개념

Claude Managed Agents는 네 가지 개념을 중심으로 구축되어 있습니다:

| 개념 | 설명 |
| ----- | ----- |
| **에이전트** | 모델, 시스템 프롬프트, 도구, MCP 서버 및 스킬 |
| **환경** | 세션이 실행되는 위치에 대한 구성: Anthropic이 관리하는 클라우드 샌드박스 또는 자체 인프라에서 직접 호스팅하는 샌드박스 |
| **세션** | 환경 내에서 실행 중인 에이전트 인스턴스로, 특정 작업을 수행하고 출력을 생성합니다 |
| **이벤트** | 애플리케이션과 에이전트 간에 교환되는 메시지(사용자 턴, 도구 결과, 상태 업데이트) |

## 작동 방식

<Steps>
  <Step title="에이전트 만들기">
    모델, 시스템 프롬프트, 도구, MCP 서버, 스킬을 정의합니다. 에이전트를 한 번 만들고 여러 세션에서 ID로 참조합니다.
  </Step>

  <Step title="환경 만들기">
    [에이전트가 실행될 위치를 구성합니다](https://platform.claude.com/docs/ko/managed-agents/choosing-an-environment): 클라우드 샌드박스 또는 자체 인프라의 [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes)입니다.
  </Step>

  <Step title="세션 시작하기">
    에이전트 및 환경 구성을 참조하는 세션을 시작합니다.
  </Step>

  <Step title="이벤트 보내기 및 응답 스트리밍">
    사용자 메시지를 이벤트로 보냅니다. Claude는 자율적으로 도구를 실행하고 “server-sent events”(서버 전송 이벤트), 즉 SSE를 통해 결과를 스트리밍으로 반환합니다. Managed Agents 서비스는 이벤트 기록을 보관하며, 이를 전체 가져올 수 있습니다.
  </Step>

  <Step title="조정 또는 중단">
    에이전트가 실행되는 동안 추가 사용자 이벤트를 보내 에이전트를 안내하거나, 방향을 바꾸기 위해 중단할 수 있습니다.
  </Step>
</Steps>

## Claude Managed Agents를 사용해야 하는 경우

Claude Managed Agents는 다음이 필요한 워크로드에 가장 적합합니다:

* **장기 실행:** 여러 도구 호출과 함께 수 분 또는 수 시간 동안 실행되는 작업
* **클라우드 인프라:** 사전 설치된 패키지와 네트워크 접근이 가능한 안전한 샌드박스
* **자체 호스팅 실행:** 규정 준수 또는 데이터 상주 요구 사항을 위해 직접 제어하는 인프라의 샌드박스
* **자체 호스팅 서비스:** [자체 호스팅 Claude Managed Agents](https://platform.claude.com/docs/ko/managed-agents/self-hosted)를 통해 자체 인프라에서 실행되는 Managed Agents 서비스 전체
* **최소한의 인프라:** 자체 에이전트 루프, 샌드박스 또는 도구 실행 계층을 구축할 필요 없음
* **상태 유지 세션:** 여러 상호작용에 걸쳐 유지되는 영구 파일 시스템 및 대화 기록
* **예약 실행:** [예약 배포](https://platform.claude.com/docs/ko/managed-agents/scheduled-deployments)를 통해 cron 일정에 따라 반복되는 에이전트 실행

## 지원되는 도구

Claude Managed Agents는 Claude에게 일련의 내장 도구에 대한 접근 권한을 제공합니다:

* **Bash:** 샌드박스에서 셸 명령 실행
* **파일 작업:** 샌드박스에서 파일 읽기, 쓰기, 편집, glob, grep
* **웹 검색 및 가져오기:** 웹을 검색하고 URL에서 콘텐츠를 가져오며, 선택적으로 도메인 허용 목록 또는 차단 목록으로 제한 가능
* **MCP 서버:** 외부 도구 제공자에 연결

전체 목록과 구성 옵션은 [도구](https://platform.claude.com/docs/ko/managed-agents/tools)를 참조하세요.

## 베타 액세스

<Note>
  Claude Managed Agents는 베타 단계입니다. 모든 Managed Agents 엔드포인트에는 `managed-agents-2026-04-01` 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다. Anthropic은 출력을 개선하기 위해 릴리스 간에 동작을 조정할 수 있습니다.
</Note>

시작하려면 다음이 필요합니다:

1. Claude Console에서 발급받은 [Claude API 키](https://platform.claude.com/settings/keys).
2. 모든 요청에 `managed-agents-2026-04-01` 베타 헤더.
3. Claude Managed Agents에 대한 액세스(모든 API 계정에 기본적으로 활성화됨).

베타 내에서 [MCP 터널](https://platform.claude.com/docs/ko/agents-and-tools/mcp-tunnels/overview)과 [드리밍](https://platform.claude.com/docs/ko/managed-agents/dreams)은 보다 제한적인 리서치 프리뷰 단계에 있습니다. 이를 활성화하려면 [리서치 프리뷰에 대한 액세스를 요청](https://claude.com/form/claude-managed-agents)하세요.

Claude Managed Agents는 설계상 상태를 유지합니다: 세션은 장기 실행되고, 일시 중지 후 깔끔하게 재개되며, 대화 기록, 샌드박스 상태, 출력을 서버 측에 저장합니다. 이 때문에 Managed Agents는 현재 [제로 데이터 보존](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) 또는 HIPAA 업무 제휴 계약(BAA) 적용 대상이 아닙니다. 제로 데이터 보존의 예외는 [데이터 보관 기간](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access#how-long-data-is-kept)에서 설명하는 것처럼 해당 데이터를 직접 저장하는 자체 호스팅 Claude Managed Agents입니다. 이 데이터에 대한 제어권은 사용자에게 있습니다: API를 통해 언제든지 [세션을 삭제](https://platform.claude.com/docs/ko/managed-agents/session-operations#deleting-a-session)할 수 있으며, 업로드한 [파일](https://platform.claude.com/docs/ko/build-with-claude/files#delete-a-file)도 별도로 삭제할 수 있습니다. 모든 기능에 대한 적용 대상 여부는 [API 및 데이터 보존](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#feature-eligibility)을 참조하세요.

레퍼런스의 [속도 제한](https://platform.claude.com/docs/ko/managed-agents/reference#rate-limits) 및 [브랜딩 가이드라인](https://platform.claude.com/docs/ko/managed-agents/reference#branding-guidelines)을 참조하세요.

## 제공 여부

Managed Agents은(는) 모든 모델에서 베타 상태입니다.

### API 지원

| 상태 | 클라우드 플랫폼 | 모델 |
| ----- | ----- | ----- |
| 베타 | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [모든 모델](https://platform.claude.com/docs/ko/models/overview) |

### 필수 베타 헤더

[베타 헤더 개요](https://platform.claude.com/docs/ko/api/beta-headers)

베타 헤더를 사용하면 실험적 기능과 새로운 모델 기능이 표준 API에 포함되기 전에 액세스할 수 있습니다.

* `managed-agents-2026-04-01`

### 데이터 처리

[데이터 처리 개요](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#feature-eligibility)

| 항목 | 제로 데이터 보존 | HIPAA |
| ----- | ----- | ----- |
| 상태 | 적격 아님 | 적격 아님 |
| 세부 정보 | 자체 호스팅 Managed Agents를 제외하고 ZDR 적격 대상이 아닙니다. 세션은 상태를 유지하는 리소스이며, 트랜스크립트는 삭제할 때까지 유지됩니다. [자세히 알아보기](https://platform.claude.com/docs/ko/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | HIPAA 적격 대상이 아닙니다. 모든 Managed Agents 하위 기능에 적용됩니다. |

적용 엔드포인트:

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
