AWS 기반 Claude Platform

AWS 기반 Claude Platform은 Messages API, Agent Skills, 코드 실행 및 베타 기능을 포함한 완전한 Anthropic 플랫폼 경험을 AWS 계정을 통해 제공합니다. AWS가 추론 스택을 운영하는 Amazon Bedrock과 달리, AWS 기반 Claude Platform은 Anthropic이 운영합니다. AWS는 인증 계층(SigV4 또는 API 키), IAM 기반 액세스 제어, AWS Marketplace를 통한 결제 통합을 제공합니다.

플랫폼 통합 작동 방식

Claude 모델은 Anthropic이 관리하는 인프라에서 실행됩니다. 이는 AWS를 통한 결제 및 액세스를 위한 상업적 통합입니다. Anthropic은 추론 입력 및 출력에 대한 데이터 처리자이며, AWS는 마켓플레이스 모델에 따라 결제 및 ID 메타데이터를 처리합니다. AWS 기반 Claude Platform을 통해 Claude를 사용하는 고객은 Anthropic의 데이터 사용 약관의 적용을 받습니다. Anthropic은 업계 최고 수준의 안전성 및 데이터 약속을 계속 제공합니다.

다음 운영 특성에 유의하세요. 데이터가 AWS에 상주하지 않을 수 있으며, 추론이 Anthropic의 기본 클라우드로 라우팅될 수 있고, 하위 서비스가 사전 통지 없이 내부적으로 변경될 수 있습니다. 추론을 특정 지역에 고정하려면 요청별로 inference_geo 매개변수를 설정하세요.

AWS 기반 Claude Platform은 퍼스트파티 Claude API와 동일한 데이터 보존 정책을 따릅니다. "Zero Data Retention"(데이터 무보존), 즉 ZDR은 요청 시 사용할 수 있습니다. 조직에서 이를 활성화하려면 Anthropic 계정 담당자에게 문의하세요.

AWS 기반 Claude Platform과 Amazon Bedrock 비교

두 제품 모두 AWS를 통해 Claude를 사용할 수 있지만, 아키텍처, API 표면 및 기능 가용성에서 크게 다릅니다.

AWS가 운영하는 Claude가 필요한 경우 Amazon Bedrock의 Claude를 참조하세요. AWS 기반 Claude Platform은 퍼스트파티 Claude API 및 Amazon Bedrock과 별도의 용량 풀을 사용합니다. 여러 플랫폼에서 워크로드를 실행하고 플랫폼 간에 장애 조치(failover)할 수 있습니다.

AWS PrivateLink는 VPC를 AWS 기반 Claude Platform 엔드포인트에 연결하는 데 지원됩니다.

Bedrock을 선택해야 하는 경우: FedRAMP High, IL4, IL5 또는 HIPAA 준비 규정 준수가 필요하거나 AWS가 유일한 데이터 처리자여야 하는 규제 산업의 조직은 Amazon Bedrock의 Claude를 사용해야 합니다. Bedrock은 AWS가 운영 주체로서 전적으로 AWS가 제어하는 인프라에서 실행됩니다.

계정 설정

AWS 기반 Claude Platform 설정은 네 단계로 진행됩니다. AWS Console 서비스 페이지에서 가입하고, Anthropic 조직 설정을 완료하고, 워크스페이스 ID를 기록하고, Claude Console에 로그인합니다.

계정 설정 문제 해결

• "Sign-up failed: Failed to enable OutboundWebIdentityFederation": 첫 제출 시 이 배너가 표시되면 Continue를 다시 선택하세요. IAM 활성화가 적용되는 데 잠시 시간이 걸릴 수 있습니다.
• 가입 중 진행률 표시기가 없음: 가입에는 몇 분이 소요됩니다. AWS가 계정을 프로비저닝하는 동안 페이지에 진행률 표시줄 없이 정적인 Sign-up in progress 배너가 표시됩니다.
• 설정 링크를 따른 후 "Signed in as a different account" 표시: Log out and continue를 선택하세요. 페이지가 입력한 이메일 주소로 다시 인증합니다.
• 로그인 중 "Not found" 메시지: 이 메시지는 리디렉션 중에 잠시 나타날 수 있습니다. 무시해도 됩니다.
• 첫 API 호출 후 사용량 페이지에 데이터가 표시되지 않음: 사용량 데이터가 Claude Console에 표시되는 데 몇 분이 걸릴 수 있습니다.

