Claude Platform on AWS

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

플랫폼 통합 작동 방식

Claude 모델은 Anthropic이 관리하는 인프라에서 실행됩니다. 이는 AWS를 통한 결제 및 액세스를 위한 상업적 통합입니다. Anthropic은 추론 입력 및 출력에 대한 데이터 처리자입니다. AWS는 마켓플레이스 모델에 따라 결제 및 ID 메타데이터를 처리합니다. Claude Platform on AWS를 통해 Claude를 사용하는 고객에게는 Anthropic의 데이터 사용 약관이 적용됩니다.

Anthropic은 AWS 인프라를 사용하여 API 요청을 처리하고, 모델 추론을 실행하며, 워크스페이스 콘텐츠(프롬프트, 출력, 파일, Skills, 배치 등)를 저장합니다. 2026년 9월 18일 00:00 UTC 이전에 생성된 워크스페이스의 경우, Anthropic은 AWS 외부에서 요청을 처리하고, 데이터를 저장하며, 추론을 실행할 수 있습니다. 어느 경우든 하위 서비스는 예고 없이 변경될 수 있습니다. 추론을 특정 지역으로 고정하려면 요청별로 inference_geo 매개변수를 설정하세요.

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

Claude Platform on AWS와 Amazon Bedrock 비교

두 서비스 모두 AWS를 통해 Claude를 사용할 수 있게 해 주지만, 아키텍처, API 표면, 기능 가용성에서 차이가 있습니다.

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

VPC를 Claude Platform on AWS 엔드포인트에 연결하기 위한 AWS PrivateLink가 지원됩니다.

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

어떤 서비스를 사용하고 계신가요? Claude는 여러 개의 서로 다른 제품을 통해 제공됩니다:

• Claude Platform on AWS(이 페이지): AWS Marketplace를 통해 결제되는 Claude API 플랫폼입니다. Claude Console과 AWS Console에서 관리합니다.
• Claude in Amazon Bedrock: AWS 네이티브 서비스입니다. Amazon Bedrock 콘솔에서 관리하며 AWS 서비스 사용량으로 결제됩니다.
• AWS Marketplace를 통해 조달한 Claude Enterprise: API 플랫폼이 아닌 claude.ai 플랜(Claude 채팅 제품)입니다. claude.ai에서 관리하며, 계정 및 마이그레이션 동작이 이 페이지에서 설명하는 내용과 다릅니다. Claude 고객센터를 참조하세요.
• Anthropic 직접 계정: Anthropic이 결제하는 퍼스트파티 Claude API 및 claude.ai 플랜입니다. Claude Console과 claude.ai에서 관리합니다.

계정 설정

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

1. 1

   AWS Console에서 가입

   1. AWS Console을 열고 Claude Platform on AWS 서비스 페이지로 이동합니다.
   2. Sign up을 선택합니다.
   3. 가입 페이지에서 약관(Anthropic의 최종 사용자 라이선스 계약, AWS 개인정보 보호 고지, AWS 고객 계약)을 검토하고 동의 체크박스를 선택합니다.
   4. Continue를 선택합니다.

   페이지에 Sign-up in progress 배너가 표시됩니다. 페이지를 벗어나지 마세요. AWS가 AWS Marketplace 구독을 대신 처리하는 동안 가입에 몇 분이 걸리며, 이후 자동으로 리디렉션됩니다.

   조직에 Anthropic의 프라이빗 오퍼가 있는 경우, Console이 이를 조회하여 AWS Marketplace에서 수락하라는 메시지를 표시합니다. 자세한 내용은 프라이빗 오퍼를 참조하세요.

2. 2

   Anthropic 조직 설정

   가입이 완료되면 platform.claude.com/partner-signup으로 리디렉션됩니다.

   1. 조직 소유자의 이메일 주소를 입력하고 Get started를 선택합니다.
   2. 해당 이메일 받은편지함에서 설정 링크를 확인하고 링크를 따라갑니다. 브라우저에 Signed in as a different account 페이지가 표시되면 Log out and continue를 선택합니다.
   3. 조직 세부 정보 양식(조직 이름, 법인 유형, 국가, 사용 목적)을 작성하고 Complete setup을 선택합니다.

   설정을 완료하면 Anthropic 조직이 생성되고 Anthropic의 상업 서비스 약관 및 사용 정책에 동의하게 됩니다. 이제 AWS Console 서비스 페이지에 Home, API keys, Quickstart, Workspaces가 있는 왼쪽 탐색 메뉴가 표시됩니다.

