Managed Agents첫 단계

Claude Managed Agents 개요

관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스입니다. 장시간 실행 작업 및 비동기 작업에 가장 적합합니다.

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

	Messages API	Claude Managed Agents
설명	모델 프롬프팅에 대한 직접 액세스	관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스
적합한 용도	커스텀 에이전트 루프 및 세밀한 제어	장기 실행 작업 및 비동기 작업
자세히 알아보기	Messages API 문서	Claude Managed Agents 문서

Claude Managed Agents는 Claude를 자율 에이전트로 실행하기 위한 하네스와 인프라를 제공합니다. 자체 에이전트 루프, 도구 실행 및 런타임을 구축하는 대신, Claude가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 코드를 안전하게 실행할 수 있는 완전 관리형 환경을 제공받습니다. 이 하네스는 고품질의 효율적인 에이전트 출력을 위해 내장된 프롬프트 캐싱, 압축 및 기타 성능 최적화를 지원합니다.

Claude Managed Agents는 AWS 기반 Claude Platform에서도 사용할 수 있으며, 기능 가용성 및 세션 동작에 일부 차이가 있습니다. AWS 기반 Claude Platform 가이드의 Claude Managed Agents를 참조하세요.

빠른 시작

첫 번째 에이전트 세션 생성하기

세션 시작하기

세션을 생성하고 첫 번째 이벤트 전송하기

레퍼런스

이벤트 유형, 속도 제한, CLI 플래그 및 기타 조회 테이블

핵심 개념

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 Managed Agents는 현재 베타 버전입니다. 모든 Managed Agents 엔드포인트에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다. 출력을 개선하기 위해 릴리스 간에 동작이 조정될 수 있습니다.

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

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?

Managed Agents첫 단계

Claude Managed Agents 개요

관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스입니다. 장시간 실행 작업 및 비동기 작업에 가장 적합합니다.

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

	Messages API	Claude Managed Agents
설명	모델 프롬프팅에 대한 직접 액세스	관리형 인프라에서 실행되는 사전 구축된 구성 가능한 에이전트 하네스
적합한 용도	커스텀 에이전트 루프 및 세밀한 제어	장기 실행 작업 및 비동기 작업
자세히 알아보기	Messages API 문서	Claude Managed Agents 문서

빠른 시작

첫 번째 에이전트 세션 생성하기

세션 시작하기

세션을 생성하고 첫 번째 이벤트 전송하기

레퍼런스

이벤트 유형, 속도 제한, CLI 플래그 및 기타 조회 테이블

핵심 개념

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은 더 제한된 리서치 프리뷰 상태입니다. 이를 활성화하려면 액세스를 요청하세요.

레퍼런스의 속도 제한 및 브랜딩 가이드라인을 참조하세요.

Was this page helpful?

핵심 개념

작동 방식

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

지원되는 도구

베타 액세스

핵심 개념

작동 방식

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

지원되는 도구

베타 액세스

핵심 개념

작동 방식

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

지원되는 도구

베타 액세스

핵심 개념

작동 방식

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

지원되는 도구

베타 액세스