API 호출 전 준비 사항

다음 사항을 확인하세요.

1. AWS 기반 Claude Platform 구독이 있는 활성 AWS 계정(계정 설정 참조)
2. AWS CLI 설치 및 구성 완료
3. AWS 계정에서 아웃바운드 웹 ID 페더레이션 활성화(일회성 설정 단계, 아웃바운드 웹 ID 페더레이션 활성화 참조)
4. 워크스페이스 ID(워크스페이스 ID 확인 참조)

아웃바운드 웹 ID 페더레이션 활성화

AWS 기반 Claude Platform 게이트웨이는 서버 측에서 sts:GetWebIdentityToken을 호출하여 Anthropic에 전달할 JWT를 발급합니다. 이 STS 기능은 모든 AWS 계정에서 기본적으로 비활성화되어 있습니다. 계정당 한 번 활성화하세요.

aws iam enable-outbound-web-identity-federation

응답이 [ERROR] (FeatureEnabled) ... already enabled인 경우, 해당 설정이 이미 계정에서 활성화되어 있으므로 다음 단계로 진행할 수 있습니다. 계정의 발급자 URL을 확인하고 가져오세요.

aws iam get-outbound-web-identity-federation-info

워크스페이스 ID 확인

계정 설정을 완료한 후 AWS Console에서 워크스페이스를 생성합니다(계정 설정 참조). 워크스페이스는 단일 AWS 리전에 바인딩됩니다. 워크스페이스 ID는 Claude Console의 Workspaces 또는 AWS Console 서비스 페이지의 Workspaces 섹션에서 찾을 수 있습니다.

SDK 클라이언트가 자동으로 읽을 수 있도록 ANTHROPIC_AWS_WORKSPACE_ID 및 AWS_REGION 환경 변수를 설정하세요.

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'  # Your workspace's AWS region

리전은 필수입니다. 리전이 설정되지 않으면 SDK 클라이언트가 오류를 발생시킵니다. 생성자에 aws_region/awsRegion을 전달하거나 AWS_REGION(또는 AWS_DEFAULT_REGION)을 설정하세요. 모든 AWS 상용 리전이 지원됩니다.

인증

AWS 기반 Claude Platform은 두 가지 인증 방법을 지원합니다. SigV4 요청 서명을 사용하는 AWS IAM(기본)과 API 키 인증입니다. 둘 다 동일한 기본 URL과 요청 형식을 사용합니다.

SigV4 인증

SigV4는 엔터프라이즈 네이티브 경로이며 기존 AWS IAM 정책, 역할 및 감사와 통합됩니다. AWS 기본 자격 증명 공급자 체인에서 지원하는 방법을 사용하여 AWS 자격 증명을 구성하세요.

• 환경 변수(AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)
• 공유 자격 증명 파일(~/.aws/credentials)
• SSO 및 credential_process를 포함한 공유 구성 파일(~/.aws/config)
• IRSA 및 GitHub Actions용 웹 ID(AWS_WEB_IDENTITY_TOKEN_FILE 및 AWS_ROLE_ARN)
• ECS 컨테이너 자격 증명
• EC2 인스턴스 메타데이터 서비스(IMDS)

자격 증명이 작동하는지 확인하세요.

aws sts get-caller-identity

API 키 인증

더 간단한 통합 경로(로컬 개발 및 스크립트)의 경우 SigV4 대신 API 키로 인증할 수 있습니다. ANTHROPIC_AWS_API_KEY 환경 변수를 설정하거나 SDK 생성자에 apiKey를 전달하세요.

AWS Console의 Claude Platform on AWS → API keys에서 API 키를 생성하세요. Generate a key를 선택한 다음 키 값을 복사합니다. API 키 인증을 사용할 수 있어야 하는 보안 주체에 aws-external-anthropic:CallWithBearerToken IAM 작업을 부여하세요.

단기 API 키