3. 3

   워크스페이스 생성 및 ID 확인

   설정을 완료하면 AWS Console에서 워크스페이스를 생성하라는 메시지가 표시됩니다. 리전 바인딩, IAM 리소스 범위 지정, 추가 워크스페이스 생성에 대한 자세한 내용은 워크스페이스를 참조하세요.

   워크스페이스 ID는 AWS Console Claude Platform on AWS 서비스 페이지의 Workspaces 아래 또는 Claude Console에서 찾을 수 있습니다. 워크스페이스 ID는 wrkspc_ 뒤에 영숫자 식별자가 붙는 형식을 사용합니다.

4. 4

   Claude Console에 로그인

   Claude Console에 대한 액세스는 AWS IAM을 통해 페더레이션됩니다:

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

   AWS Console을 통해 로그인하면 Claude Console의 범위가 Claude Platform on AWS 조직으로 지정됩니다. Claude Console 사이드바 왼쪽 하단에 Account managed by AWS 표시가 나타납니다.

기존 Anthropic 조직에서 이전하기

Claude Platform on AWS에 가입하면 항상 AWS 계정에 연결된 새 Anthropic 조직이 프로비저닝됩니다. 제자리 전환은 지원되지 않습니다: 퍼스트파티 Claude API 조직과 같은 기존 조직은 Claude Platform on AWS 조직이 될 수 없습니다.

기존 조직에서의 이전은 새 조직으로의 전환(cutover)으로 계획하세요:

• 새 조직을 먼저 생성하세요. AWS Console을 통해 가입하세요(계정 설정 참조). 이전 과정에 프라이빗 오퍼가 포함되는 경우, 오퍼가 수락되기 전에 가입을 완료하세요: 할인은 소급되지 않고 수락 시점부터 적용됩니다. 프라이빗 오퍼를 참조하세요.
• 액세스 및 구성을 다시 만드세요. API 키, 워크스페이스, Claude Console 설정은 기존 조직에서 이전되지 않습니다. 새 조직에서 워크스페이스를 생성하고 애플리케이션을 Claude Platform on AWS 인증으로 전환하세요.
• 통합을 업데이트하세요. Claude Platform on AWS는 Claude API(/v1/{endpoint})를 제공하므로 요청 및 응답 형태는 퍼스트파티 Claude API와 동일합니다. 변경되는 것은 기본 URL, 인증 방법, 그리고 추론 및 리소스 요청의 anthropic-workspace-id 헤더입니다. 요청 보내기를 참조하세요. 일부 플랫폼 기능은 다릅니다. 지원되지 않는 기능을 참조하세요.
• 원하는 일정에 따라 전환하세요. 새 조직은 기존 조직과 독립적이며, 두 조직 모두 병렬로 트래픽을 처리할 수 있습니다. 일괄 전환할 필요가 없습니다: 모든 트래픽이 새 조직으로 옮겨질 때까지 워크로드를 점진적으로 이동하세요.

새 조직이 실행되면, 차이점은 AWS를 통해 처리되는 결제와 인증에 집중됩니다:

• 결제는 AWS Marketplace로 이동합니다: 사용량은 선불 크레딧이 아닌 Claude Consumption Units로 청구되며(결제 참조), Billing 페이지에서 지출 한도를 설정합니다(지출 한도 참조). 전환 기간 동안 결제는 별도로 유지됩니다: 기존 조직은 현재와 같이 계속 청구됩니다.
• 인증 및 액세스는 AWS로 이동합니다: 요청은 AWS 자격 증명 또는 Claude Console이 아닌 AWS Console에서 생성한 API 키로 인증합니다(인증 참조). 조직 멤버십은 Claude Console이 아닌 AWS IAM을 통해 관리되며(사용 가능한 페이지 참조), Anthropic의 클라이언트 SDK는 플랫폼별 클라이언트 클래스를 제공합니다(SDK 설치 참조).
• 일상적인 API 사용은 기능 제한 사항에 명시된 경우를 제외하고 퍼스트파티 Claude API와 동일하게 작동합니다. 프로덕션 트래픽을 이동하기 전에 속도 제한을 확인하세요: 새 조직은 Start 등급에 배치되며, 한도 증가는 Anthropic 계정 담당자를 통해 진행됩니다(속도 제한 및 할당량 참조).

