클로드 매니지드 에이전트 예약 배포, AWS 지원: 바뀐 점과 지금 할 일

클로드 매니지드 에이전트 예약 배포(scheduled deployment)는 정해 둔 cron 일정마다 에이전트가 스스로 세션을 시작해 일을 하게 하는 기능이다. Anthropic은 릴리스 노트에서 2026년 10월 14일 이 기능을 AWS 계정으로 쓰는 Claude Platform on AWS에서도 쓸 수 있다고 밝혔다. 이번에 바뀐 것은 AWS 쪽 사용자도 같은 예약 배포를 쓸 수 있다는 점이다.

클로드 매니지드 에이전트 예약 배포는 무엇인가

공식 문서에 따르면 예약 배포는 에이전트가 사람이 말을 걸지 않아도 일정에 맞춰 세션을 시작하게 하는 설정이다. 배포(deployment)에는 에이전트, 환경, 첫 이벤트(user.message 또는 user.define_outcome), 일정이 들어간다. 일정이 되면 그 첫 이벤트로 새 세션이 열린다. 매니지드 에이전트가 처음이라면 매니지드 에이전트 개요에서 에이전트·환경·세션 개념을 먼저 보면 된다.

일정은 표준 POSIX cron 식과 IANA 시간대로 적고, 최소 단위는 분이다. 시간대는 현지 시각 그대로 맞춘다. 예를 들어 America/New_York의 0 20 * * *는 서머타임 여부와 관계없이 현지 저녁 8시에 돈다.

AWS에서 예약 배포를 쓸 때 달라지는 점

Claude Platform on AWS는 Anthropic이 추론을 운영하면서 인증과 결제는 AWS 계정으로 처리하는 서비스다. 여기서는 예약 실행마다 사용자 AWS 계정의 IAM 역할로 세션이 만들어진다. 그래서 배포를 만들기 전에 에이전트에 execution_identity를 {"type": "aws_role", "role_arn": "..."} 형태로 넣어야 하고, 넣지 않으면 400 오류가 난다. 역할에는 예약 배포 문서가 안내하는 아래 권한이 필요하다.

구분	필요한 설정
신뢰 정책	aws-external-anthropic.amazonaws.com 서비스 주체에 sts:AssumeRole, sts:SetSourceIdentity 허용
역할 권한	aws-external-anthropic:CreateSession, sts:GetWebIdentityToken, sts:TagGetWebIdentityToken 허용
설정하는 사람	에이전트에 역할을 지정하는 IAM 주체에 해당 역할의 iam:PassRole 필요(같은 AWS 계정의 역할이어야 함)

AWS 쪽에는 제약이 하나 더 있다. 사용자 입력 없이 자율로 도는 세션은 최대 6시간까지이고 그 뒤에는 재인증이 필요하다. 직접 Claude API를 쓰는 매니지드 에이전트에는 이 제한이 없다. 결제는 같은 문서에 따르면 AWS Marketplace에서 Claude Consumption Unit(CCU)으로 시간 단위로 집계해 매달 후불로 청구된다.

예약 배포 만드는 방법과 확인 기준

배포는 Deployments API로 만든다. 공식 예시는 매주 금요일 저녁 8시에 컴플라이언스 점검을 시키는 설정이다.

curl "https://api.anthropic.com/v1/deployments?beta=true" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -d '{
    "name": "Weekly compliance scan",
    "agent": "$AGENT_ID",
    "environment_id": "$ENVIRONMENT_ID",
    "initial_events": [{"type": "user.message",
      "content": [{"type": "text", "text": "Run the weekly compliance scan."}]}],
    "schedule": {"type": "cron", "expression": "0 20 * * 5",
      "timezone": "America/New_York"}
  }'

저장소에 파일로 관리하려면 같은 내용을 frontmatter가 있는 마크다운으로 적고 ant apply deployment.md로 올리는 방법도 공식 문서에 있다. 만든 뒤에는 응답의 schedule.upcoming_runs_at에 다음 실행 시각 목록이 채워졌는지 본다. 시각이 의도한 시간대로 나오면 일정 설정은 맞은 것이다. 실제 실행은 부하 분산을 위해 실행 간격의 최대 15%(최소 5초, 최대 9분)만큼 늦게 시작할 수 있다.