자격 증명을 별도의 프로세스(LLM 게이트웨이, 서버리스 함수, 또는 베어러 토큰 인증은 지원하지만 SigV4는 지원하지 않는 도구 등)에 전달해야 하는 워크로드의 경우, AWS Console에서 장기 키를 프로비저닝하는 대신 AWS 자격 증명에서 단기 API 키를 생성하세요.

AWS는 JavaScript, Python, Java용 토큰 생성기 라이브러리를 게시합니다. 각 라이브러리는 표준 공급자 체인을 통해 AWS 자격 증명을 읽고 x-api-key 헤더와 함께 작동하는 시간 제한 토큰을 반환합니다. 토큰 수명은 기본적으로 12시간이며, 요청한 기간, AWS 자격 증명의 만료 시간, 12시간 중 가장 짧은 값으로 제한됩니다. 설치 및 전체 구성 옵션은 링크된 리포지토리 README를 참조하세요.

생성된 토큰을 AWS Console에서 생성한 API 키를 전달하는 것과 동일한 방식으로 SDK에 전달하세요.

from token_generator_for_aws_external_anthropic import TokenGenerator
from anthropic import AnthropicAWS

token = TokenGenerator(region="us-west-2").get_token()

client = AnthropicAWS(api_key=token, aws_region="us-west-2")

로컬에서 토큰을 생성할 수 있다면 프로세스에 이미 SigV4 자격 증명이 있으므로 일반적으로 SigV4 인증이 더 간단한 선택입니다. API 호출을 수행하는 프로세스가 AWS 자격 증명을 보유한 프로세스와 별개인 경우 단기 키를 사용하세요.

SDK는 단기 키를 자동으로 갱신하지 않습니다. 토큰이 만료되면 새 토큰을 생성하고 새 클라이언트를 구성하세요. 토큰을 사용하는 보안 주체는 여전히 aws-external-anthropic:CallWithBearerToken IAM 작업이 필요합니다.

자격 증명 우선순위

