翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
前提条件
API コールを行う前に、以下を確認してください。
-
Claude Platform on AWS へのサブスクリプションを持つアクティブな AWS アカウント (「アカウントのセットアップ」を参照)。
-
AWS CLI がインストールされ、設定されています。
-
AWS アカウントで有効になっているアウトバウンドウェブ ID フェデレーション (ワンタイムセットアップステップ。「アウトバウンドウェブ ID フェデレーションを有効にする」を参照)。
-
ワークスペース ID (「ワークスペース ID を取得する」を参照)。
アウトバウンドウェブ ID フェデレーションを有効にする
AWS ゲートウェイの Claude プラットフォームはsts:GetWebIdentityTokenサーバー側を呼び出して、Anthropic に転送する JWT をミントします。この STS 機能は、すべての AWS アカウントでデフォルトで無効になっています。アカウントごとに 1 回有効にします。
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 を取得する
デフォルトのワークスペースは、サインアップ時に各リージョンに自動的にプロビジョニングされます (「アカウントのセットアップ」を参照)。WorkSpaces は 1 つの AWS リージョンにバインドされます。ワークスペース ID は、Workspaces の Claude コンソール、または AWS コンソールサービスページの Workspaces セクションにあります。リージョンバインディングと 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 商用リージョンがサポートされています。オプトインリージョンでは、まずアカウントをリージョンにオプトインする必要があります。