---
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
---

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 Platform on AWS에서도 사용할 수 있으며, 기능 가용성과 세션 동작에 일부 차이가 있습니다. 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는 네 가지 개념을 중심으로 구축되어 있습니다:

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

## 작동 방식

<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를 통해 결과를 스트리밍으로 반환합니다. 이벤트 기록은 서버 측에 유지되며 전체를 가져올 수 있습니다.
  </Step>

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

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

Claude 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는 베타 헤더를 자동으로 설정합니다. 출력을 개선하기 위해 릴리스 간에 동작이 조정될 수 있습니다.
</Note>

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

1. [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)과 [dreaming](https://platform.claude.com/docs/ko/managed-agents/dreams)은 보다 제한적인 리서치 프리뷰 단계에 있습니다. 이를 활성화하려면 [액세스를 요청](https://claude.com/form/claude-managed-agents)하세요.

Claude Managed Agents는 설계상 상태를 유지합니다: 세션은 장기 실행되고, 일시 중지 후 깔끔하게 재개되며, 대화 기록, 샌드박스 상태, 출력을 서버 측에 저장합니다. 이 때문에 Managed Agents는 현재 [Zero Data Retention](https://platform.claude.com/docs/ko/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) 또는 HIPAA Business Associate Agreement(BAA) 적용 대상이 아닙니다. 이 데이터에 대한 제어권은 사용자에게 있습니다: 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)을 참조하세요.