플랫폼별 클라이언트는 다음 순서로 인증을 확인합니다. 인수 이름은 언어 규칙에 따라 다릅니다(TypeScript 및 PHP는 표시된 대로 camelCase를 사용하고, Python 및 Ruby는 snake_case를 사용하며, Go는 대문자 약어가 포함된 PascalCase를 사용하고, C# 및 Java는 해당 언어의 속성 또는 빌더 관용구를 사용합니다).

1. apiKey 생성자 인수 → x-api-key 헤더
2. awsAccessKey + awsSecretAccessKey 생성자 인수 → AWS SigV4
3. awsProfile 생성자 인수 → 명명된 프로필을 사용한 AWS SigV4
4. ANTHROPIC_AWS_API_KEY 환경 변수 → x-api-key 헤더
5. 기본 AWS 자격 증명 공급자 체인 → AWS SigV4

리전 확인

클라이언트는 aws_region/awsRegion이 생성자에 전달되지 않은 경우 환경에서 AWS_REGION을 읽으며, 표준 AWS SDK와의 호환성을 위해 AWS_DEFAULT_REGION으로 폴백합니다. 리전은 필수이며 폴백 기본값이 없습니다. us-east-1로 폴백하는 AnthropicBedrock과 달리, AnthropicAWS/AnthropicAws 클라이언트는 생성자 인수와 환경 변수가 모두 설정되지 않은 경우 오류를 발생시킵니다.

SDK 설치

Anthropic의 클라이언트 SDK는 AWS 기반 Claude Platform을 지원합니다. 각 SDK는 SigV4 서명, 리전 기반 기본 URL 구성 및 anthropic-workspace-id 헤더를 처리하는 플랫폼별 클라이언트 클래스를 제공합니다.

사용 가능한 모델

AWS 기반 Claude Platform에서 사용할 수 있는 모델은 다음과 같습니다.

모델 ID는 퍼스트파티 Claude API와 동일합니다. Bedrock 스타일 ARN이나 anthropic. 접두사가 없습니다.

새 모델은 퍼스트파티 Claude API와 동시에 AWS 기반 Claude Platform에서 출시됩니다.

요청 보내기

AWS 기반 Claude Platform은 퍼스트파티 Claude API와 동일한 API 엔드포인트를 사용합니다. 차이점은 기본 URL, 인증 방법, 그리고 요청이 대상으로 하는 워크스페이스를 식별하는 필수 anthropic-workspace-id 헤더입니다.

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

클라이언트는 환경에서 AWS_REGION(또는 AWS_DEFAULT_REGION) 및 ANTHROPIC_AWS_WORKSPACE_ID를 읽습니다. 생성자에 aws_region / awsRegion 또는 workspace_id / workspaceId를 전달하여 둘 중 하나를 재정의할 수 있습니다. 리전과 워크스페이스 ID는 모두 필수입니다. 워크스페이스 ID를 확인할 수 없으면 생성자가 오류를 발생시키며, 리전이 누락된 경우에도 마찬가지로 오류가 발생합니다.

--aws-sigv4 값은 aws:amz:<region>:<service> 형식을 따릅니다. SigV4 서비스 이름은 aws-external-anthropic이며, 리전은 엔드포인트 URL의 리전과 일치해야 합니다. 둘 중 하나라도 일치하지 않으면 구체적인 진단 메시지가 아닌 일반적인 서명 거부 오류가 발생합니다.

컨텍스트 윈도우

AWS 기반 Claude Platform의 "context window"(컨텍스트 윈도우) 크기는 퍼스트파티 Claude API와 동일합니다. 모델별 제한은 컨텍스트 윈도우를 참조하세요.

기능 지원

AWS 기반 Claude Platform은 Claude API 엔드포인트를 직접 사용하므로 퍼스트파티 Claude API와 완전한 기능 패리티를 제공합니다(기능 제한 사항에 명시된 경우 제외).

• 기능 액세스: Anthropic이 두 플랫폼을 모두 운영하므로 대부분의 새 기능과 베타 헤더는 별도의 통합 단계 없이 AWS 기반 Claude Platform에서 사용할 수 있습니다. 예외 사항은 기능 제한 사항을 참조하세요.
• 베타 기능: Claude API와 마찬가지로 표준 anthropic-beta 헤더를 전달하여 베타 기능에 액세스하세요.
• Agent Skills: Claude API와 동일한 container.skills 매개변수 및 베타 헤더로 사전 구축 및 사용자 지정 Agent Skills를 사용하세요. 모든 사전 구축 Skills(PowerPoint, Excel, Word, PDF)가 즉시 작동합니다.
• 코드 실행: 코드 실행 도구를 사용하여 Anthropic의 관리형 샌드박스에서 코드를 실행하세요.
• 도구 사용: 컴퓨터 사용 및 기타 모든 도구 사용 기능을 사용할 수 있습니다.
• 확장 사고: Claude API와 동일한 매개변수로 "extended thinking"(확장 사고)을 활성화하세요.
• 스트리밍: 실시간 응답을 위한 완전한 SSE 스트리밍 지원.
• 배치 처리: 고처리량 워크로드를 위한 배치 요청을 제출하세요.
• 프롬프트 캐싱: 도구, 시스템 프롬프트 및 메시지 기록을 캐시하여 "latency"(지연 시간)와 비용을 줄이세요. 모든 "prompt caching"(프롬프트 캐싱) 기능(5분 TTL, 1시간 TTL, 자동 캐싱)을 사용할 수 있습니다.
• Files API: 요청 간에 파일을 업로드하고 참조하세요.
• 고객 관리형 암호화 키(CMEK): CMEK는 AWS KMS 키로만 사용할 수 있으며, Google Cloud KMS 및 Azure Key Vault 키는 등록할 수 없습니다. Claude Console에서 키를 생성, 검증 및 연결하세요. external_keys Admin API 엔드포인트는 현재 사용할 수 없습니다. 키는 연결된 워크스페이스와 동일한 AWS 리전에 있어야 합니다.
• Compliance API: Compliance API를 사용할 수 있습니다. 액세스는 AWS IAM을 통해 승인됩니다.

Amazon Bedrock과의 기능 가용성 차이는 비교 표를 참조하세요.

Claude Managed Agents

Claude Managed Agents는 AWS 기반 Claude Platform에서 사용할 수 있으며, 에이전트, 환경, 세션, 자격 증명 볼트, 메모리 저장소, 웹훅, 멀티에이전트 오케스트레이션, 자체 호스팅 샌드박스를 포함합니다.

AWS 기반 Claude Platform의 세션 동작은 퍼스트파티 Claude Managed Agents와 한 가지 점에서 다릅니다.

• 자율 세션 재인증: 세션은 사용자 이벤트 없이 최대 6시간 동안 자율적으로 실행될 수 있습니다. 6시간 후에는 세션을 계속하기 전에 재인증이 필요합니다. 재인증하려면 세션에 사용자 역할 이벤트를 보내세요(이벤트 및 스트리밍 참조). 퍼스트파티 Claude Managed Agents에는 자율 세션 런타임 제한이 없습니다.

지원되지 않는 기능

다음 기능은 현재 AWS 기반 Claude Platform에서 사용할 수 없습니다.

• HIPAA 준비: Anthropic의 HIPAA 준비 프로그램은 사용할 수 없습니다. API 및 데이터 보존을 참조하세요.

• Admin API: 워크스페이스 엔드포인트(/v1/organizations/workspaces에서 생성, 조회, 목록, 업데이트, 보관)는 사용할 수 있습니다. 기타 Admin API 엔드포인트(조직 구성원, 워크스페이스 구성원, 초대, API 키, 사용량 보고서, 비용 보고서, 속도 제한 보고서, 외부 키)는 현재 사용할 수 없습니다. 대신 Claude Console에서 CMEK 키를 관리하세요. 대신 Claude Console에서 사용량 및 비용 데이터를 확인하세요. AWS IAM이 조직 멤버십을 관리합니다.
• 워크스페이스 구성원 관리: 개별 워크스페이스에서 사용자를 추가하거나 제거하는 기능은 사용할 수 없습니다. 워크스페이스 ARN에 대한 AWS IAM 정책이 액세스를 제어합니다.
• 지출 한도: 사용할 수 없습니다. 대신 AWS 결제 제어를 사용하세요.
• Claude Code 워크스페이스 및 Analytics API: 자동 속도 제한이 있는 Claude Code 워크스페이스는 사용할 수 없습니다. Claude Code 사용량은 전용 화면이 아닌 일반 사용량 보기에 표시됩니다.
• OAuth 인증: 지원되지 않습니다. SigV4 또는 API 키 인증을 사용하세요.
• Fast 모드: AWS 기반 Claude Platform에서 사용할 수 없습니다.
• OpenAI 호환 API 엔드포인트: AWS 기반 Claude Platform에서 사용할 수 없습니다.
• 자체 호스팅 샌드박스 작업 목록 엔드포인트: 자체 호스팅 샌드박스의 대기 중인 작업을 나열하는 GET /v1/environments/{id}/work 엔드포인트는 현재 사용할 수 없습니다. 다른 작업 엔드포인트(poll, ack, heartbeat, stop, post results, 항목별 get, stats)는 정상적으로 작동합니다.
• MCP 터널: 공용 인터넷을 통해 노출된 MCP 서버만 지원됩니다.

데이터 상주

AWS 기반 Claude Platform은 다음 추론 지역을 지원합니다.

• US: 추론이 미국 데이터 센터 내에 유지됩니다. 1.1배 가격 승수가 적용됩니다.
• Global: 추론이 전 세계 Anthropic 운영 데이터 센터로 라우팅될 수 있습니다. 표준 가격이 적용됩니다.

inference_geo 매개변수를 사용하여 요청별로 추론 지역을 설정하세요.

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    inference_geo="us",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

inference_geo를 생략하면 요청은 워크스페이스의 default_inference_geo가 구성된 경우 이를 사용하고, 그렇지 않으면 global을 사용합니다.

워크스페이스 수준 추론 지역 제어(allowed_inference_geos 및 default_inference_geo)도 AWS 기반 Claude Platform에서 사용할 수 있습니다. 워크스페이스 수준 제한을 참조하세요.

워크스페이스

AWS 기반 Claude Platform의 추론 및 리소스 요청은 워크스페이스를 대상으로 합니다. 이러한 API 호출에서 anthropic-workspace-id 헤더에 워크스페이스 ID를 전달합니다. 워크스페이스 ID는 wrkspc_ 뒤에 영숫자 식별자가 오는 태그 형식을 사용합니다(예: wrkspc_01AbCdEf23GhIj). 아직 ID가 없는 경우 워크스페이스 ID 확인을 참조하세요.

워크스페이스 범위 지정

워크스페이스는 단일 AWS 리전에 바인딩됩니다. us-west-2에서 생성된 워크스페이스는 us-west-2 엔드포인트를 통해서만 액세스할 수 있습니다. 사용량, 할당량, 비용, 파일, 배치 및 Skills는 모두 워크스페이스별로 집계되어 Claude Console에서 리전별 분석을 제공합니다.

워크스페이스는 또한 AWS 기반 Claude Platform의 기본 IAM 리소스 역할을 합니다. 워크스페이스 ARN을 사용하여 AWS IAM 정책을 통해 특정 워크스페이스에 대한 액세스를 허용하거나 거부합니다. ARN의 리소스 세그먼트는 anthropic-workspace-id 헤더에 전달하는 것과 동일한 wrkspc_ 접두사 ID입니다.

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

예를 들면 다음과 같습니다.

arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj

정책 예제는 IAM 정책을 참조하세요.

워크스페이스 관리

AWS Console Workspaces 페이지 또는 Admin API 워크스페이스 엔드포인트를 사용하여 추가 워크스페이스를 생성하거나, 워크스페이스 이름을 변경하거나, 워크스페이스를 보관하세요. 새 워크스페이스는 생성을 위해 호출하는 엔드포인트의 AWS 리전에 바인딩됩니다(워크스페이스 범위 지정 참조). Claude Console Workspaces 페이지는 읽기 전용입니다.

Claude Console 사용

AWS 기반 Claude Platform은 platform.claude.com의 표준 Claude Console을 사용합니다. AWS Console에서 로그인하면 Claude Console 사이드바 왼쪽 하단에 Account managed by AWS 표시기가 나타나고 Console이 AWS 기반 Claude Platform 조직으로 범위가 지정됩니다. 사용량 분석, 비용 분석, 속도 제한 가시성, 워크스페이스 가시성, 그리고 파일, Agent Skills, 배치 작업 및 Claude Managed Agents 리소스(에이전트, 세션, 환경, 자격 증명 볼트, 메모리 저장소, 웹훅)를 관리하기 위한 페이지를 제공합니다.

로그인

Claude Console에 대한 액세스는 AWS IAM을 통해 페더레이션됩니다. 전체 최초 로그인 흐름은 계정 설정을 참조하세요. 요약하면 다음과 같습니다.

1. aws-external-anthropic:AssumeConsole 권한이 있는 IAM 역할을 수임합니다. AWS 기반 Claude Platform의 IAM 작업을 참조하세요.
2. AWS Console에서 Claude Platform on AWS 페이지로 이동합니다.
3. Open Claude Console을 선택합니다. AWS Console이 JWT를 발급하고 platform.claude.com으로 리디렉션합니다.
4. 처음 로그인할 때 이메일 주소를 입력하라는 메시지가 표시됩니다. 업무용 이메일을 입력하세요. 플랫폼이 Claude Console 사용자를 즉시(just-in-time) 프로비저닝합니다.

두 가지 Claude Console 역할을 사용할 수 있습니다. Admin과 Developer입니다. Admin 역할은 AWS 기반 Claude Platform에서 사용할 수 있는 모든 Claude Console 페이지 및 설정에 대한 액세스를 부여합니다. Developer 역할은 사용량, 비용, 속도 제한 및 워크스페이스 정보에 대한 읽기 액세스를 부여합니다. 보안 주체에 Admin 또는 Developer 역할을 할당하려면 Anthropic 계정 담당자에게 문의하세요.

사용 가능한 페이지

Through AWS gateway 열은 해당 페이지가 AWS 게이트웨이를 통해 데이터를 읽고 쓰는지(따라서 IAM 작업의 적용을 받는지) 여부를 나타냅니다. No로 표시된 페이지는 Anthropic에서 직접 조직 수준 메타데이터를 읽으며 IAM 작업 검사를 우회합니다.

조직 전환

Claude Console은 Claude Platform on AWS에 대한 조직 전환을 지원하지 않습니다. 다른 조직에 액세스하려면 로그아웃한 후 해당 조직의 AWS 계정에 대한 IAM 역할을 사용하여 AWS Console을 통해 다시 인증하세요.

속도 제한 및 할당량

Claude Platform on AWS는 가입 시 Tier 1 속도 제한을 할당합니다. Anthropic은 AWS 할당량 시스템이 아닌 직접 속도 제한을 관리합니다.

퍼스트파티 Claude API와 달리 자동 티어 승급은 적용되지 않습니다. 더 높은 한도가 필요한 경우 Anthropic 계정 담당자에게 문의하세요. 티어 세부 정보 및 모델별 한도는 속도 제한을 참조하세요.

청구

Claude Platform on AWS는 AWS Marketplace를 통해 청구됩니다. 사용량은 "Claude Consumption Unit"(Claude 소비 단위), 즉 CCU로 표시되며, 시간 단위로 측정되고 AWS 청구서에 월별 후불로 청구됩니다. CCU는 선불 크레딧이 아니며, CCU 잔액이나 약정이 없습니다.

CCU 가격, 변환 방식, 할인 적용 및 모델별 토큰 요금은 Claude Platform on AWS 가격을 참조하세요.

모니터링 및 로깅

AWS CloudTrail은 Claude Platform on AWS에 대한 모든 요청을 캡처할 수 있습니다. 워크스페이스, 볼트 및 웹훅 작업은 기본적으로 Management 이벤트로 로깅됩니다. 추론, 배치, 파일, 스킬, 모델, 사용자 프로필 및 Claude Managed Agents 작업(볼트 및 웹훅 제외)은 Data 이벤트로 분류되며 명시적인 데이터 이벤트 로깅 구성이 필요하고, 이는 추가 CloudTrail 요금이 발생합니다. 전체 이벤트 유형 분류는 IAM 작업 참조를, 구성 세부 정보는 AWS CloudTrail 문서를 참조하세요.

요청 ID

각 응답에는 응답 헤더에 두 개의 요청 ID가 포함됩니다.

• AWS 요청 ID (x-amzn-requestid): CloudTrail에 인덱싱되는 기본 ID입니다. AWS 도구를 통해 요청을 조사하거나 AWS 지원팀에 문의할 때 이 ID를 사용하세요.
• Anthropic 요청 ID (request-id): 보조 ID입니다. Anthropic 지원팀에 문의할 때 이 ID를 사용하세요.

from anthropic import AnthropicAWS

client = AnthropicAWS()

response = client.messages.with_raw_response.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.headers.get("x-amzn-requestid"))  # AWS request ID
print(response.headers.get("request-id"))  # Anthropic request ID

