Claude Managed Agents 개요
관리형 인프라에서 실행되는, 사전 구축되고 구성 가능한 에이전트 하네스입니다. 장기 실행 작업과 비동기 작업에 가장 적합합니다.
Anthropic은 Claude로 빌드하는 두 가지 방법을 제공하며, 각각 서로 다른 사용 사례에 적합합니다:
| Messages API | Claude Managed Agents | |
|---|---|---|
| 무엇인가 | 모델에 직접 프롬프트를 보낼 수 있는 액세스 | 관리형 인프라에서 실행되는, 사전 구축되고 구성 가능한 에이전트 하네스 |
| 적합한 용도 | 커스텀 에이전트 루프 및 세밀한 제어 | 장기 실행 작업 및 비동기 작업 |
Claude Managed Agents는 Claude를 자율 에이전트로 실행하기 위한 하네스와 인프라를 제공합니다. 자체 에이전트 루프, 도구 실행, 런타임을 직접 구축하는 대신, Claude가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 이용할 수 있습니다. 하네스는 고품질의 효율적인 에이전트 출력을 위해 내장된 "prompt caching"(프롬프트 캐싱), "compaction"(압축) 및 기타 성능 최적화를 지원합니다. 대신 모델에 직접 접근하여 자체 에이전트 루프를 구축하려면 Messages API 사용하기를 참조하세요.
핵심 개념
Claude Managed Agents는 네 가지 개념을 중심으로 구축되어 있습니다:
| 개념 | 설명 |
|---|---|
| Agent | 모델, 시스템 프롬프트, 도구, MCP 서버 및 스킬 |
| Environment | 세션이 실행되는 위치에 대한 구성: Anthropic이 관리하는 클라우드 샌드박스 또는 자체 인프라에서 직접 호스팅하는 샌드박스 |
| Session | 환경 내에서 실행 중인 에이전트 인스턴스로, 특정 작업을 수행하고 출력을 생성합니다 |
| Events | 애플리케이션과 에이전트 간에 교환되는 메시지(사용자 턴, 도구 결과, 상태 업데이트) |
작동 방식
에이전트 만들기
모델, 시스템 프롬프트, 도구, MCP 서버, 스킬을 정의합니다. 에이전트를 한 번 만들고 여러 세션에서 ID로 참조합니다.
환경 만들기
에이전트가 실행되는 위치를 구성합니다: 클라우드 샌드박스 또는 자체 인프라의 자체 호스팅 샌드박스.
세션 시작하기
에이전트 및 환경 구성을 참조하는 세션을 시작합니다.
이벤트 보내기 및 응답 스트리밍
사용자 메시지를 이벤트로 보냅니다. Claude는 자율적으로 도구를 실행하고 "server-sent events"(서버 전송 이벤트), 즉 SSE를 통해 결과를 스트리밍으로 반환합니다. 이벤트 기록은 서버 측에 유지되며 전체를 가져올 수 있습니다.
조정 또는 중단
실행 중에 에이전트를 안내하기 위해 추가 사용자 이벤트를 보내거나, 방향을 바꾸기 위해 중단합니다.
Claude Managed Agents를 사용해야 하는 경우
Claude Managed Agents는 다음이 필요한 워크로드에 가장 적합합니다:
- 장기 실행: 여러 도구 호출과 함께 수 분 또는 수 시간 동안 실행되는 작업
- 클라우드 인프라: 사전 설치된 패키지와 네트워크 접근이 가능한 안전한 샌드박스
- 자체 호스팅 실행: 규정 준수 또는 데이터 상주 요구 사항을 위해 직접 제어하는 인프라의 샌드박스
- 최소한의 인프라: 자체 에이전트 루프, 샌드박스 또는 도구 실행 계층을 구축할 필요 없음
- 상태 유지 세션: 여러 상호작용에 걸쳐 유지되는 영구 파일 시스템 및 대화 기록
- 예약 실행: 예약 배포를 통해 cron 일정에 따라 반복되는 에이전트 실행
지원되는 도구
Claude Managed Agents는 Claude에게 일련의 내장 도구에 대한 접근 권한을 제공합니다:
- Bash: 샌드박스에서 셸 명령 실행
- 파일 작업: 샌드박스에서 파일 읽기, 쓰기, 편집, glob, grep
- 웹 검색 및 가져오기: 웹을 검색하고 URL에서 콘텐츠를 가져오며, 선택적으로 도메인 허용 목록 또는 차단 목록으로 제한 가능
- MCP 서버: 외부 도구 제공자에 연결
전체 목록과 구성 옵션은 도구를 참조하세요.
베타 액세스
시작하려면 다음이 필요합니다:
- Claude API 키
- 모든 요청에
managed-agents-2026-04-01베타 헤더 - Claude Managed Agents에 대한 액세스(모든 API 계정에 기본적으로 활성화됨)
베타 내에서 MCP 터널과 dreaming은 보다 제한적인 리서치 프리뷰 단계에 있습니다. 이를 활성화하려면 액세스를 요청하세요.
Claude Managed Agents는 설계상 상태를 유지합니다: 세션은 장기 실행되고, 일시 중지 후 깔끔하게 재개되며, 대화 기록, 샌드박스 상태, 출력을 서버 측에 저장합니다. 이 때문에 Managed Agents는 현재 Zero Data Retention 또는 HIPAA Business Associate Agreement(BAA) 적용 대상이 아닙니다. 이 데이터에 대한 제어권은 사용자에게 있습니다: API를 통해 언제든지 세션을 삭제할 수 있으며, 업로드한 파일도 별도로 삭제할 수 있습니다. 모든 기능에 대한 적용 대상 여부는 API 및 데이터 보존을 참조하세요.
Was this page helpful?