Claude Managed Agents 사용법 — 예약 자동화 세팅 가이드

Claude Managed Agents 사용법을 정리하면, 이 기능은 Anthropic이 관리하는 인프라 위에서 Claude를 자율 에이전트로 실행하는 호스팅 서비스입니다. 예약 자동화가 필요하다면 Scheduled Deployments 기능으로 크론 스케줄을 걸면 됩니다.

Claude Managed Agents란 무엇인가요?

Claude Managed Agents는 자체 에이전트 루프와 샌드박스를 만들지 않아도, Anthropic이 관리하는 환경에서 Claude가 파일을 읽고 명령을 실행하고 웹을 탐색하도록 지원하는 완전관리형 하네스입니다. Anthropic 공식 개요 문서는 이 기능을 몇 분에서 몇 시간까지 이어지는 장시간 실행 작업과 비동기 작업에 가장 적합하다고 설명합니다.

세션은 상태를 유지하도록 설계돼 있어, 일시 중지 후에도 깔끔하게 재개됩니다. 다만 이 때문에 현재 Zero Data Retention이나 HIPAA BAA 적용 대상은 아닙니다. 개인정보나 규제 데이터를 다루는 업무라면 이 부분을 먼저 확인해야 합니다.

모든 Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. 아직 공개 베타 단계라 릴리스마다 세부 동작이 조정될 수 있습니다.

예약 자동화(Scheduled Deployments)는 어떻게 설정하나요?

예약 자동화는 에이전트 배포에 크론 표현식과 타임존을 지정하는 방식으로 설정합니다. 공식 Scheduled deployments 문서에 따르면, 배포를 만들 때 표준 크론 표현식(분·시·일·월·요일 5필드)과 IANA 타임존을 함께 지정하며, 지원되는 최대 정밀도는 분 단위입니다.

스케줄이 발동할 때마다 에이전트는 새 세션을 시작해 작업을 처음부터 실행합니다. 조직당 최대 1,000개의 예약 배포가 지원되며, 그 이상은 Anthropic 지원팀에 문의해야 합니다. 부하 분산을 위해 최대 10초의 지터(jitter)가 적용될 수 있습니다.

배포는 일시중지(pause)·재개(unpause)·보관(archive)할 수 있고, run 엔드포인트로 스케줄과 무관하게 수동 실행해 테스트할 수 있습니다. 다만 보관(archive)은 되돌릴 수 없는 작업이라는 점에 유의해야 합니다. 아카이브된 리소스는 읽기 전용이 되고 이후 복원할 수 없으므로, 일시적으로 멈추려는 목적이라면 archive가 아니라 pause를 써야 합니다. 서머타임 전환 구간(오전 1~3시)에 스케줄을 걸면 실행이 누락되거나 중복될 수 있어, 이 시간대를 피하거나 UTC 기준으로 설정하는 편이 안전합니다.

Vault 환경변수로 인증 정보는 어떻게 안전하게 관리하나요?

Vault는 세션이 참조하는 자격증명 저장소로, OAuth 토큰과 정적 베어러 토큰 외에 환경변수 자격증명까지 저장할 수 있습니다. 공식 Vault 인증 문서에 따르면 자격증명은 세션과 별개로 관리되며, 워크스페이스 단위로 범위가 지정됩니다.

에이전트 사용법 관점에서 중요한 점은, 세션 생성 시 vault_ids를 전달하면 실제 비밀값이 아니라 참조만 전달된다는 것입니다. Anthropic 공식 발표에 따르면, 세션이 시작되면 샌드박스에는 자리표시자(placeholder) 값만 주어지고, 실제 자격증명은 요청이 샌드박스를 벗어나는 네트워크 경계(egress)에서 치환됩니다. 즉 모델 자체는 실제 API 키를 한 번도 보지 않습니다.