message = response.parse()
print(message.content)

Anthropic은 사용 패턴을 파악하고 잠재적인 문제를 조사할 수 있도록 최소 30일 롤링 기준으로 활동을 로깅할 것을 권장합니다.

Amazon Bedrock에서 마이그레이션

현재 Bedrock에서 Claude를 사용하고 있다면 Claude Platform on AWS로 마이그레이션하려면 통합 전반에 걸쳐 변경이 필요합니다. SigV4 서명은 계속 지원되지만 서명 컨텍스트, 기본 URL, API 형식, 모델 ID, SDK 클라이언트 및 패키지, 스트리밍 형식, 요청 헤더, 리전 가용성이 모두 변경됩니다. 다음 표는 차이점을 요약한 것입니다.

변경되는 사항

마이그레이션 차이는 어떤 Bedrock 통합에서 이전하는지에 따라 달라집니다. 다음 표는 현재 Bedrock 통합(bedrock-mantle.{region}.api.aws의 Messages API)과 레거시 InvokeModel 통합을 모두 보여줍니다.

현재 Bedrock 통합을 사용 중이라면 요청 본문 형식은 이미 Messages API이므로, 변경 사항은 기본 URL, SigV4 서비스 이름, 모델 ID, 그리고 anthropic-workspace-id 헤더 추가입니다. 레거시 InvokeModel 또는 Converse API를 사용 중이라면 요청 및 응답 형태도 Messages API 형식으로 다시 작성해야 합니다. 요청 형태 매핑은 Claude on Amazon Bedrock (레거시)를 참조하세요.

