Claude Managed Agents란 무엇인가?

프로덕션에서 Claude 기반 에이전트 하나를 운영하기 위해 팀이 구축해야 했던 컴포넌트를 세어봤다. 에이전트 루프, 샌드박스, 상태 지속성, 오류 복구, 자격 증명 범위 지정, 세션 추적. 여섯 가지 시스템. 그 중 네 가지는 에이전트가 실제로 하는 일과 전혀 관계가 없었다. 채널에서 누군가 “왜 이게 3개월이나 걸렸냐”고 물었는데, “배관 공사”라는 단어 외에는 딱히 좋은 답이 없었다.

Anthropic이 Claude Managed Agents를 출시한 배경이 바로 이것이다 — 공개 베타, 2026년 4월 8일부로 라이브. 이것은 새로운 모델이 아니다. Claude 5도 아니고, 새로운 Opus 변형도 아니고, 추론 업그레이드도 아니다. 이미 사용 중인 모델 위에 자리하는 관리형 런타임과 에이전트 하네스인 인프라 레이어다. 모델 릴리즈로 평가하면 무엇을 하는지 잘못 이해하게 된다. 인프라로 평가해야 왜 존재하는지 이해할 수 있다.

Claude Managed Agents란 무엇인가

새로운 모델이 아니라: 관리형 에이전트 하네스와 인프라 레이어

에이전트(모델, 시스템 프롬프트, 도구, MCP 서버, 스킬)를 정의하면 Anthropic이 실행한다. 하네스가 에이전트 루프, 도구 실행, 샌드박싱, 세션 관리, 이벤트 기록을 처리한다. 루프를 직접 구축할 필요가 없다. 런타임을 직접 관리할 필요가 없다.

Anthropic의 엔지니어링 팀은 이를 “메타 하네스”라고 설명한다 — 모델이 개선됨에 따라 미래의 하네스를 수용하도록 설계된 시스템으로, Claude가 할 수 있거나 없는 것에 대한 고정된 가정을 인코딩하지 않는다. Managed Agents 아키텍처에 관한 엔지니어링 블로그 포스트는 운영 체제가 하드웨어를 아직 존재하지 않는 프로그램에도 충분히 일반적인 추상화로 가상화한 방식에 비유한다. 그 비유가 장기적으로 유효한지는 열린 질문이다. 지금으로서는 실질적인 결론이 있다: 당신이 설정하고, Anthropic이 운영한다.

”하네스”의 의미: 도구 실행, 세션 관리, 샌드박스, 이벤트 기록

Managed Agent 세션은 Claude에게 사전 설치된 패키지(Python, Node.js, Go 등), 네트워크 접근 규칙, 마운트된 파일이 있는 클라우드 컨테이너에 대한 접근권을 부여한다. Claude는 샌드박스 환경 내에서 파일을 읽고, bash 명령을 실행하고, 웹을 탐색하고, 코드를 실행할 수 있다. 하네스는 프롬프트 캐싱과 컨텍스트 압축을 자동으로 처리한다. 이벤트 기록은 서버 측에 저장되며 전체 조회가 가능하다 — 세션이 길어져도 상태를 잃지 않는다.

공개 베타 상태: 모든 엔드포인트에 베타 헤더 필수

Managed Agents 엔드포인트에 대한 모든 API 요청에는 베타 헤더가 필요하다. SDK를 사용하는 경우 헤더가 자동으로 설정된다. curl이나 직접 HTTP 클라이언트로 API를 직접 호출하는 경우 수동으로 추가해야 한다. 빠뜨리면 요청이 실패한다. 나는 첫 시도에서 이걸 놓쳤다(오류 메시지는 명확하지만, 문서를 대충 훑어볼 때 눈에 띄지 않는 종류다).

해결하는 문제

DIY 에이전트 문제: 출시 전 수개월의 인프라 작업

이전에 프로덕션 에이전트를 구축하는 것이 어떤 모습이었는지. 모델이 있었다. 프롬프트가 있었다. 도구 정의가 있었다. 하지만 “노트북에서 동작하는” 것과 “고객에게 안정적으로 실행되는” 것 사이에는 수개월의 차별화되지 않는 인프라 작업이 있었다.

빌더들이 이전에 구축해야 했던 것: 에이전트 루프, 샌드박스, 상태 관리, 오류 복구

재시도 로직이 있는 에이전트 루프. 프로덕션 시스템에서 도구 실행을 격리하는 샌드박스. 장기 실행 세션을 위한 상태 관리. 에이전트가 중단 후 재개할 수 있는 체크포인팅. 에이전트가 경계를 초과하지 못하도록 하는 권한 범위 지정. 문제가 발생했을 때 무슨 일이 있었는지 추적하는 관찰 가능성. 어느 것도 선택 사항이 아니었다. 모든 것이 팀마다 동일했다.

