
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-20250514 | 2026-06-15 | claude-opus-4-8 | claude-opus-4-7 |
claude-sonnet-4-20250514 | 2026-06-15 | claude-sonnet-4-6 | claude-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-20250514나 claude-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")
| # | 변경 내용 | 대응 기한 | 우선순위 |
|---|---|---|---|
| 1 | Claude Managed Agents의 3가지 기능이 AWS에서 사용 가능하게됨 | 수시 | 🟠 높음 (신규 기능 활용) |
| 2 | Opus 4 폐지의 권장 마이그레이션 대상이 Opus 4.7로 변경 | 2026-06-15 | |
| 🔴 긴급 (폐지 대응) | |||
| 3 | Sonnet 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가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기