다르게 동작하는 Claude Enterprise(claude.ai) 조직의 경우 제품 비교를 참조하세요.

계정 설정 문제 해결

• "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 호출 시 "Outbound web identity federation is disabled": 계정당 한 번 페더레이션을 활성화하세요. 아웃바운드 웹 ID 페더레이션 활성화를 참조하세요.

API 호출 전

다음 사항을 확인하세요:

1. Claude Platform on AWS 구독이 있는 활성 AWS 계정(계정 설정 참조)
2. AWS CLI 설치 및 구성
3. AWS 계정에서 아웃바운드 웹 ID 페더레이션 활성화, 일회성 설정 단계(아웃바운드 웹 ID 페더레이션 활성화 참조)
4. 워크스페이스 ID(워크스페이스 ID 얻기 참조)
5. API 호출을 위한 IAM 권한: 워크스페이스에 대한 aws-external-anthropic:CreateInference 작업, API 키로 인증하는 경우 aws-external-anthropic:CallWithBearerToken(IAM 정책 참조)

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

Claude Platform on AWS 게이트웨이는 서버 측에서 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을 전달하거나 AWS_REGION(또는 AWS_DEFAULT_REGION)을 설정하세요. 모든 AWS 상용 리전이 지원됩니다.

인증

Claude Platform on AWS는 두 가지 인증 방법을 지원합니다: Signature Version 4(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 환경 변수를 설정하거나 클라이언트를 생성할 때 api_key를 전달하세요.

API 키는 AWS Console의 Claude Platform on AWS → API keys에서 생성합니다. 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 작업이 필요합니다.

자격 증명 우선순위

플랫폼별 클라이언트는 생성 시 전달한 값부터 시작하여 다음 순서로 인증을 결정합니다:

1. api_key → x-api-key 헤더
2. aws_access_key + aws_secret_key → AWS SigV4
3. aws_profile → 명명된 프로필을 사용하는 AWS SigV4
4. ANTHROPIC_AWS_API_KEY 환경 변수 → x-api-key 헤더
5. 기본 AWS 자격 증명 공급자 체인 → AWS SigV4

리전 결정

aws_region을 설정하지 않으면 클라이언트는 환경에서 AWS_REGION을 읽으며, 표준 AWS SDK와의 호환성을 위해 AWS_DEFAULT_REGION으로 대체합니다. 리전은 필수이며 기본값이 없습니다: 생성자 인수와 환경 변수가 모두 설정되지 않으면 AnthropicAWS가 오류를 발생시킵니다.

SDK 설치

Anthropic의 클라이언트 SDK는 Claude Platform on AWS를 지원합니다. SDK는 SigV4 서명, 리전 기반 기본 URL 구성, anthropic-workspace-id 헤더를 처리하는 AnthropicAWS를 제공합니다.

pip install -U "anthropic[aws]"

사용 가능한 모델

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

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

새 모델은 일반적으로 퍼스트파티 Claude API와 같은 날 Claude Platform on AWS에 출시됩니다.

요청 보내기

Claude Platform on AWS는 퍼스트파티 Claude API와 동일한 API 엔드포인트를 사용합니다. 차이점은 기본 URL, 인증 방법, 그리고 요청이 대상으로 하는 워크스페이스를 식별하는 anthropic-workspace-id 헤더입니다. 이 헤더는 Messages API, Models API, Files API, Claude Managed Agents 엔드포인트 호출과 같은 추론 및 리소스 요청에 필수입니다. Admin API 워크스페이스 및 외부 키 엔드포인트에 대한 요청에는 필요하지 않습니다.

이 예제를 실행하기 전에 API 호출 전의 단계를 완료하세요.

from anthropic import AnthropicAWS

client = AnthropicAWS()

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

클라이언트는 환경에서 AWS_REGION(또는 AWS_DEFAULT_REGION)과 ANTHROPIC_AWS_WORKSPACE_ID를 읽습니다. 클라이언트를 생성할 때 aws_region 또는 workspace_id를 전달하여 둘 중 하나를 재정의할 수 있습니다. 리전과 워크스페이스 ID는 모두 필수입니다. 둘 중 하나라도 결정할 수 없으면 생성자가 오류를 발생시킵니다.