View a markdown version of this page

Prasyarat - Platform Claude di AWS
Aktifkan federasi identitas web keluarDapatkan ID ruang kerja Anda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Prasyarat

Sebelum melakukan panggilan API, pastikan Anda memiliki:

  1. Akun AWS aktif dengan berlangganan Platform Claude di AWS (lihat Mengatur akun Anda).

  2. AWS CLI diinstal dan dikonfigurasi.

  3. Federasi identitas web keluar diaktifkan di akun AWS Anda (langkah penyiapan satu kali; lihat Mengaktifkan federasi identitas web keluar).

  4. ID ruang kerja Anda (lihat Mendapatkan ID ruang kerja Anda).

Aktifkan federasi identitas web keluar

Platform Claude di gateway AWS memanggil sts:GetWebIdentityToken sisi server untuk mencetak JWT yang diteruskan ke Anthropic. Kemampuan STS ini dinonaktifkan secara default di setiap akun AWS. Aktifkan sekali per akun:

aws iam enable-outbound-web-identity-federation

Jika responsnya[ERROR] (FeatureEnabled) …​ already enabled, pengaturan sudah aktif untuk akun Anda dan Anda dapat melanjutkan. Verifikasi dan ambil URL penerbit akun Anda:

aws iam get-outbound-web-identity-federation-info
Awas

Tanpa langkah ini, setiap permintaan kembali"Outbound web identity federation is disabled for your account". Ini adalah kesalahan pengaturan yang paling umum.

Dapatkan ID ruang kerja Anda

Ruang kerja default disediakan secara otomatis di setiap wilayah saat Anda mendaftar (lihat Mengatur akun). Ruang kerja terikat pada satu wilayah AWS. Anda dapat menemukan ID ruang kerja di Claude Console di bawah Workspaces, atau di bagian Workspaces pada halaman layanan AWS Console. Lihat Ruang kerja untuk pengikatan wilayah dan pelingkupan sumber daya IAM.

Atur variabel ANTHROPIC_AWS_WORKSPACE_ID dan AWS_REGION lingkungan sehingga klien SDK membacanya secara otomatis:

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

Wilayah ini diperlukan. Klien SDK melempar jika tidak ada wilayah yang disetel. Lulusaws_region/awsRegionke konstruktor, atau set AWS_REGION (atauAWS_DEFAULT_REGION). Semua wilayah komersial AWS didukung; wilayah keikutsertaan mengharuskan Anda memilih akun terlebih dahulu ke wilayah tersebut.