일정을 기다리지 않고 시험하려면 run 엔드포인트(ant beta:deployments run)로 수동 실행한다. 일시 정지 중에도 수동 실행은 된다. 실행 기록은 deployment_runs를 조회해 확인하며, 성공한 기록에는 session_id가, 실패한 기록에는 error.type이 들어 있다. has_error=true로 실패만 걸러 볼 수 있다.

비용과 실패에 대비하는 설정

예약 배포에는 실행마다 비용 상한을 거는 budget을 붙일 수 있다. 이 상한은 배포 전체의 누적 한도가 아니라 세션 하나하나에 복사된다. 공식 문서는 "2000" 상한이면 실행마다 약 20달러까지 쓸 수 있다고 설명한다. 그래서 실행 횟수를 곱한 월 최대치를 따로 계산해 두는 것이 좋다.

• 배포 수 한도: 공식 문서 기준 조직당 최대 1,000개이며 더 필요하면 Anthropic 지원팀에 문의한다.
• 세션 생성이 속도 제한에 걸리면(실패 동작) 재시도 없이 실패 기록만 남고 다음 일정 때 다시 시도한다.
• 환경이나 vault가 보관(archive)되면 실행이 실패로 기록되고 배포가 자동으로 일시 정지된다. 고친 뒤 직접 재개해야 하며, 놓친 실행은 소급해서 돌지 않는다.
• 에이전트를 보관하면 배포도 함께 보관되며, 보관은 되돌릴 수 없다.

시간대 때문에 놓치는 경우도 있다. 서머타임으로 존재하지 않는 시각(새벽 2시 등)은 실행되지 않고, 두 번 오는 시각은 두 번 실행된다. 공식 문서는 새벽 1~3시를 피하거나 UTC를 쓰라고 안내한다.

다이내믹 워크플로우와 함께 쓸 때

예약 배포는 언제 시작할지를 정하고, 시작된 세션 안에서 일을 쪼개는 것은 별개의 기능이다. 에이전트가 여러 에이전트를 돌리는 구조는 클로드 매니지드 에이전트 다이내믹 워크플로우 설정·한도 정리에서 설명했다. 큰 작업을 매일 밤 돌리고 싶다면 두 기능을 같은 에이전트에 붙이고, 위의 실행당 예산으로 비용 폭주를 막으면 된다.

앞으로 확인할 점

예약 배포는 공식 문서에서 베타 기능으로 분류돼 요청 형식과 한도가 바뀔 수 있다. 변경은 릴리스 노트의 매니지드 에이전트 항목에서 확인한다. Claude Platform on AWS는 공식 문서 기준으로 AWS 상용 리전 전체를 지원하며, 워크스페이스는 리전 하나에 묶인다. 한국 사용자는 예약 시각을 Asia/Seoul 시간대로 적으면 한국 시간 그대로 실행 시각을 맞출 수 있다.

지금 할 일

AWS 계정에서 쓰는 팀이라면 순서는 세 단계다. 먼저 위 표의 권한을 갖춘 IAM 역할을 만들어 에이전트의 execution_identity에 지정한다. 다음으로 budget을 걸고 배포를 만든 뒤 run으로 수동 실행해 세션이 열리는지 deployment_runs에서 본다. 마지막으로 upcoming_runs_at의 시각이 의도한 시간대와 같은지 확인하고 일정에 맡긴다.

자주 묻는 질문

예약 배포를 잠시 멈출 수 있나?

맞다. 배포를 일시 정지(pause)하면 예약 실행만 멈추고 이미 돌고 있는 세션은 계속 실행된다. 재개(unpause)하면 다음 일정부터 다시 돌며 멈춘 동안의 실행은 채워지지 않는다.

예약이 실패했는지 어디서 보나?

deployment_runs 목록을 has_error=true로 조회하면 실패한 실행의 error.type과 메시지가 나온다. 배포 상태와 일시 정지 사유는 배포 객체의 paused_reason에서 본다.