Managed Agents가 추상화하는 것

위의 모든 것. 에이전트와 환경을 정의하면 Anthropic이 도구 오케스트레이션, 컨텍스트 관리, 오류 복구, 실행 추적을 처리한다. 빠른 시작 가이드는 전체 라이프사이클을 안내한다: 에이전트 생성, 환경 구성, 세션 시작, 이벤트 전송, 결과 스트리밍. 무언가를 실행하는 데 API 호출 세 번.

그렇다고 작업이 전혀 없다는 의미는 아니다. 시스템 프롬프트를 설계하고, 노출할 도구를 선택하고, 권한 경계를 설정하는 것은 여전히 해야 한다. 하지만 인프라 배관 작업은 손에서 떠난다.

주요 기능

안전한 샌드박스 코드 실행

각 세션은 격리된 클라우드 컨테이너에서 실행된다. 설치된 것, 허용된 네트워크 접근, 마운트된 파일을 구성한다. 에이전트는 그 경계 내에서 운영된다. 당신의 서버가 아니고, 당신의 위험 표면이 아니다.

지속적인 장기 실행 세션과 상태 저장 이벤트 기록

세션이 지속된다. 이벤트 기록은 서버 측에 저장되며 API를 통해 접근 가능하다. 이는 단일 턴 상호작용이 아니라 분 또는 시간 단위로 실행되는 작업을 위해 구축되었다. 세션이 중단되면 이벤트 로그를 통해 재개할 수 있다.

멀티 에이전트 조율 (리서치 프리뷰 — 별도 초대 필요)

이것이 사람들이 계속 잘못 이해하는 부분이다. 하나의 에이전트가 다른 에이전트를 생성하는 멀티 에이전트 조율은 존재하지만, 리서치 프리뷰 상태다. 결과(outcomes)와 메모리 기능도 마찬가지다. 이 기능들은 기본적으로 사용할 수 없다. 접근하려면 별도의 초대가 필요하다. 이것들이 오늘날 일반적으로 사용 가능하다고 가정하고 아키텍처를 설계하지 마라. 멀티 에이전트를 출시된 기능으로 설명하는 글을 여러 개 봤는데, 그렇지 않다.

내장 프롬프트 캐싱과 압축

하네스가 컨텍스트를 자동으로 관리한다 — 반복되는 프롬프트 내용을 캐싱하고, 세션이 길어지면 컨텍스트를 압축한다. 자체 잘라내기나 요약을 구현할 필요가 없다.

Claude Console의 세션 추적

모든 세션은 Claude Console에서 추적 가능하다. 전체 이벤트 스트림 — 에이전트가 무엇을 했는지, 어떤 도구를 호출했는지, 어떤 결과가 돌아왔는지. 프로덕션 에이전트 디버깅에 있어 이것은 기능 페이지의 대부분의 항목보다 중요하다.

다른 Claude 제품과의 관계

명칭이 헷갈린다. Anthropic은 이제 Claude로 구축하기 위한 여러 겹치는 서피스를 가지고 있다. 여기 그것들이 어떻게 매핑되는지.

Messages API: 직접 모델 접근. 프롬프트를 보내고 응답을 받는다. 하네스도 없고, 에이전트 루프도 없고, 도구 오케스트레이션도 없다. 모든 것을 직접 구축한다. 이것이 대부분의 개발자들이 표준 API를 통해 사용해온 것이다.

Claude Agent SDK: Claude Code를 구동하는 동일한 도구와 에이전트 루프를 Python/TypeScript 라이브러리로 패키징한 것. 하지만 런타임은 직접 관리한다. 당신의 인프라, 당신의 스케일링, 당신의 샌드박싱.

Claude Managed Agents: Anthropic이 루프 및 런타임 모두를 관리한다. 당신이 구성하면, 그들이 운영한다. Agent SDK와의 차이는 기능이 아니라 — 인프라를 누가 소유하느냐다.

Claude Code / Cowork: API 프리미티브가 아닌 최종 사용자 제품. Code는 에이전틱 코딩 어시스턴트다. Cowork는 데스크톱 지식 작업을 처리한다. 동일한 에이전트 패턴을 기반으로 구축되었지만, 구성 요소가 아닌 완성된 제품이다.

멘탈 모델: Messages API는 원재료다. Agent SDK는 자체 작업장에서 실행하는 도구 키트다. Managed Agents는 호스팅된 작업장이다. Code와 Cowork는 완성품이다.

