Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 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.

​
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

​
1. Konfigurasi kredensial AWS

Claude Code mendukung dua metode autentikasi untuk Claude Platform on AWS. Pilih metode yang sesuai dengan cara tim Anda mengelola akses. Opsi A: Kredensial AWS dengan SigV4 Claude Code menandatangani permintaan dengan SigV4 menggunakan rantai kredensial AWS standar: variabel lingkungan, kredensial bersama di ~/.aws/credentials, peran IAM, sesi AWS SSO, dan sumber lain apa pun yang didukung 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 berfungsi. 
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
Untuk CI dan otomasi, berikan runner peran IAM dengan izin untuk memanggil layanan Anthropic dan atur AWS_REGION. Rantai kredensial mengambil peran secara otomatis. Jika kredensial SSO Anda kedaluwarsa di tengah sesi, konfigurasi awsAuthRefresh sehingga Claude Code menjalankan kembali perintah login Anda dan mencoba lagi alih-alih gagal. Tambahkan perintah ke settings.json Anda: 
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
Opsi B: Kunci API Workspace Kunci API workspace adalah rahasia yang tahan lama, berguna ketika Anda tidak ingin mengelola kredensial AWS yang terfederasi. Buat satu di AWS Console di bawah Claude Platform on AWS → API keys dan aturnya sebagai ANTHROPIC_AWS_API_KEY: 
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
Kunci dikirim sebagai x-api-key dan mengambil prioritas atas SigV4, sehingga kredensial AWS apa pun di lingkungan Anda diabaikan. Kunci API dari organisasi Claude Console terpisah tidak akan berfungsi di sini. Perlakukan kunci API workspace seperti kredensial produksi lainnya. Blok env file pengaturan pengguna adalah cara yang nyaman untuk membatasi kunci ke mesin Anda tanpa mengekspornya secara global.
Perintah /login dan /logout tidak mengubah autentikasi Claude Platform on AWS. Autentikasi berjalan melalui kredensial AWS Anda atau kunci API workspace, bukan melalui langganan Claude.ai.

​
2. Konfigurasi Claude Code

Atur variabel lingkungan yang mengarahkan Claude Code melalui Claude Platform on AWS alih-alih API Anthropic 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 diperlukan dan dikirim pada setiap permintaan sebagai header anthropic-workspace-id. URL dasar dihitung dari AWS_REGION sebagai https://aws-external-anthropic.{region}.api.aws. Untuk mengganti URL secara langsung, atur ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS bersifat opt-in bahkan ketika kredensial AWS ada di lingkungan Anda. Bedrock dan Foundry mengambil prioritas dalam perutean penyedia, jadi batalkan CLAUDE_CODE_USE_BEDROCK dan CLAUDE_CODE_USE_FOUNDRY jika diatur.

​
3. Sematkan versi model

Claude Platform on AWS menggunakan ID model yang sama seperti Claude API langsung. Alias default opus, sonnet, dan haiku diselesaikan ke versi terbaru yang tersedia di workspace Anda. Jika Anda menerapkan Claude Code ke tim, sematkan ID model secara eksplisit sehingga rilis baru tidak memindahkan semua orang sekaligus: 
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
Untuk daftar lengkap ID model dan alias, lihat Models overview. Untuk variabel terkait model lainnya, lihat Model configuration. Prompt caching diaktifkan secara otomatis. Penulisan cache 1 jam ditagih dengan tarif lebih tinggi daripada penulisan 5 menit. Untuk meminta TTL cache 1 jam alih-alih default 5 menit, atur ENABLE_PROMPT_CACHING_1H=1.

​
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 bawah Workspaces pada halaman layanan AWS Console 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: