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의 데이터 사용 약관의 적용을 받습니다.

Claude Platform on AWS는 다음과 같은 운영 특성을 가집니다: 데이터가 AWS에 상주하지 않을 수 있고, 추론이 Anthropic의 기본 클라우드로 라우팅될 수 있으며, 하위 서비스가 사전 통지 없이 변경될 수 있습니다. 추론을 특정 지역에 고정하려면 요청별로 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 모두와 별도의 용량 풀을 사용합니다. 둘 이상의 플랫폼에서 워크로드를 실행하고 이들 간에 장애 조치를 수행할 수 있습니다.

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

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 Help Center를 참조하세요.
• 직접 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 리소스 범위 지정, 추가 워크스페이스 생성에 대한 자세한 내용은 워크스페이스를 참조하세요.

   AWS Console Claude Platform on AWS 서비스 페이지의 Workspaces 아래 또는 Claude Console에서 워크스페이스 ID를 찾을 수 있습니다. 워크스페이스 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 사용자를 적시에 프로비저닝합니다.

   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 조직이 될 수 없습니다.

기존 조직에서의 이동을 새 조직으로의 전환으로 계획하세요:

• 먼저 새 조직을 생성하세요. 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로 청구되며(결제 참조), 결제 페이지에서 지출 한도를 설정합니다(지출 한도 참조). 전환 중에는 결제가 별도로 유지됩니다: 기존 조직은 현재와 같이 계속 청구됩니다.
• 인증 및 액세스는 AWS로 이동합니다: 요청은 Claude Console이 아닌 AWS 자격 증명 또는 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 리전에 바인딩됩니다. Claude Console의 Workspaces 아래 또는 AWS Console 서비스 페이지의 Workspaces 섹션에서 워크스페이스 ID를 찾을 수 있습니다.

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 상업 리전이 지원됩니다.

인증

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 환경 변수를 설정하거나 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으로 폴백합니다. 리전은 필수이며 기본값이 없습니다: 생성자 인수나 환경 변수가 모두 설정되지 않으면 AnthropicAWS/AnthropicAws 클라이언트가 오류를 발생시킵니다.

SDK 설치

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

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 헤더입니다.

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

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-5",
    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는 모두 필수입니다. 둘 중 하나를 해결할 수 없으면 생성자가 오류를 발생시킵니다.

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

컨텍스트 윈도우

Claude Platform on AWS의 컨텍스트 윈도우 크기는 퍼스트파티 Claude API와 동일합니다. 모델별 한도는 컨텍스트 윈도우를 참조하세요.

기능 지원

Claude Platform on AWS는 Claude API 엔드포인트를 직접 사용하므로, 퍼스트파티 Claude API와 완전한 기능 동등성을 얻을 수 있습니다(기능 제한에 명시된 경우 제외):

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

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

Claude Managed Agents

Claude Managed Agents는 에이전트, 환경, 세션, 자격 증명 볼트, 메모리 스토어, 웹훅, 멀티에이전트 오케스트레이션, 자체 호스팅 샌드박스를 포함하여 Claude Platform on AWS에서 사용할 수 있습니다.

Claude Platform on AWS의 세션 동작은 두 가지 방식으로 퍼스트파티 Claude Managed Agents와 다릅니다:

• 자율 세션 재인증: 세션은 사용자 이벤트 없이 최대 6시간 동안 자율적으로 실행될 수 있습니다. 6시간 후에는 세션이 계속되기 전에 재인증이 필요합니다. 재인증하려면 세션에 사용자 역할 이벤트를 보내세요(이벤트 및 스트리밍 참조). 퍼스트파티 Claude Managed Agents에는 자율 세션 런타임 제한이 없습니다.
• 자체 호스팅 환경의 메모리 스토어: 자체 호스팅 환경에서 실행되는 세션은 메모리 스토어를 연결할 수 없습니다. 메모리 스토어를 포함하는 세션은 생성 시 거부됩니다. 클라우드 환경의 세션은 평소와 같이 메모리 스토어를 연결합니다. 퍼스트파티 Claude Managed Agents에서는 클라우드 및 자체 호스팅 환경 모두의 세션이 메모리 스토어를 연결할 수 있습니다.

지원되지 않는 기능

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

• HIPAA 준비: Anthropic의 HIPAA 준비 프로그램은 사용할 수 없습니다. API 및 데이터 보존을 참조하세요.
• 컴퓨터 사용 및 브라우저 사용 도구 세트: computer_toolset_20260801 및 browser_toolset_20260801은 현재 Claude Platform on AWS에서 사용할 수 없습니다. 베타 컴퓨터 사용 도구 버전은 계속 사용할 수 있습니다.

• Admin API: 워크스페이스 엔드포인트(/v1/organizations/workspaces의 create, get, list, update, archive) 및 외부 키 엔드포인트(/v1/organizations/external_keys의 register, get, list, update, delete, CMEK용; 키는 검증 엔드포인트가 아닌 워크스페이스에 연결될 때 검증됨)를 사용할 수 있습니다. 기타 Admin API 엔드포인트(조직 멤버, 워크스페이스 멤버, 초대, API 키, 사용량 보고서, 비용 보고서, 속도 제한 보고서)는 현재 사용할 수 없습니다. 대신 Claude Console에서 사용량 및 비용 데이터를 확인하세요. AWS IAM이 조직 멤버십을 관리합니다.
• 워크스페이스 멤버 관리: 개별 워크스페이스에서 사용자를 추가하거나 제거하는 것은 사용할 수 없습니다. 워크스페이스 ARN에 대한 AWS IAM 정책이 액세스를 제어합니다.
• Claude Code 워크스페이스 및 Analytics API: 자동 속도 제한이 있는 Claude Code 워크스페이스는 사용할 수 없습니다. Claude Code 사용량은 전용 화면이 아닌 일반 사용량 보기에 표시됩니다.
• OAuth 인증: 지원되지 않습니다. SigV4 또는 API 키 인증을 사용하세요.
• Fast mode: Claude Platform on AWS에서 사용할 수 없습니다.
• OpenAI 호환 API 엔드포인트: Claude Platform on AWS에서 사용할 수 없습니다.
• MCP 터널: 공용 인터넷을 통해 노출된 MCP 서버만 지원됩니다.

Data residency

Claude Platform on AWS는 다음 추론 지역(inference geography)을 지원합니다:

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

inference_geo 매개변수로 요청별 추론 지역을 설정하세요:

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-5",
    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)도 Claude Platform on AWS에서 사용할 수 있습니다. Workspace-level restrictions를 참조하세요.

Workspaces

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

Workspace scoping

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

워크스페이스는 또한 Claude Platform on AWS의 기본 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 policies를 참조하세요.

Managing workspaces

AWS Console Workspaces 페이지에서 또는 Admin API 워크스페이스 엔드포인트로 추가 워크스페이스를 생성하거나, 워크스페이스 이름을 변경하거나, 워크스페이스를 보관하세요. 새 워크스페이스는 생성하기 위해 호출하는 엔드포인트의 AWS 리전에 바인딩됩니다(Workspace scoping 참조). Admin 역할을 사용하면 Claude Console Workspaces 페이지에서도 워크스페이스를 생성, 이름 변경 및 보관할 수 있습니다.

Using the Claude Console

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

Signing in

Claude Console에 대한 접근은 AWS IAM을 통해 페더레이션됩니다. 전체 최초 로그인 흐름은 Set up your account를 참조하세요. 요약하면:

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

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

Available pages

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

Switching organizations

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

Rate limits and quotas

Claude Platform on AWS의 조직은 Start 등급에 배치됩니다. Anthropic은 AWS 할당량 시스템이 아닌 직접 속도 제한을 관리합니다.

Claude Platform on AWS의 조직은 사용량 등급 간에 자동으로 이동하지 않습니다. 사용량 기반 등급 상향은 AWS Marketplace를 통해 청구되는 조직이 아닌 퍼스트파티 Claude API 조직에 적용됩니다. Claude Console의 셀프 서비스 Request rate limit increase 흐름도 사용할 수 없습니다. Rate limits 페이지는 대신 Anthropic 계정 담당자에게 안내합니다.

더 높은 한도를 요청하려면 Anthropic 계정 담당자 또는 Anthropic support에 문의하세요. 요청에 다음을 포함하세요:

• 상향이 필요한 모델
• 각 모델의 분당 최대 입력 토큰 및 분당 출력 토큰(일일 총계가 아님)
• 캐시되거나 반복되는 컨텍스트인 입력의 대략적인 비율(캐시 읽기는 대부분의 모델에서 입력 토큰 한도에 포함되지 않습니다. cache-aware ITPM을 참조하세요)

