Claude Managed Agents 개요

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

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

빠른 시작

첫 번째 에이전트 세션 만들기

API 참조

전체 엔드포인트 문서

핵심 개념

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

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

작동 방식

에이전트 생성
모델, 시스템 프롬프트, 도구, MCP 서버 및 스킬을 정의합니다. 에이전트를 한 번 생성하고 세션 전반에 걸쳐 ID로 참조합니다.
환경 생성
사전 설치된 패키지(Python, Node.js, Go 등), 네트워크 액세스 규칙 및 마운트된 파일이 있는 클라우드 컨테이너를 구성합니다.
세션 시작
에이전트 및 환경 구성을 참조하는 세션을 시작합니다.
이벤트 전송 및 응답 스트리밍
사용자 메시지를 이벤트로 전송합니다. Claude는 자율적으로 도구를 실행하고 서버 전송 이벤트(SSE)를 통해 결과를 스트리밍합니다. 이벤트 기록은 서버 측에 저장되며 전체를 가져올 수 있습니다.
조종 또는 중단
실행 중에 추가 사용자 이벤트를 전송하여 에이전트를 안내하거나, 방향을 변경하기 위해 중단합니다.

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

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

장기 실행 - 여러 도구 호출로 몇 분 또는 몇 시간 동안 실행되는 작업
클라우드 인프라 - 사전 설치된 패키지와 네트워크 액세스가 있는 보안 컨테이너
최소한의 인프라 - 자체 에이전트 루프, 샌드박스 또는 도구 실행 레이어를 구축할 필요 없음
상태 저장 세션 - 여러 상호작용에 걸친 영구적인 파일 시스템 및 대화 기록

지원되는 도구

Claude Managed Agents는 Claude에게 포괄적인 내장 도구 세트에 대한 액세스를 제공합니다:

Bash - 컨테이너에서 셸 명령 실행
파일 작업 - 컨테이너에서 파일 읽기, 쓰기, 편집, glob 및 grep
웹 검색 및 가져오기 - 웹 검색 및 URL에서 콘텐츠 검색
MCP 서버 - 외부 도구 제공자에 연결

전체 목록 및 구성 옵션은 도구를 참조하세요.

베타 액세스

Claude Managed Agents는 현재 베타 버전입니다. 모든 Managed Agents 엔드포인트에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다. 출력 품질을 향상시키기 위해 릴리스 간에 동작이 개선될 수 있습니다.

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

Claude API 키
모든 요청에 위의 베타 헤더
Claude Managed Agents에 대한 액세스(모든 API 계정에 대해 기본적으로 활성화됨)

특정 기능(결과, 멀티에이전트 및 메모리)은 연구 미리보기 상태입니다. 사용해 보려면 액세스 요청을 하세요.

속도 제한

Managed Agents 엔드포인트는 조직별로 속도가 제한됩니다:

작업	제한
생성 엔드포인트(에이전트, 세션, 환경 등)	분당 60개 요청
읽기 엔드포인트(검색, 목록, 스트림 등)	분당 600개 요청

조직 수준의 지출 한도 및 티어 기반 속도 제한도 적용됩니다.

브랜딩 가이드라인

Claude Managed Agents를 통합하는 파트너의 경우, Claude 브랜딩 사용은 선택 사항입니다. 제품에서 Claude를 참조할 때:

허용됨:

"Claude Agent" (드롭다운 메뉴에 권장)
"Claude" ("에이전트"로 이미 레이블이 지정된 메뉴 내에서)
"{YourAgentName} Powered by Claude" (기존 에이전트 이름이 있는 경우)

허용되지 않음:

"Claude Code" 또는 "Claude Code Agent"
"Claude Cowork" 또는 "Claude Cowork Agent"
Claude Code 브랜드 ASCII 아트 또는 Claude Code를 모방하는 시각적 요소

귀하의 제품은 자체 브랜딩을 유지해야 하며 Claude Code, Claude Cowork 또는 기타 Anthropic 제품으로 보여서는 안 됩니다. 브랜딩 준수에 관한 질문은 Anthropic 영업팀에 문의하세요.