얻게 되는 이점

• 일반적으로 새 모델 및 기능에 대한 당일 액세스(기능 제한 사항 참조)
• 문서 생성을 위한 Agent Skills(PowerPoint, Excel, Word, PDF)
• Anthropic의 관리형 샌드박스에서 코드 실행
• anthropic-beta 헤더를 통한 베타 기능(기능 제한 사항 참조)
• 할당량 가시성 및 사용량 분석을 위한 Claude Console
• Anthropic 직접 지원
• SigV4의 대안으로 API 키 인증(API 키 인증 참조)

동일하게 유지되는 사항

• AWS IAM 인증(SigV4)
• 청구 주체로서의 AWS(청구 채널은 네이티브 AWS 서비스에서 AWS Marketplace로 변경됨. 상업적 고려 사항 참조)
• AWS 약정 소진

마이그레이션 주의 사항

상업적 고려 사항

• Anthropic 서비스 약관: Claude Platform on AWS를 사용하려면 Anthropic의 상업 서비스 약관 및 사용 정책에 동의해야 합니다. 조직이 아직 이에 동의하지 않은 경우(예: Bedrock을 통해서만 Claude를 사용한 경우) 계정 설정 중에 동의하라는 메시지가 표시됩니다. 계정 설정을 참조하세요.
• 할인 및 프라이빗 오퍼: 협상된 할인 및 AWS Marketplace 프라이빗 오퍼는 Bedrock과 Claude Platform on AWS 간에 자동으로 이전되지 않습니다. Anthropic 계정 담당자와 협력하여 Claude Platform on AWS에 대한 상업 조건을 설정하세요.

