Claude Code pada Claude Platform on AWS

Claude Platform on AWS adalah Claude API yang dioperasikan Anthropic dengan autentikasi AWS, kontrol akses IAM, dan penagihan AWS Marketplace. Permintaan mencapai API Anthropic secara langsung, sehingga Anda mendapatkan model dan fitur API yang sama seperti Claude API dengan jadwal rilis yang sama. Anda melakukan autentikasi dengan kredensial AWS atau kunci API workspace, dan Anda membayar melalui AWS Marketplace. Gunakan panduan ini untuk mengarahkan Claude Code ke workspace yang telah Anda sediakan melalui Claude Platform on AWS. Untuk langganan AWS dan penyiapan workspace yang dilakukan sebelumnya, lihat dokumentasi Claude Platform on AWS.

Berlangganan melalui AWS Marketplace menyediakan organisasi Anthropic baru yang terikat ke akun AWS Anda. Organisasi ini terpisah dari organisasi apa pun yang sudah Anda miliki dengan Anthropic, dan kredensial tidak ditransfer di antara keduanya. Gunakan ID workspace dan kunci API dari organisasi yang terhubung dengan AWS, bukan dari akun Claude Console yang sudah ada sebelumnya.

Beberapa fitur Claude Code tidak tersedia atau bekerja secara berbeda pada Claude Platform on AWS. Lihat matriks ketersediaan fitur dan fitur yang memerlukan pengambilan feature-flag.

Prasyarat

Sebelum mengonfigurasi Claude Code, Anda memerlukan:

Langganan Claude Platform on AWS aktif melalui AWS Marketplace
Workspace di organisasi Anthropic yang terhubung dengan AWS Anda, dengan ID workspace-nya
Prinsipal IAM dengan izin untuk memanggil layanan Anthropic, atau kunci API yang dibatasi pada workspace
Kredensial AWS di lingkungan Anda, di ~/.aws/credentials, atau dari peran IAM yang terpasang jika Anda ingin autentikasi SigV4. AWS CLI hanya diperlukan untuk alur login SSO.

Penyiapan

Konfigurasikan kredensial AWS

Claude Code mendukung dua metode autentikasi untuk Claude Platform on AWS. Pilih metode yang sesuai dengan cara tim Anda mengelola akses:

Kredensial AWS dengan SigV4: lakukan autentikasi sebagai IAM principal, dengan kredensial dari rantai kredensial AWS standar
Kunci API workspace: lakukan autentikasi dengan kunci berumur panjang yang Anda buat di AWS Console

Gunakan kredensial AWS dengan SigV4

Claude Code menandatangani permintaan dengan SigV4 menggunakan rantai kredensial AWS standar: environment variable, kredensial bersama di ~/.aws/credentials, IAM role, sesi AWS SSO, dan sumber lain apa pun yang didukung oleh AWS SDK. Untuk penggunaan lokal, masuk dengan AWS CLI sebelum memulai Claude Code. Contoh di bawah menggunakan profil SSO, tetapi metode apa pun yang menghasilkan kredensial di lokasi standar dapat digunakan.

aws sso login --profile my-profile
export AWS_PROFILE=my-profile

Untuk CI dan otomatisasi, berikan runner sebuah IAM role dengan izin untuk memanggil layanan Anthropic dan atur AWS_REGION. Rantai kredensial akan mengambil role tersebut secara otomatis. Jika kredensial SSO Anda kedaluwarsa di tengah sesi, konfigurasikan awsAuthRefresh agar Claude Code menjalankan ulang perintah login Anda dan mencoba ulang alih-alih gagal. Tambahkan perintah tersebut ke file pengaturan Anda, seperti ~/.claude/settings.json:

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

Claude Code juga menjalankan perintah ini saat startup ketika tidak dapat memvalidasi kredensial AWS Anda yang ada, dan menampilkan output perintah tersebut di panel Authentication hingga proses masuk selesai. Dengan awsAuthRefresh yang telah dikonfigurasi, jalankan /login, pilih 3rd-party platform, lalu pilih Claude Platform on AWS · refresh credentials di bawah Using 3rd-party platforms. Claude Code menjalankan perintah yang dikonfigurasi dan membaca ulang kredensial AWS Anda tanpa perlu restart.

Gunakan kunci API workspace

Kunci API workspace adalah rahasia berumur panjang, berguna ketika Anda tidak ingin mengelola kredensial AWS terfederasi. Buat kunci di AWS Console pada Claude Platform on AWS → API keys dan atur sebagai ANTHROPIC_AWS_API_KEY:

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