사용량 등급은 고정된 단계입니다. 각 등급은 속도 제한을 월별 지출 상한과 짝지으며, 더 높은 등급으로 이동하면 둘 다 상향됩니다. 등급 세부 정보 및 모델별 한도는 Rate limits를 참조하세요.

Billing

Claude Platform on AWS는 AWS Marketplace를 통해 청구합니다. 사용량은 Claude Consumption Units(CCUs)로 표시되며, 시간별로 측정되고, AWS 청구서에 월별 후불로 인보이스가 발행됩니다. CCU는 선불 크레딧이 아닙니다. CCU 잔액이나 약정이 없습니다.

CCU 가격, 변환 메커니즘, 할인 적용 및 모델별 토큰 요율은 Claude Platform on AWS pricing을 참조하세요.

Spend limits

Start, Build 및 Scale 사용량 등급은 각각 월별 지출 상한을 가집니다. 현재 값은 등급별 지출 상한을 참조하세요. 조직의 해당 달력 월 사용량이 등급의 상한에 도달하면, 다음 달 첫째 날 00:00 UTC까지 API 요청이 지출 상한 오류와 함께 실패하며, 더 일찍 재시도해도 성공하지 않습니다. 지출 상한과 속도 제한은 동일한 등급에 속합니다. 상한을 올리거나 도달 후 접근을 복원하려면 Anthropic 계정 담당자 또는 Anthropic support를 통해 등급 상향을 요청하세요(Rate limits and quotas 참조).

Billing 페이지의 Email recipients에 최소 한 명의 수신자를 추가한 후, 상한 아래로 자체 월별 지출 한도를 설정할 수도 있습니다:

• Organization spend limit: Claude Console의 Settings > Billing으로 이동하여 월별 지출 한도를 설정합니다.
• Workspace spend limits: Settings > Workspaces에서 워크스페이스를 선택하고 해당 Spend limits 페이지를 엽니다.

설정한 한도에 사용량이 도달하면, 다음 달 첫째 날 00:00 UTC까지 또는 한도를 올리거나 제거할 때까지 요청이 HTTP 400(지출 한도 오류 참조)과 함께 실패합니다.

지출은 정가로 계산되며 최근 사용량을 반영하는 데 약 2시간이 걸릴 수 있으므로, 요청이 실패하기 시작하기 전에 사용량이 상한이나 한도를 초과할 수 있습니다. 초과분은 청구됩니다. 등급 상한이나 조직 지출 한도가 요청을 중지하면, Billing 페이지의 Email recipients에 나열된 수신자에게 이메일 알림이 전송됩니다. 모든 관리자와 같은 역할 기반 수신자는 Claude Platform on AWS에서 사용할 수 없습니다. 등급 상한 알림은 AWS Marketplace 가입 시 사용된 이메일 주소로도 전송됩니다.

Monitoring and logging

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

Request IDs

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

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

from anthropic import AnthropicAWS

client = AnthropicAWS()

response = client.messages.with_raw_response.create(
    model="claude-sonnet-5",
    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일 롤링 기준으로 활동을 로깅할 것을 권장합니다.

Migrating from Amazon Bedrock

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

What changes

마이그레이션 델타는 어떤 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 (Opus 4.6 이하)를 참조하세요.

What you gain

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

What stays the same

• AWS IAM 인증(SigV4)
• 인보이스 발행 당사자로서의 AWS. 청구 채널이 네이티브 AWS 서비스에서 AWS Marketplace로 변경됩니다(Commercial considerations 참조).
• AWS 약정 소진

Migration pitfalls

Commercial considerations

• Anthropic terms of service: Claude Platform on AWS를 사용하려면 Anthropic의 Commercial Terms of Service 및 Usage Policy에 동의해야 합니다. 조직이 아직 이를 수락하지 않은 경우(예: Bedrock을 통해서만 Claude를 사용한 경우), 계정 설정 중에 메시지가 표시됩니다. Set up your account를 참조하세요.
• Discounts and private offers: 협상된 할인 및 AWS Marketplace 비공개 제안은 Bedrock과 Claude Platform on AWS 간에 자동으로 이전되지 않습니다. Claude Platform on AWS에 대한 상업적 조건을 설정하려면 Anthropic 계정 담당자와 협력하세요.

IAM policies

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

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

Example: deny batch inference

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

{
  "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 전용 정책은 Feature lockdown for a ZDR-sensitive workspace를 참조하세요.

Managed policies

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

Next steps

Additional resources