Anthropic의 Claude Managed Agents 활용 가이드

섹션별 상세

01

에이전트 개발 시 인프라 구축, 샌드박스 격리, 상태 관리 등 운영 부담이 큰 병목으로 작용한다. Claude Managed Agents는 이를 관리형 플랫폼으로 전환하여 개발자가 에이전트 로직에 집중하도록 지원한다.

02

플랫폼은 에이전트 정의, 샌드박스 환경, 실행 세션, 이벤트 스트림의 4가지 핵심 개념으로 구성된다. 에이전트는 격리된 환경에서 파일 작업, 셸 명령, 웹 검색, MCP 서버 연결을 수행하며, 세션은 네트워크 단절에도 상태를 유지한다.

bash

ant beta:agents create \
--name "Coding Assistant" \
--model '{"id":"claude-haiku-4-5"}' \
--system "You are a helpful coding assistant. Write clean, well-documented code." \
--tool '{"type":"agent_toolset_20260401"}'

Claude Managed Agents에서 에이전트를 생성하는 CLI 명령어 예시

bash

ant beta:environments create \
--name "quickstart-env" \
--config '{"type":"cloud","networking":{"type":"unrestricted"}}'

에이전트가 실행될 샌드박스 환경을 생성하는 CLI 명령어

python

with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[
            {
                "type": "user.message",
                "content": [
                    {
                        "type": "text",
                        "text": (
                            "Create a Python script that finds the first 50 prime "
                            "numbers, saves them to primes.txt (one per line), and "
                            "prints the largest prime and the sum of all 50 primes."
                        ),
                    },
                ],
            },
        ],
    )

Python SDK를 사용하여 세션에 작업을 전송하고 이벤트를 스트리밍하는 코드

에이전트 생성을 위한 JSON 설정 파일 예시 — Screenshot에이전트 정의 시 모델, 시스템 프롬프트, 도구 세트를 설정하는 구조를 보여준다. agent_toolset_20260401 도구 타입이 명시되어 있다.

환경 생성을 위한 JSON 설정 파일 예시 — Screenshot클라우드 샌드박스 환경을 정의하고 네트워크 설정을 구성하는 JSON 구조를 나타낸다.

에이전트 작업 실행 결과 출력 — Screenshot에이전트가 소수 찾기 스크립트를 작성하고 실행한 후의 터미널 출력 결과를 보여준다.

03

과금은 모델 토큰 사용량, 활성 세션 런타임, 웹 검색 횟수에 따라 결정된다. 대기 시간은 과금에서 제외되어 실제 작업 수행 시간에 비례한 비용 효율성을 제공한다.

04

최근 업데이트된 Dreaming은 에이전트가 과거 작업을 검토하여 패턴을 학습하고, Outcomes는 정의된 루브릭에 따라 결과물을 검증한다. Multi-agent orchestration은 리드 에이전트가 작업을 분할하여 전문 서브 에이전트에게 위임하는 병렬 처리 구조를 지원한다.

용어 해설

Model Context Protocol(MCP): — AI 모델이 외부 도구 및 데이터와 상호작용하기 위한 표준화된 프로토콜. 에이전트가 다양한 데이터 소스에 안전하게 연결되어 도구를 실행하도록 지원한다.
샌드박스(Sandbox): — 외부 환경과 격리된 안전한 실행 공간. 에이전트가 코드 실행, 파일 작업 등을 수행할 때 시스템 보안을 유지하며 안전하게 작업을 처리한다.
오케스트레이션(Orchestration): — 복잡한 워크플로에서 여러 에이전트나 작업 단계를 조율하고 관리하는 과정. 리드 에이전트가 작업을 분할하고 서브 에이전트에게 위임하여 전체 프로세스를 제어한다.

기술

Claude
Python
MCP

활용 사례

에이전트 인프라 관리
자율 에이전트 배포
멀티 에이전트 오케스트레이션

언급된 리소스

API DocsAnthropic Console