Kunci dikirim sebagai x-api-key dan diutamakan daripada SigV4, sehingga kredensial AWS apa pun di environment Anda diabaikan. Kunci API dari organisasi Claude Console yang terpisah tidak akan berfungsi di sini. Perlakukan kunci API workspace seperti kredensial produksi lainnya. Blok env pada file pengaturan pengguna adalah cara praktis untuk membatasi kunci tersebut ke mesin Anda tanpa mengekspornya secara global.

Perintah /login dan /logout tidak memasukkan Anda ke langganan claude.ai untuk Claude Platform on AWS. Autentikasi berjalan melalui kredensial AWS atau kunci API workspace Anda.

Konfigurasikan Claude Code

Atur environment variable yang mengarahkan Claude Code melalui Claude Platform on AWS alih-alih Anthropic API default.

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1

ANTHROPIC_AWS_WORKSPACE_ID wajib diisi. Claude Code mengirimkannya pada setiap permintaan sebagai header anthropic-workspace-id. Ganti nilai contoh wrkspc_01ABCDEFGHIJKLMN dengan ID workspace Anda sendiri dari penyiapan Claude Platform on AWS Anda. Claude Code menghitung base URL sebagai https://aws-external-anthropic.{region}.api.aws dari region AWS, yang ditentukan dengan urutan prioritas yang sama seperti Amazon Bedrock. Untuk menimpa URL secara langsung, atur ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS bersifat opt-in bahkan ketika kredensial AWS ada di environment Anda. Amazon Bedrock dan Microsoft Foundry diutamakan dalam perutean penyedia, jadi hapus CLAUDE_CODE_USE_BEDROCK dan CLAUDE_CODE_USE_FOUNDRY jika keduanya diatur.

Sematkan versi model

Claude Platform on AWS menggunakan ID model yang sama dengan Claude API langsung. Alias default fable, opus, sonnet, dan haiku mengarah ke default bawaan Claude Code untuk Claude Platform on AWS, yang mungkin tertinggal dari rilis terbaru. Tanpa ANTHROPIC_DEFAULT_OPUS_MODEL, alias opus mengarah ke Opus 5.5. Sebelum v2.1.280, alias ini mengarah ke Opus 5 sejak v2.1.219. Jika Anda menerapkan Claude Code ke sebuah tim, sematkan ID model secara eksplisit agar rilis baru tidak memindahkan semua orang sekaligus:

export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Untuk daftar lengkap ID model dan alias, lihat Ikhtisar model. Untuk variabel terkait model lainnya, lihat Konfigurasi model. Prompt caching diaktifkan secara otomatis. Untuk meminta TTL cache 1 jam alih-alih default 5 menit, atur ENABLE_PROMPT_CACHING_1H=1. API menagih penulisan cache 1 jam dengan tarif yang lebih tinggi. Lihat harga prompt caching untuk tarifnya. Untuk mengatur TTL yang berbeda untuk percakapan utama Anda dan untuk permintaan yang dibuat Claude Code di luarnya, pilih TTL sendiri.

Jalankan dan verifikasi

Mulai Claude Code dan konfirmasikan peruteannya:

claude

Banner startup menampilkan Claude Platform on AWS ketika penyedia ini aktif. Jalankan /status untuk memeriksa detailnya: baris API provider menampilkan Claude Platform on AWS, dan output-nya mencakup Workspace ID Anda, AWS region, serta Claude Platform on AWS base URL jika Anda mengatur override.

Gunakan Agent SDK

Agent SDK membaca variabel lingkungan yang sama dengan CLI, sehingga program apa pun yang menjalankan subprocess Claude Code dapat menargetkan Claude Platform on AWS dengan mengekspor CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID, dan baik ANTHROPIC_AWS_API_KEY atau kredensial AWS sebelum panggilan.

import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}

Contoh ini bergantung pada rantai kredensial AWS ambient untuk SigV4. Untuk melakukan autentikasi dengan kunci API workspace sebagai gantinya, atur ANTHROPIC_AWS_API_KEY dengan cara yang sama. Untuk permukaan Agent SDK yang lebih luas, lihat Agent SDK overview.

Rute melalui proxy korporat

Untuk mengarahkan lalu lintas melalui proxy atau LLM gateway, atur ANTHROPIC_AWS_BASE_URL ke alamat proxy. Claude Code mengirim permintaan ke URL tersebut dengan header workspace dan autentikasi yang sama, sehingga gateway apa pun yang meneruskannya tanpa perubahan berfungsi.

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