IAM 정책

Claude Platform on AWS는 액세스 제어를 위해 AWS IAM과 통합됩니다. 표준 IAM 정책 구문을 사용하여 특정 워크스페이스의 특정 API 작업에 대한 액세스를 허용하거나 거부할 수 있습니다.

SigV4 서비스 이름 및 IAM 작업 네임스페이스는 aws-external-anthropic입니다. 작업은 aws-external-anthropic:<Action> 패턴을 따릅니다(예: aws-external-anthropic:CreateInference).

예시: 배치 추론 거부

다음 정책은 배치 처리를 차단하면서 실시간 추론을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateInference",
        "aws-external-anthropic:CountTokens",
        "aws-external-anthropic:GetModel",
        "aws-external-anthropic:ListModels",
        "aws-external-anthropic:GetWorkspace"
      ],
      "Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"
    },
    {
      "Effect": "Allow",
      "Action": "aws-external-anthropic:ListWorkspaces",
      "Resource": "*"
    },
    {
      "Effect": "Deny",
      "Action": [
        "aws-external-anthropic:CreateBatchInference",
        "aws-external-anthropic:GetBatchInference",
        "aws-external-anthropic:ListBatchInferences"
      ],
      "Resource": "*"
    }
  ]
}

GetBatchInference 작업은 배치 메타데이터 경로와 배치 결과 경로를 모두 승인합니다. 이를 거부하면 두 읽기가 모두 차단됩니다. ZDR에 민감한 워크로드에 적합한 Deny 전용 정책은 ZDR에 민감한 워크스페이스를 위한 기능 잠금을 참조하세요.

관리형 정책

AWS는 일반적인 액세스 패턴을 위해 5개의 관리형 정책(AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess, AnthropicSelfHostedEnvironmentAccess)을 제공합니다. 각 정책이 부여하는 작업, IAM 작업의 전체 목록, 경로-작업 매핑 및 추가 정책 예시는 Claude Platform on AWS용 IAM 작업을 참조하세요.

추가 리소스

• Claude Platform on AWS용 Claude Console: platform.claude.com (AWS Console을 통해 액세스)
• 가격 세부 정보: 가격
• Bedrock (AWS 운영 Claude): Claude in Amazon Bedrock
• AWS Marketplace: aws.amazon.com/marketplace