AWS Claude Platform에서 Claude Code 사용
공식 기준: https://code.claude.com/docs/en/claude-platform-on-aws
기준일: 2026-07-26 · CLI 기준 2.1.220
개요
Claude Platform on AWS는 AWS 위에서 Anthropic Claude 플랫폼 기능을 사용하는 경로입니다. Claude Code는 환경변수와 AWS 자격증명/API 키로 이 provider에 연결합니다. 구독·워크스페이스·IAM 사전 설정은 platform 문서를 따릅니다.
핵심 개념
- 워크스페이스 ID 필수:
ANTHROPIC_AWS_WORKSPACE_ID— AWS 자격증명만으로 암시되지 않음 - 활성화 플래그:
CLAUDE_CODE_USE_ANTHROPIC_AWS(truthy, 예:1) - 인증: SigV4(AWS creds) 또는
ANTHROPIC_AWS_API_KEY(키가 있으면 SigV4보다 우선) - 우선순위: Bedrock/Foundry 플래그가 켜져 있으면 그쪽이 Claude Platform on AWS보다 우선할 수 있음
상세
구성 체크리스트
- Claude Platform on AWS 구독·워크스페이스 준비
- IAM 권한(플랫폼 IAM actions / managed policy) 부여
- 환경변수 export 후 Claude Code 시작
/status로 해석된 provider 확인
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=<workspace-id>
# SigV4: 표준 AWS credential chain
# 또는:
# export ANTHROPIC_AWS_API_KEY=<key>
API 키 vs SigV4
ANTHROPIC_AWS_API_KEY가 설정되면 키 우선. 만료·폐기 키는 SigV4로 조용히 폴백되지 않고 동일 오류를 낼 수 있음 → 콘솔에서 키 재발급 또는 unset- 키 미설정 시 AWS 자격증명으로 서명
문제 해결
| 증상 | 조치 |
|---|---|
| missing-workspace | ANTHROPIC_AWS_WORKSPACE_ID 설정 |
| 인증 실패 | IAM 액션, 키, 시계 동기화, 리전 |
요청이 api.anthropic.com으로 감 |
CLAUDE_CODE_USE_ANTHROPIC_AWS 미설정/비truthy; Bedrock/Foundry 플래그 충돌 |
| stale API key | 키 재발급 또는 unset 후 SigV4 |
기능 격차
일부 claude.ai 전용 기능(web, routines 등)은 클라우드/플랫폼 경로에서 제한될 수 있습니다. Teams/Enterprise seat 병행 필요 여부는 기능 페이지를 확인하세요. managed settings는 file/plist 또는 Claude apps gateway로 전달합니다.
체크리스트
- 워크스페이스 ID export
-
CLAUDE_CODE_USE_ANTHROPIC_AWS=1 - IAM 또는 API 키 준비
-
/statusprovider 확인 - 다른 provider 플래그 충돌 제거