Anthropic은 Claude로 구축할 수 있는 두 가지 방법을 제공하며, 각각 서로 다른 사용 사례에 적합합니다:
| Messages API | Claude Managed Agents | |
|---|---|---|
| 설명 | 모델 프롬프팅에 대한 직접 액세스 | 관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스 |
| 적합한 용도 | 커스텀 에이전트 루프 및 세밀한 제어 | 장기 실행 작업 및 비동기 작업 |
| 자세히 알아보기 | Messages API 문서 | Claude Managed Agents 문서 |
Claude Managed Agents는 Claude를 자율 에이전트로 실행하기 위한 하네스와 인프라를 제공합니다. 자체 에이전트 루프, 도구 실행, 런타임을 구축하는 대신, Claude가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 얻을 수 있습니다. 이 하네스는 고품질의 효율적인 에이전트 출력을 위해 내장된 프롬프트 캐싱, 압축(compaction) 및 기타 성능 최적화를 지원합니다.
Claude Managed Agents는 네 가지 개념을 중심으로 구축되었습니다:
| 개념 | 설명 |
|---|---|
| Agent | 모델, 시스템 프롬프트, 도구, MCP 서버 및 스킬 |
| Environment | 세션이 실행되는 위치에 대한 구성: Anthropic이 관리하는 클라우드 샌드박스 또는 자체 인프라에서 호스팅하는 샌드박스 |
| Session | 환경 내에서 실행 중인 에이전트 인스턴스로, 특정 작업을 수행하고 출력을 생성함 |
| Events | 애플리케이션과 에이전트 간에 교환되는 메시지(사용자 턴, 도구 결과, 상태 업데이트) |
에이전트 만들기
모델, 시스템 프롬프트, 도구, MCP 서버, 스킬을 정의합니다. 에이전트를 한 번 만들고 여러 세션에서 ID로 참조합니다.
환경 만들기
에이전트가 실행되는 위치를 구성합니다: 클라우드 샌드박스 또는 자체 인프라의 자체 호스팅 샌드박스.
세션 시작하기
에이전트와 환경 구성을 참조하는 세션을 시작합니다.
이벤트 전송 및 응답 스트리밍
사용자 메시지를 이벤트로 전송합니다. Claude는 자율적으로 도구를 실행하고 "server-sent events"(서버 전송 이벤트), 즉 SSE를 통해 결과를 스트리밍합니다. 이벤트 기록은 서버 측에 유지되며 전체를 가져올 수 있습니다.
조정 또는 중단
실행 중에 에이전트를 안내하기 위해 추가 사용자 이벤트를 보내거나, 방향을 변경하기 위해 중단할 수 있습니다.
Claude Managed Agents는 다음이 필요한 워크로드에 가장 적합합니다:
Claude Managed Agents는 Claude에게 내장 도구 세트에 대한 액세스를 제공합니다:
전체 목록과 구성 옵션은 도구를 참조하세요.
시작하려면 다음이 필요합니다:
managed-agents-2026-04-01 베타 헤더베타 기간 동안 MCP 터널과 드리밍은 더 제한된 연구 프리뷰 상태입니다. 활성화하려면 액세스를 요청하세요.
Claude Managed Agents는 설계상 상태를 유지합니다: 세션은 장시간 실행되고, 일시 중지 후 깔끔하게 재개되며, 대화 기록, 샌드박스 상태, 출력을 서버 측에 저장합니다. 이 때문에 Managed Agents는 현재 Zero Data Retention 또는 HIPAA 비즈니스 제휴 계약(BAA) 적용 대상이 아닙니다. 이 데이터에 대한 제어권은 사용자에게 있습니다: API를 통해 언제든지 세션을 삭제하고, 업로드한 파일을 별도로 삭제할 수 있습니다. 모든 기능에 대한 적격성은 API 및 데이터 보존을 참조하세요.
레퍼런스의 속도 제한과 브랜딩 가이드라인을 참조하세요.
Was this page helpful?