본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 05. 29. 23:40

Claude Managed Agents의 AWS 대응 및 Opus 4 폐지에 따른 이행 대상 변경

요약

Anthropic이 Claude Managed Agents의 주요 기능을 AWS 환경에서 사용할 수 있도록 업데이트했습니다. 또한 Claude Opus 4 폐지에 따른 권장 이행 모델이 Opus 4.8에서 4.7로 변경되었으므로 개발자의 주의가 필요합니다.

핵심 포인트

  • Claude Managed Agents의 Webhooks, 오케스트레이션, 샌드박스 기능이 AWS 지원
  • 셀프 호스트형 샌드박스 사용 시 AnthropicSelfHostedEnvironmentAccess IAM 정책 추가 필수
  • Opus 4 폐지에 따른 이행 모델이 Opus 4.7로 변경됨 (Opus 4.8 아님)
  • 2026년 6월 15일까지 모델 ID 변경 완료 필요

2026년 5월 29일, Anthropic으로부터 두 가지 중요한 업데이트가 발표되었습니다.

첫 번째는 Claude Managed Agents의 주요 기능이 Claude Platform on AWS에서 정식으로 이용 가능해졌다는 것입니다. Webhooks, 멀티 에이전트 오케스트레이션 (Multi-agent Orchestration), 셀프 호스트형 샌드박스 (Self-hosted Sandbox)의 3가지 기능이 갖춰짐에 따라, AWS 환경에서의 에이전트 개발이 대폭 강화됩니다.

두 번째는 Claude Opus 4 폐지 시 권장 이행 대상이 변경되었다는 것입니다. Opus 4.8로의 이행을 계획하고 있던 분들은 주의가 필요합니다.

📌 영향을 받는 사람

  • AWS 상에서 Claude를 사용한 에이전트 시스템을 구축·운영하고 있는 개발자
  • claude-opus-4-20250514 또는 claude-sonnet-4-20250514를 운영 환경에서 이용하고 있는 개발자
기능개요
Webhooks에이전트의 실행 상태나 완료 이벤트를 외부 시스템으로 푸시 알림
멀티 에이전트 오케스트레이션 (Multi-agent Orchestration)여러 에이전트를 협조·병렬 동작시키는 오케스트레이션 기반
셀프 호스트형 샌드박스 (Self-hosted Sandbox)코드 실행 등을 사용자 관리의 샌드박스 환경에서 안전하게 실시

AWS 환경에서 이러한 기능들을 이용하려면 IAM 정책 (IAM Policy) 업데이트가 필요합니다.

새로운 IAM 액션 (IAM Action) 부여 -
매니지드 정책 (Managed Policy) 부착: AnthropicSelfHostedEnvironmentAccess

⚠️ 주의

기존 IAM 역할 (IAM Role)에는 AnthropicSelfHostedEnvironmentAccess 정책이 포함되어 있지 않습니다. 셀프 호스트형 샌드박스를 사용하는 경우에는 반드시 추가해야 합니다. 설정이 누락되면 샌드박스 기능 호출 시 권한 에러가 발생합니다.

⚠️ Breaking Change

claude-opus-4-20250514의 권장 이행 대상이 Opus 4.8 → Opus 4.7로 변경되었습니다. 이미 Opus 4.8로의 이행 계획을 진행 중이었다면 재검토가 필요합니다.

폐지 모델폐지일기존 권장 이행 대상신규 권장 이행 대상
claude-opus-4-202505142026-06-15claude-opus-4-8claude-opus-4-7
claude-sonnet-4-202505142026-06-15claude-sonnet-4-6claude-sonnet-4-6 (변경 없음)

IAM 정책 확인·업데이트-

  • 사용하는 기능 (Webhooks / 오케스트레이션 / 샌드박스)에 대응하는 IAM 액션이 부여되어 있는지 확인

  • 셀프 호스트형 샌드박스를 사용하는 경우 AnthropicSelfHostedEnvironmentAccess를 부착

동작 확인-

  • 스테이징 환경에서 각 기능의 통신 테스트를 실시한 후 운영 환경에 반영한다

기한: 2026년 6월 15일까지 모델 ID를 변경한다 -

  • Opus 4를 사용 중인 경우 claude-opus-4-7로 변경 (Opus 4.8이 아니라 Opus 4.7)
  • Sonnet 4를 사용 중인 경우 claude-sonnet-4-6으로 변경

💡 Tips

모델 ID를 하드코딩(Hard-code)한 부분을 일괄 검색하려면, claude-opus-4-20250514claude-sonnet-4-20250514라는 리터럴 문자열을 grep으로 검색하는 것이 확실합니다. 환경 변수나 설정 파일에 모아두지 않았다면, 이번 기회에 외부화하는 것을 검토해 보세요.

Before (셀프 호스트 샌드박스가 허용되지 않은 상태)

{
"Version": "2012-10-17",
"Statement": [
...

After (셀프 호스트 샌드박스 대응 정책을 추가한 상태)

{
"Version": "2012-10-17",
"Statement": [
...

더불어, IAM 역할에 AnthropicSelfHostedEnvironmentAccess 매니지드 정책을 부착합니다.

aws iam attach-role-policy
--role-name YourAgentRole
--policy-arn arn:aws:iam::aws:policy/AnthropicSelfHostedEnvironmentAccess

Before

import anthropic
client = anthropic.Anthropic()
response = client.messages.create(...)

After

import anthropic
client = anthropic.Anthropic()
response = client.messages.create(...)

💡 팁

모델명을 환경변수로 관리해 두면, 다음번 마이그레이션 시 코드를 변경할 필요가 없습니다. import os MODEL = os.getenv("CLAUDE_MODEL", "claude-opus-4-7")

#변경 내용대응 기한우선순위
1Claude Managed Agents의 3가지 기능이 AWS에서 사용 가능하게됨수시🟠 높음 (신규 기능 활용)
2Opus 4 폐지의 권장 마이그레이션 대상이 Opus 4.7로 변경2026-06-15
🔴 긴급 (폐지 대응)
3Sonnet 4 폐지 및 마이그레이션 대상은 Sonnet 4.6 (변경 없음)2026-06-15
🔴 긴급 (폐지 대응)

AWS에서 멀티 에이전트 시스템을 구축하고 있다면, 이번 3가지 기능 추가로 구성의 폭이 크게 넓어집니다. 한편, Opus 4 / Sonnet 4를 사용하고 있다면 6월 15일이라는 마감 기한이 다가오고 있으므로 신속한 대응을 추천합니다. 특히 Opus 4의 마이그레이션 대상은 '4.8이 아니라 4.7'이라는 점을 놓치지 않도록 주의해 주십시오.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0