다만 조건이 있습니다. 환경변수 방식은 자격증명을 아웃바운드 HTTP 요청에 실어 보내는 CLI·도구에서 동작합니다. 키가 HTTP 요청에 포함돼야 네트워크 경계에서 치환할 수 있기 때문입니다. Anthropic은 이런 방식으로 동작하는 CLI가 대부분이라고 설명하며, 검증된 예시로 Browserbase·KERNEL·Notion·Ramp·Sentry의 CLI를 듭니다. 다섯 개로 한정된 화이트리스트가 아니라 대표 예시라는 점에 유의하세요. 반대로 키를 HTTP 요청으로 전송하지 않는 도구라면 이 방식이 맞지 않을 수 있으며, 그럴 때는 MCP OAuth·정적 베어러 토큰을 쓰거나, 자체 호스팅 샌드박스에서는 비밀값을 호스트 측에 두는 커스텀 도구 패턴을 검토하는 편이 낫습니다.

요금은 얼마나 나오나요?

요금은 표준 API 토큰 비용에 세션 실행 시간당 $0.08가 추가되는 구조입니다. 공식 Pricing 문서에 따르면 이 실행 시간 과금은 밀리초 단위로 측정되며, 세션 상태가 running일 때만 발생하고 대기(idle)·재스케줄링·종료 상태에서는 과금되지 않습니다.

예를 들어 실행에 20분이 걸린 세션이라면 실행 시간 과금은 $0.08 × (20/60)로 약 $0.027 수준입니다. 대부분의 워크로드에서는 토큰 비용이 실행 시간 과금보다 훨씬 큰 비중을 차지합니다. 웹 검색 도구를 호출하면 검색 1,000건당 $10가 별도로 부과됩니다.

예약 자동화가 꼭 필요하지 않고 claude.ai 구독 범위 안에서 처리해도 되는 반복 작업이라면, Claude Code의 Routines 기능이 대안이 될 수 있습니다. Routines는 별도 세션 실행 과금 없이 Pro·Max·Team·Enterprise 구독 사용량 안에서 스케줄을 겁니다. 저장소·커넥터를 하나의 Claude Code 설정으로 묶어 실행하는 방식이라, 코드·워크스페이스 중심의 반복 작업에는 이쪽이 더 간단할 수 있습니다.

언제 쓰고 언제 쓰지 말아야 하나요?

결론부터 말하면, API 기반으로 팀 인프라에 통합되는 반복 업무 자동화에는 효과적이지만, 이벤트 기반 트리거나 규제 데이터가 얽힌 업무에는 아직 부적합합니다.

효과적인 영역은 명확합니다. 야간 데이터 동기화, 주간 리포트 생성, 정기 모니터링처럼 시간 기반으로 반복되는 작업이 여기에 해당합니다. Anthropic 공식 발표에서도 라쿠텐(Rakuten) 같은 사례가 스프레드시트 분석과 보고서 생성을 주간·월간 스케줄로 자동화하는 데 이 기능을 쓰고 있다고 소개합니다.

반대로 부적합한 영역도 있습니다. 크론 스케줄링은 시간 기반이라, 파일 업로드나 웹훅 같은 이벤트가 발생할 때 즉시 반응하는 용도로는 맞지 않습니다. 또 세션이 서버 측에 대화 기록과 상태를 저장하는 구조라, Zero Data Retention이나 HIPAA BAA가 필요한 업무에는 현재 사용할 수 없습니다. 아직 공개 베타 단계라는 점도 프로덕션 적용 전 반드시 감안해야 합니다.

Claude Managed Agents 사용법을 요약하면, 예약 자동화는 Scheduled Deployments로 크론을 걸고 인증은 Vault로 분리하는 구조입니다. 세션 실행 시간당 $0.08와 표준 토큰 비용이 청구되며, 조직당 1,000개 배포 한도가 있습니다. 다만 이벤트 기반 트리거를 지원하지 않고, Zero Data Retention·HIPAA BAA 대상이 아니며, 환경변수 Vault는 자격증명을 HTTP 요청으로 전송하는 도구에서 동작한다는 기술적 조건이 있습니다. 공식 근거로 확인한 핵심과 한계만 정리합니다. 규제 데이터나 실시간 이벤트 반응이 필요한 업무라면 도입 전 이 한계부터 검토하는 편이 안전합니다.