View a markdown version of this page

사전 조건 - AWS의 Claude 플랫폼
아웃바운드 웹 ID 페더레이션 활성화워크스페이스 ID 가져오기

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사전 조건

API를 호출하기 전에 다음 사항을 확인해야 합니다.

  1. AWS에서 Claude Platform을 구독하는 활성 AWS 계정(계정 설정 참조).

  2. AWS CLI가 설치 및 구성되었습니다.

  3. AWS 계정에서 활성화된 아웃바운드 웹 자격 증명 페더레이션(일회성 설정 단계, 아웃바운드 웹 자격 증명 페더레이션 활성화 참조).

  4. 워크스페이스 ID(워크스페이스 ID 가져오기 참조).

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

AWS 게이트웨이의 Claude 플랫폼은 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
주의

이 단계가 없으면 모든 요청이를 반환합니다"Outbound web identity federation is disabled for your account". 가장 일반적인 설정 오류입니다.

워크스페이스 ID 가져오기

기본 워크스페이스는 가입 시 각 리전에서 자동으로 프로비저닝됩니다(계정 설정 참조). Workspace는 단일 AWS 리전에 바인딩됩니다. 워크스페이스 ID는 Claude 콘솔의 워크스페이스 또는 AWS 콘솔 서비스 페이지의 워크스페이스 섹션에서 찾을 수 있습니다. 리전 바인딩 및 IAM 리소스 크기 조정은 Workspaces를 참조하세요.

SDK 클라이언트가 자동으로 읽도록 ANTHROPIC_AWS_WORKSPACE_ID 및 AWS_REGION 환경 변수를 설정합니다.

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'

리전은 필수입니다. 리전이 설정되지 않은 경우 SDK 클라이언트에서가 발생합니다. 생성자에 aws_region/awsRegion를 전달하거나 AWS_REGION (또는 )를 설정합니다AWS_DEFAULT_REGION. 모든 AWS 상용 리전이 지원됩니다. 옵트인 리전에서는 먼저 해당 리전에 계정을 옵트인해야 합니다.