View a markdown version of this page

前提条件 - AWS での Claude プラットフォーム

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

前提条件

API コールを行う前に、以下を確認してください。

  1. Claude Platform on AWS へのサブスクリプションを持つアクティブな AWS アカウント (「アカウントのセットアップ」を参照)。

  2. AWS CLI がインストールされ、設定されています。

  3. AWS アカウントで有効になっているアウトバウンドウェブ ID フェデレーション (ワンタイムセットアップステップ。「アウトバウンドウェブ ID フェデレーションを有効にする」を参照)。

  4. ワークスペース 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 商用リージョンがサポートされています。オプトインリージョンでは、まずアカウントをリージョンにオプトインする必要があります。