Jika gateway Anda menandatangani permintaan sendiri, atur CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 sehingga Claude Code mengirim permintaan yang tidak ditandatangani dan membiarkan gateway menambahkan header SigV4 sebelum meneruskan ke AWS. Jika gateway memerlukan token sendiri, aturnya di ANTHROPIC_AUTH_TOKEN.

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

Troubleshooting

Jalankan /status untuk melihat penyedia yang diselesaikan dan ID workspace, region, penggantian URL dasar, dan pengaturan skip-auth yang dikonfigurasi secara eksplisit. Ini adalah cara tercepat untuk mengonfirmasi Claude Code menargetkan Claude Platform on AWS sama sekali.

`403 Forbidden` atau `AccessDenied` pada setiap permintaan

Prinsipal IAM yang diselesaikan Claude Code kemungkinan besar tidak memiliki izin untuk memanggil layanan Anthropic di workspace Anda. Periksa peran yang terpasang pada profil AWS Anda atau runner yang memulai Claude Code, dan verifikasi bahwa ia memiliki tindakan aws-external-anthropic yang didokumentasikan dalam referensi tindakan IAM. Jika Anda menetapkan ANTHROPIC_AWS_API_KEY, kunci mengambil prioritas atas SigV4 dan kunci yang sudah usang menghasilkan kesalahan yang sama. Buat ulang kunci di AWS Console di bawah Claude Platform on AWS → API keys atau batalkan variabel untuk kembali ke kredensial AWS Anda.

Permintaan gagal dengan kesalahan workspace yang hilang

ANTHROPIC_AWS_WORKSPACE_ID kemungkinan besar tidak diatur atau kosong. Setiap permintaan Claude Platform on AWS harus menyertakan ID workspace. Ini tidak tersirat oleh kredensial AWS Anda. Temukan ID di setup Claude Platform on AWS Anda dan ekspor sebelum memulai Claude Code.

Permintaan masih pergi ke `api.anthropic.com`

CLAUDE_CODE_USE_ANTHROPIC_AWS kemungkinan besar tidak diatur atau diatur ke nilai yang tidak diuraikan sebagai truthy. Aturnya ke 1 dan jalankan /status untuk mengonfirmasi penyedia yang diselesaikan. Jika CLAUDE_CODE_USE_BEDROCK atau CLAUDE_CODE_USE_FOUNDRY juga diatur, keduanya mengambil prioritas atas Claude Platform on AWS.

Sumber daya tambahan

Langganan Claude Platform on AWS, workspace, dan penyiapan IAM yang dilakukan sebelum mengonfigurasi Claude Code tercakup dalam dokumentasi platform:

Claude Platform on AWS overview: langganan, penyiapan workspace, dan referensi produk
IAM action reference: izin dan kebijakan terkelola

Penyiapan dan akses

Deployment

Gateway

Penggunaan dan biaya

Keamanan dan data

Adopsi

Claude Code pada Claude Platform on AWS

Prasyarat

Penyiapan

Konfigurasikan kredensial AWS

Gunakan kredensial AWS dengan SigV4

Gunakan kunci API workspace

Konfigurasikan Claude Code

Sematkan versi model

Jalankan dan verifikasi

Gunakan Agent SDK

Rute melalui proxy korporat

Troubleshooting

`403 Forbidden` atau `AccessDenied` pada setiap permintaan

Permintaan gagal dengan kesalahan workspace yang hilang

Permintaan masih pergi ke `api.anthropic.com`

Sumber daya tambahan

​Prasyarat

​Penyiapan

​ Konfigurasikan kredensial AWS

​Gunakan kredensial AWS dengan SigV4

​Gunakan kunci API workspace

​ Konfigurasikan Claude Code

​ Sematkan versi model

​ Jalankan dan verifikasi

​Gunakan Agent SDK

​Rute melalui proxy korporat

​Troubleshooting

​403 Forbidden atau AccessDenied pada setiap permintaan

​Permintaan gagal dengan kesalahan workspace yang hilang

​Permintaan masih pergi ke api.anthropic.com

​Sumber daya tambahan

Prasyarat

Penyiapan

Konfigurasikan kredensial AWS

Gunakan kredensial AWS dengan SigV4

Gunakan kunci API workspace

Konfigurasikan Claude Code

Sematkan versi model

Jalankan dan verifikasi

Gunakan Agent SDK

Rute melalui proxy korporat

Troubleshooting

`403 Forbidden` atau `AccessDenied` pada setiap permintaan

Permintaan gagal dengan kesalahan workspace yang hilang

Permintaan masih pergi ke `api.anthropic.com`

Sumber daya tambahan