주목해야 할 대상

전용 인프라 없이 장기 실행 또는 비동기 에이전트를 출시하는 팀

샌드박스와 세션 인프라를 아무도 소유하고 싶지 않아서 에이전트 기능을 미루고 있었다면 — 이것이 바로 당신을 위한 것이다. Anthropic의 속도 제한 문서는 Managed Agents 엔드포인트가 Messages API와 별도로 속도 제한됨을 확인한다. 즉, 기존 API 사용이 에이전트 세션을 방해하지 않는다는 의미다.

기본 제공 샌드박싱과 권한이 필요한 엔터프라이즈 팀

Managed Agents는 범위가 지정된 권한, 신원 관리, 실행 추적과 함께 출시된다. “자체 샌드박스를 구축했다”가 규정 준수를 충족하지 않는 규제된 환경에서는 Anthropic이 해당 레이어를 관리하게 하면 위험의 한 범주가 제거된다.

하네스 작업을 건너뛰고 에이전트를 프로토타이핑하는 빌더

아직 “이 에이전트 개념이 작동하는가” 단계인가? API 세 번 호출로 실행 중인 세션이 된다. 이것은 첫 실험까지의 시간을 실질적으로 줄여준다.

현재 한계

베타 헤더 필수:

모든 요청에 필요하다. SDK는 자동으로 처리한다. 수동 API 호출은 그렇지 않다. 이것은 베타 제품이다 — 릴리즈 사이에 동작이 변경될 수 있다.

결과 / 멀티에이전트 / 메모리: 리서치 프리뷰만, 별도 초대 필요

이 기능들은 Anthropic을 통해 별도의 접근 승인이 필요하다. 기본 공개 베타의 일부가 아니다. 그에 맞게 계획하라.

속도 제한: 생성 엔드포인트 분당 60회, 읽기 엔드포인트 분당 600회, 조직 수준 지출 한도 추가

Managed Agents 엔드포인트는 자체 속도 제한이 있으며, Messages API 한도와 별개다. 생성 엔드포인트(에이전트, 환경, 세션): 분당 60회. 읽기 엔드포인트(세션 상태, 이벤트 가져오기): 분당 600회. 조직 수준 지출 한도와 티어 기반 속도 제한이 추가로 적용된다. 프로토타이핑과 초기 프로덕션에는 문제없다. 수백 개의 동시 세션을 계획하고 있다면 이 수치를 일찍 용량 계획에 반영하라.

FAQ

Claude Managed Agents는 무료로 사용할 수 있나요?

아니다. 모델 사용에 대해 표준 Claude API 토큰 가격을 지불하고, 활성 런타임에 대해 세션-시간당 $0.08을 추가로 지불한다(유휴 시간 제외). 세션 내 웹 검색은 1,000회 검색당 $10이다. Managed Agents에는 무료 티어가 없다 — API 접근 권한과 크레딧이 필요하다.

Claude Opus 4.6 및 Sonnet 4.6과 함께 작동하나요?

예. 에이전트를 생성할 때 모델을 지정한다. claude-opus-4-6과 claude-sonnet-4-6 모두 지원된다. 심층 추론 작업에는 Opus, 대부분의 프로덕션 워크로드에 필요한 속도-비용 균형에는 Sonnet이다.

Managed Agents와 Claude Agent SDK의 차이점은 무엇인가요?

기능 면에서는 비슷하다 — 동일한 도구, 동일한 에이전트 루프 패턴. 차이점은 운영 방식이다. Agent SDK: 자체 인프라에서 에이전트를 실행한다. Managed Agents: Anthropic이 런타임을 호스팅하고 운영한다. 완전한 제어 대 인프라 작업 건너뛰기.

오늘 프로덕션에서 Claude Managed Agents를 사용할 수 있나요?

공개 베타는 모든 API 사용자가 접근 가능하다. 하지만 베타다. 동작이 변경될 수 있다. 리서치 프리뷰 기능(멀티 에이전트, 결과, 메모리)은 일반적으로 사용 가능하지 않다. 프로덕션의 경우, 현재 안정적인 기능 세트를 평가하고 반복을 위한 계획을 세워라.

사용하려면 특별한 베타 헤더가 필요한가요?

예. 모든 API 호출에 anthropic-beta: managed-agents-2026-04-01 헤더가 필요하다. SDK는 자동으로 설정한다. 원시 HTTP 요청은 수동으로 추가해야 하며, 그렇지 않으면 호출이 거부된다.

이전 포스트: