Claude Managed Agents 출시

무엇이 바뀌었나?

Anthropic이 Claude Managed Agents를 베타로 출시했습니다. 기존 Messages API와는 별도로, 사전 구축된 에이전트 하니스(harness)와 관리형 인프라를 제공합니다.

직접 에이전트 루프, 도구 실행 환경, 샌드박스를 구축할 필요 없이, Claude가 파일 읽기/쓰기, 쉘 명령 실행, 웹 검색, 코드 실행을 자율적으로 수행하는 환경을 바로 사용할 수 있습니다.

Messages API와의 차이

	Messages API	Managed Agents
성격	직접 모델 프롬프팅	관리형 에이전트 하니스
적합한 용도	커스텀 에이전트 루프, 세밀한 제어	장시간 실행, 비동기 작업
인프라	직접 구축	Anthropic이 관리

핵심 개념 (4가지)

• Agent — 모델, 시스템 프롬프트, 도구, MCP 서버, 스킬을 정의한 설정
• Environment — 패키지, 네트워크 접근, 마운트 파일이 설정된 클라우드 컨테이너 템플릿
• Session — 에이전트+환경 위에서 실행되는 인스턴스. 특정 작업을 수행하고 결과를 생성
• Events — 앱과 에이전트 간 주고받는 메시지 (사용자 입력, 도구 결과, 상태 업데이트)

작동 방식

1. Agent 생성 — 모델, 시스템 프롬프트, 도구를 정의. 한 번 만들면 ID로 재사용
2. Environment 생성 — Python, Node.js 등 패키지가 설치된 컨테이너 설정
3. Session 시작 — Agent + Environment를 참조하여 세션 실행
4. 이벤트 송수신 — 사용자 메시지를 보내면 Claude가 자율적으로 도구를 실행하고 SSE로 결과를 스트리밍
5. 중간 개입 — 실행 중에도 추가 이벤트를 보내 에이전트 방향을 조정하거나 중단 가능

내장 도구

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

어떤 경우에 적합한가?

• 장시간 실행 — 수분~수시간에 걸친 다단계 도구 호출 작업
• 클라우드 인프라 필요 — 패키지가 설치된 보안 컨테이너 환경
• 인프라 최소화 — 에이전트 루프, 샌드박스, 도구 실행 레이어를 직접 만들고 싶지 않을 때
• 상태 유지 세션 — 파일 시스템과 대화 이력이 여러 상호작용에 걸쳐 유지

과금 구조

Managed Agents는 토큰 비용 + 세션 런타임 비용 두 가지로 청구됩니다. 단순히 API 토큰 비용만 나가는 것이 아닙니다.

토큰 비용

• 일반 Messages API와 동일한 모델별 토큰 단가 적용
• 프롬프트 캐싱 할인도 동일하게 적용
• 세션 내 웹 검색은 1,000회당 $10 추가 과금

세션 런타임 비용

항목	요금	측정 기준
세션 런타임	시간당 $0.08	running 상태 지속 시간

• 밀리초 단위로 정밀 측정
• running 상태일 때만 과금 — idle(대기), rescheduling, terminated 상태는 과금되지 않음
• Code Execution의 컨테이너 시간 과금을 대체 (중복 과금 없음)

비용 예시

Claude Opus 4.6으로 1시간 코딩 세션 (입력 50K 토큰, 출력 15K 토큰):

항목	계산	비용
입력 토큰	50,000 × $5/MTok	$0.25
출력 토큰	15,000 × $25/MTok	$0.375
세션 런타임	1시간 × $0.08	$0.08
합계		$0.705

Messages API와 다른 점

다음 할인/옵션은 Managed Agents에 적용되지 않습니다:

• Batch API 할인 (세션은 상태를 유지하는 대화형이므로)
• Fast mode 프리미엄 (런타임이 추론 속도를 관리)
• Data residency 옵션
• 서드파티 플랫폼 (AWS Bedrock, Vertex AI 등) — Claude API 직접 연결만 지원

알아두면 좋은 점

• 현재 베타 단계 — 모든 엔드포인트에 managed-agents-2026-04-01 베타 헤더 필요
• SDK 사용 시 베타 헤더가 자동 설정됨
• 모든 API 계정에서 기본 활성화
• outcomes, multiagent, memory 기능은 리서치 프리뷰로 별도 신청 필요