Claude Platform on AWS

Claude Platform on AWS memberi Anda pengalaman platform Anthropic secara penuh, termasuk Messages API, Agent Skills, eksekusi kode, dan fitur beta, yang dapat diakses melalui akun AWS Anda. Tidak seperti Amazon Bedrock, di mana AWS mengoperasikan stack inferensi, Anthropic mengoperasikan Claude Platform on AWS. AWS menyediakan lapisan autentikasi (SigV4 atau kunci API), kontrol akses berbasis IAM, dan integrasi penagihan melalui AWS Marketplace.

Cara kerja integrasi platform

Model Claude berjalan di infrastruktur yang dikelola Anthropic. Ini adalah integrasi komersial untuk penagihan dan akses melalui AWS. Anthropic adalah pemroses data untuk input dan output inferensi. AWS memproses metadata penagihan dan identitas berdasarkan model marketplace. Pelanggan yang menggunakan Claude melalui Claude Platform on AWS tunduk pada ketentuan penggunaan data Anthropic.

Anthropic menggunakan infrastruktur AWS untuk memproses permintaan API Anda, menjalankan inferensi model, dan menyimpan konten workspace Anda (seperti prompt, output, file, Skills, dan batch). Untuk workspace yang dibuat sebelum 18 September 2026, 00:00 UTC, Anthropic mungkin memproses permintaan, menyimpan data, dan menjalankan inferensi di luar AWS. Dalam kedua kasus, sublayanan dapat berubah tanpa pemberitahuan. Atur parameter inference_geo per permintaan untuk mengunci inferensi ke geografi tertentu.

Claude Platform on AWS mengikuti kebijakan retensi data yang sama dengan Claude API pihak pertama. "Zero Data Retention" (Retensi Data Nol), atau ZDR, tersedia berdasarkan permintaan. Hubungi perwakilan akun Anthropic Anda untuk mengaktifkannya bagi organisasi Anda.

Claude Platform on AWS versus Amazon Bedrock

Kedua penawaran memungkinkan Anda menggunakan Claude melalui AWS, tetapi keduanya berbeda dalam arsitektur, permukaan API, dan ketersediaan fitur.

Jika Anda memerlukan Claude yang dioperasikan AWS, lihat Claude in Amazon Bedrock. Claude Platform on AWS menggunakan kumpulan kapasitas yang terpisah dari Claude API pihak pertama maupun Amazon Bedrock. Anda dapat menjalankan beban kerja di lebih dari satu platform dan melakukan failover di antara keduanya.

AWS PrivateLink didukung untuk menghubungkan VPC Anda ke endpoint Claude Platform on AWS.

Kapan memilih Bedrock: Organisasi di industri yang diregulasi yang memerlukan kepatuhan FedRAMP High, IL4, IL5, atau siap-HIPAA, atau yang memerlukan AWS sebagai satu-satunya pemroses data, sebaiknya menggunakan Claude in Amazon Bedrock. Bedrock berjalan sepenuhnya di infrastruktur yang dikendalikan AWS dengan AWS sebagai pihak yang mengoperasikan.

Penawaran mana yang Anda gunakan? Claude tersedia melalui beberapa produk yang berbeda:

• Claude Platform on AWS (halaman ini): Platform Claude API yang ditagih melalui AWS Marketplace. Dikelola di Claude Console dan AWS Console.
• Claude in Amazon Bedrock: Layanan native AWS. Dikelola di konsol Amazon Bedrock dan ditagih sebagai penggunaan layanan AWS.
• Claude Enterprise yang dibeli melalui AWS Marketplace: Paket claude.ai (produk chat Claude), bukan platform API. Dikelola di claude.ai, dan perilaku akun serta migrasinya berbeda dari yang dijelaskan di halaman ini. Lihat Claude Help Center.
• Akun Anthropic langsung: Claude API pihak pertama dan paket claude.ai yang ditagih oleh Anthropic. Dikelola di Claude Console dan di claude.ai.

Menyiapkan akun Anda

Penyiapan Claude Platform on AWS berlangsung dalam empat fase: mendaftar di halaman layanan AWS Console, menyelesaikan penyiapan organisasi Anthropic Anda, mencatat ID workspace Anda, dan masuk ke Claude Console.

1. 1

   Mendaftar di AWS Console

   1. Buka AWS Console dan navigasikan ke halaman layanan Claude Platform on AWS.
   2. Pilih Sign up.
   3. Di halaman Sign-up, tinjau ketentuannya (End User License Agreement Anthropic, AWS Privacy Notice, dan AWS Customer Agreement) lalu centang kotak persetujuan.
   4. Pilih Continue.

   Halaman menampilkan banner Sign-up in progress. Tetaplah di halaman tersebut. Pendaftaran memerlukan beberapa menit sementara AWS menangani langganan AWS Marketplace untuk Anda, lalu mengarahkan Anda secara otomatis.

   Jika organisasi Anda memiliki private offer dari Anthropic, Console akan mencarinya dan meminta Anda untuk menerimanya di AWS Marketplace. Lihat Private offers untuk detailnya.

2. 2

   Menyiapkan organisasi Anthropic Anda

   Setelah pendaftaran selesai, Anda diarahkan ke platform.claude.com/partner-signup.

   1. Masukkan alamat email pemilik organisasi Anda dan pilih Get started.
   2. Periksa kotak masuk email tersebut untuk tautan penyiapan dan ikuti tautannya. Jika browser Anda menampilkan halaman Signed in as a different account, pilih Log out and continue.
   3. Lengkapi formulir detail organisasi (nama organisasi, jenis entitas, negara, tujuan penggunaan) dan pilih Complete setup.

   Menyelesaikan penyiapan akan membuat organisasi Anthropic Anda dan menerima Commercial Terms of Service serta Usage Policy Anthropic. Halaman layanan AWS Console kini menampilkan navigasi kiri dengan Home, API keys, Quickstart, dan Workspaces.

3. 3

   Membuat workspace Anda dan mencatat ID-nya

   Setelah Anda menyelesaikan penyiapan, AWS Console meminta Anda untuk membuat workspace. Lihat Workspaces untuk detail tentang pengikatan region, pembatasan cakupan resource IAM, dan pembuatan workspace tambahan.

   Temukan ID workspace di bawah Workspaces pada halaman layanan Claude Platform on AWS di AWS Console atau di Claude Console. ID workspace menggunakan format wrkspc_ diikuti oleh pengidentifikasi alfanumerik.

4. 4

   Masuk ke Claude Console

   Akses ke Claude Console difederasikan melalui AWS IAM:

   1. Ambil peran IAM dengan izin aws-external-anthropic:AssumeConsole. Lihat Aksi IAM untuk Claude Platform on AWS.
   2. Dari halaman layanan Claude Platform on AWS, pilih Open Claude Console. AWS Console menerbitkan JWT dan mengarahkan Anda ke platform.claude.com.
   3. Saat pertama kali masuk, Anda diminta memasukkan alamat email. Masukkan email kerja Anda. Platform menyediakan pengguna Claude Console Anda secara just-in-time.

   Saat Anda masuk melalui AWS Console, Claude Console dibatasi cakupannya ke organisasi Claude Platform on AWS Anda. Indikator Account managed by AWS muncul di kiri bawah sidebar Claude Console.

Berpindah dari organisasi Anthropic yang sudah ada

Mendaftar ke Claude Platform on AWS selalu menyediakan organisasi Anthropic baru yang terikat ke akun AWS Anda. Tidak ada konversi di tempat: organisasi yang sudah ada, seperti organisasi Claude API pihak pertama, tidak dapat menjadi organisasi Claude Platform on AWS.

Rencanakan perpindahan dari organisasi yang sudah ada sebagai cutover ke organisasi baru:

• Buat organisasi baru terlebih dahulu. Daftar melalui AWS Console (lihat Menyiapkan akun Anda). Jika perpindahan Anda melibatkan private offer, selesaikan pendaftaran sebelum offer diterima: diskon berlaku sejak penerimaan, tidak secara retroaktif. Lihat Private offers.
• Buat ulang akses dan konfigurasi. Kunci API, workspace, dan pengaturan Claude Console tidak terbawa dari organisasi yang sudah ada. Buat workspace di organisasi baru dan alihkan aplikasi Anda ke autentikasi Claude Platform on AWS.
• Perbarui integrasi Anda. Claude Platform on AWS melayani Claude API (/v1/{endpoint}), sehingga bentuk permintaan dan respons tidak berubah dari Claude API pihak pertama. Yang berubah adalah base URL, metode autentikasi, dan header anthropic-workspace-id pada permintaan inferensi dan resource; lihat Membuat permintaan. Beberapa fitur platform berbeda; lihat Fitur yang tidak didukung.
• Lakukan cutover sesuai jadwal Anda sendiri. Organisasi baru independen dari organisasi Anda yang sudah ada, dan keduanya dapat melayani lalu lintas secara paralel. Tidak perlu cutover mendadak: pindahkan beban kerja secara bertahap hingga semua lalu lintas Anda berada di organisasi baru.

Setelah organisasi baru berjalan, perbedaannya terkonsentrasi pada penagihan dan autentikasi, yang ditangani melalui AWS:

• Penagihan berpindah ke AWS Marketplace: penggunaan ditagih dalam Claude Consumption Units, bukan kredit prabayar (lihat Penagihan), dan Anda menetapkan batas pengeluaran di halaman Billing (lihat Batas pengeluaran). Selama masa transisi, penagihan tetap terpisah: organisasi yang sudah ada terus ditagih seperti saat ini.
• Autentikasi dan akses berpindah ke AWS: permintaan diautentikasi dengan kredensial AWS atau dengan kunci API yang dibuat di AWS Console, bukan Claude Console (lihat Autentikasi). Keanggotaan organisasi dikelola melalui AWS IAM, bukan Claude Console (lihat Halaman yang tersedia), dan SDK klien Anthropic menyediakan kelas klien khusus platform (lihat Menginstal SDK).
• Penggunaan API sehari-hari bekerja seperti pada Claude API pihak pertama, kecuali jika disebutkan dalam batasan fitur. Sebelum memindahkan lalu lintas produksi, periksa batas laju Anda: organisasi baru ditempatkan pada tier Start, dan peningkatan batas dilakukan melalui perwakilan akun Anthropic Anda (lihat Batas laju dan kuota).

Untuk organisasi Claude Enterprise (claude.ai), yang berperilaku berbeda, lihat perbandingan penawaran.

Pemecahan masalah penyiapan akun

• "Sign-up failed: Failed to enable OutboundWebIdentityFederation": Jika Anda melihat banner ini saat pengiriman pertama, pilih Continue lagi. Pengaktifan IAM dapat memerlukan waktu sejenak untuk berlaku.
• Tidak ada indikator kemajuan selama pendaftaran: Pendaftaran memerlukan beberapa menit. Halaman menampilkan banner statis Sign-up in progress tanpa bilah kemajuan sementara AWS menyediakan akun Anda.
• "Signed in as a different account" setelah mengikuti tautan penyiapan: Pilih Log out and continue. Halaman akan mengautentikasi ulang Anda dengan alamat email yang Anda masukkan.
• Pesan "Not found" saat masuk: Pesan ini mungkin muncul sebentar selama pengalihan. Anda dapat mengabaikannya.
• Halaman Usage tidak menampilkan data setelah panggilan API pertama Anda: Data penggunaan dapat memerlukan beberapa menit untuk muncul di Claude Console.
• "Outbound web identity federation is disabled" pada panggilan API pertama Anda: Aktifkan federasi sekali per akun. Lihat Mengaktifkan outbound web identity federation.

Sebelum melakukan panggilan API

Pastikan Anda memiliki:

1. Akun AWS aktif dengan langganan ke Claude Platform on AWS (lihat Menyiapkan akun Anda)
2. AWS CLI yang sudah diinstal dan dikonfigurasi
3. Outbound web identity federation yang diaktifkan di akun AWS Anda, langkah penyiapan satu kali (lihat Mengaktifkan outbound web identity federation)
4. ID workspace Anda (lihat Mendapatkan ID workspace Anda)
5. Izin IAM untuk memanggil API: aksi aws-external-anthropic:CreateInference pada workspace Anda, ditambah aws-external-anthropic:CallWithBearerToken jika Anda mengautentikasi dengan kunci API (lihat Kebijakan IAM)

Mengaktifkan outbound web identity federation

Gateway Claude Platform on AWS memanggil sts:GetWebIdentityToken di sisi server untuk membuat JWT yang diteruskannya 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 adalah [ERROR] (FeatureEnabled) ... already enabled, pengaturan tersebut sudah aktif untuk akun Anda dan Anda dapat melanjutkan. Verifikasi dan ambil URL issuer akun Anda:

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

Mendapatkan ID workspace Anda

Anda membuat workspace dari AWS Console setelah menyelesaikan penyiapan akun (lihat Menyiapkan akun Anda). Workspace terikat ke satu region AWS. Anda dapat menemukan ID workspace di Claude Console di bawah Workspaces atau di bagian Workspaces pada halaman layanan AWS Console.

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

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'  # Your workspace's AWS region

Region wajib diisi. Klien SDK memunculkan error jika tidak ada region yang diatur. Berikan aws_region saat Anda membuat klien, atau atur AWS_REGION (atau AWS_DEFAULT_REGION). Semua region komersial AWS didukung.

Autentikasi

Claude Platform on AWS mendukung dua metode autentikasi: AWS IAM dengan penandatanganan permintaan Signature Version 4 (SigV4) (utama) dan autentikasi kunci API. Keduanya menggunakan base URL dan format permintaan yang sama.

Autentikasi SigV4

SigV4 adalah jalur native untuk enterprise dan terintegrasi dengan kebijakan, peran, dan audit AWS IAM Anda yang sudah ada. Konfigurasikan kredensial AWS menggunakan metode apa pun yang didukung oleh AWS default credential provider chain:

• Variabel lingkungan (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)
• File kredensial bersama (~/.aws/credentials)
• File konfigurasi bersama (~/.aws/config) termasuk SSO dan credential_process
• Web identity (AWS_WEB_IDENTITY_TOKEN_FILE dan AWS_ROLE_ARN) untuk IRSA dan GitHub Actions
• Kredensial kontainer ECS
• EC2 instance metadata service (IMDS)

Verifikasi bahwa kredensial Anda berfungsi:

aws sts get-caller-identity

Autentikasi kunci API

Untuk jalur integrasi yang lebih sederhana (pengembangan lokal dan skrip), Anda dapat mengautentikasi dengan kunci API alih-alih SigV4. Atur variabel lingkungan ANTHROPIC_AWS_API_KEY atau berikan api_key saat Anda membuat klien.

Buat kunci API di AWS Console di bawah Claude Platform on AWS → API keys. Pilih Generate a key, lalu salin nilai kuncinya. Berikan aksi IAM aws-external-anthropic:CallWithBearerToken kepada principal yang boleh menggunakan autentikasi kunci API.

Kunci API jangka pendek

Untuk beban kerja yang perlu menyerahkan kredensial ke proses terpisah (seperti gateway LLM, fungsi serverless, atau alat yang mendukung autentikasi bearer-token tetapi tidak SigV4), buat kunci API jangka pendek dari kredensial AWS Anda alih-alih menyediakan kunci berumur panjang di AWS Console.

AWS menerbitkan pustaka token-generator untuk JavaScript, Python, dan Java. Setiap pustaka membaca kredensial AWS Anda melalui provider chain standar dan mengembalikan token berbatas waktu yang Anda kirim sebagai Authorization: Bearer <token>. Masa berlaku token secara default adalah 12 jam dan dibatasi pada nilai terkecil dari durasi yang Anda minta, masa kedaluwarsa kredensial AWS Anda, dan 12 jam. Lihat README repositori yang ditautkan untuk instalasi dan opsi konfigurasi lengkap.

Berikan token yang dihasilkan ke SDK dengan cara yang sama seperti Anda memberikan kunci API yang dibuat di AWS Console:

from token_generator_for_aws_external_anthropic import TokenGenerator
from anthropic import AnthropicAWS

token = TokenGenerator(region="us-west-2").get_token()

client = AnthropicAWS(api_key=token, aws_region="us-west-2")

Jika Anda dapat membuat token secara lokal, proses Anda sudah memiliki kredensial SigV4, dan autentikasi SigV4 biasanya merupakan pilihan yang lebih sederhana. Gunakan kunci jangka pendek ketika proses yang melakukan panggilan API terpisah dari proses yang memegang kredensial AWS.

SDK tidak memperbarui kunci jangka pendek secara otomatis. Ketika token kedaluwarsa, buat token baru dan buat klien baru. Principal yang menggunakan token tetap memerlukan aksi IAM aws-external-anthropic:CallWithBearerToken.

Prioritas kredensial

Klien khusus platform menyelesaikan autentikasi dalam urutan berikut, dimulai dengan apa yang Anda berikan saat membuatnya:

1. api_key → header Authorization: Bearer
2. aws_access_key + aws_secret_key → AWS SigV4
3. aws_profile → AWS SigV4 dengan profil bernama
4. Variabel lingkungan ANTHROPIC_AWS_API_KEY → header Authorization: Bearer
5. Default AWS credential provider chain → AWS SigV4

Resolusi region

Klien membaca AWS_REGION dari lingkungan jika Anda tidak mengatur aws_region, dengan fallback ke AWS_DEFAULT_REGION untuk kompatibilitas dengan AWS SDK standar. Region wajib diisi dan tidak ada nilai default: AnthropicAWS memunculkan error jika argumen konstruktor maupun variabel lingkungan tidak diatur.

Menginstal SDK

SDK klien Anthropic mendukung Claude Platform on AWS. SDK Anda menyediakan AnthropicAWS, yang menangani penandatanganan SigV4, pembentukan base URL berbasis region, dan header anthropic-workspace-id.

pip install -U "anthropic[aws]"

Model yang tersedia

Model berikut tersedia di Claude Platform on AWS:

ID model identik dengan Claude API pihak pertama. Tidak ada ARN gaya Bedrock atau prefiks anthropic..

Model baru biasanya diluncurkan di Claude Platform on AWS pada hari yang sama dengan Claude API pihak pertama.

Membuat permintaan

Claude Platform on AWS menggunakan endpoint API yang sama dengan Claude API pihak pertama. Perbedaannya adalah base URL, metode autentikasi, dan header anthropic-workspace-id, yang mengidentifikasi workspace yang dituju oleh permintaan. Header ini wajib pada permintaan inferensi dan resource, seperti panggilan ke Messages API, Models API, Files API, dan endpoint Claude Managed Agents. Permintaan ke Admin API tidak memerlukannya.

Sebelum menjalankan contoh-contoh ini, selesaikan langkah-langkah di Sebelum melakukan panggilan API.

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

Klien membaca AWS_REGION (atau AWS_DEFAULT_REGION) dan ANTHROPIC_AWS_WORKSPACE_ID dari lingkungan. Anda dapat menimpa salah satunya dengan memberikan aws_region atau workspace_id saat Anda membuat klien. Region dan ID workspace keduanya wajib diisi. Konstruktor memunculkan error jika salah satunya tidak dapat diselesaikan.

Nilai --aws-sigv4 mengikuti format aws:amz:<region>:<service>. Nama layanan SigV4 adalah aws-external-anthropic, dan region harus cocok dengan region di URL endpoint Anda. Ketidakcocokan pada salah satunya menghasilkan error penolakan tanda tangan yang generik, bukan diagnostik yang spesifik.

Jendela konteks

Ukuran "context window" (jendela konteks) di Claude Platform on AWS identik dengan Claude API pihak pertama. Lihat Jendela konteks untuk batas per model.

Dukungan fitur

Claude Platform on AWS menggunakan endpoint Claude API secara langsung, yang berarti Anda mendapatkan paritas fitur penuh dengan Claude API pihak pertama (kecuali jika disebutkan dalam batasan fitur):

• Akses fitur: Karena Anthropic mengoperasikan kedua platform, sebagian besar fitur baru dan header beta menjadi tersedia di Claude Platform on AWS tanpa langkah integrasi terpisah. Lihat batasan fitur untuk pengecualian.
• Fitur beta: Berikan header anthropic-beta standar untuk mengakses fitur beta, sama seperti yang Anda lakukan dengan Claude API.
• Agent Skills: Gunakan Agent Skills bawaan dan kustom dengan parameter container.skills yang sama seperti Claude API. Semua Skills bawaan (PowerPoint, Excel, Word, PDF) langsung berfungsi.
• Eksekusi kode: Jalankan kode di sandbox terkelola Anthropic menggunakan alat eksekusi kode.
• Penggunaan alat: Semua kemampuan "tool use" (penggunaan alat) tersedia kecuali toolset computer use dan browser use; lihat Fitur yang tidak didukung.
• Thinking: Adaptive thinking, parameter effort, dan, pada model yang mendukungnya, "extended thinking" (pemikiran diperpanjang) berfungsi dengan parameter yang sama seperti Claude API.
• Streaming: Dukungan streaming SSE penuh untuk respons real-time.
• Pemrosesan batch: Kirim permintaan batch untuk beban kerja dengan throughput tinggi.
• Caching prompt: Cache alat, prompt sistem, dan riwayat pesan untuk mengurangi latensi dan biaya. Semua kemampuan "prompt caching" (caching prompt) (TTL 5 menit, TTL 1 jam, dan caching otomatis) tersedia.
• Files API: Unggah dan rujuk file di berbagai permintaan.
• "Customer-managed encryption keys" (kunci enkripsi yang dikelola pelanggan), atau CMEK: CMEK hanya tersedia dengan kunci AWS KMS. Kunci Google Cloud KMS dan Azure Key Vault tidak dapat didaftarkan. Kunci harus berupa kunci KMS single-region di akun AWS dan region yang sama dengan workspace tempat kunci tersebut dilampirkan, dan kebijakan kuncinya harus memberikan akses ke service principal aws-external-anthropic.amazonaws.com; lihat Menyiapkan CMEK di Claude Platform on AWS. Daftarkan dan lampirkan kunci di Claude Console; endpoint kunci eksternal juga tersedia, diotorisasi melalui aksi IAM. Tidak ada langkah validasi terpisah: kunci divalidasi secara implisit saat Anda melampirkannya ke workspace (panggilan attach melakukan satu putaran enkripsi/dekripsi), sehingga masalah kebijakan kunci muncul saat attach, bukan saat pendaftaran.
• Compliance API: Compliance API tersedia. Akses diotorisasi melalui aksi ListComplianceActivities AWS IAM.

Lihat tabel perbandingan untuk perbedaan ketersediaan fitur dari Amazon Bedrock.

Claude Managed Agents

Claude Managed Agents tersedia di Claude Platform on AWS, termasuk agen, lingkungan, sesi, deployment terjadwal, vault kredensial, penyimpanan memori, webhook, orkestrasi multiagen, dan sandbox yang di-host sendiri.

Sesi dan worker yang di-host sendiri di Claude Platform on AWS berbeda dari Claude Managed Agents pihak pertama dalam tiga hal:

• Autentikasi ulang sesi otonom: Sebuah sesi dapat berjalan secara otonom, tanpa event pengguna apa pun, hingga 6 jam. Setelah 6 jam, sesi memerlukan autentikasi ulang sebelum dapat dilanjutkan. Untuk melakukan autentikasi ulang, kirim event apa pun dengan peran pengguna ke sesi tersebut (lihat Event dan streaming). Claude Managed Agents pihak pertama tidak memiliki batas waktu berjalan untuk sesi otonom.
• Penyimpanan memori di lingkungan yang di-host sendiri: Sesi yang berjalan di lingkungan yang di-host sendiri tidak dapat melampirkan penyimpanan memori; sesi yang menyertakannya akan ditolak saat pembuatan. Sesi di lingkungan cloud melampirkan penyimpanan memori seperti biasa. Di Claude Managed Agents pihak pertama, sesi di lingkungan cloud maupun yang di-host sendiri dapat melampirkan penyimpanan memori.
• Autentikasi worker di lingkungan yang di-host sendiri: Worker melakukan autentikasi dengan AWS IAM (SigV4) atau kunci API yang dibuat di AWS Console, bukan kunci lingkungan. Kunci lingkungan yang dibuat di Claude Console tidak berfungsi dengan endpoint Claude Platform on AWS.

Fitur yang tidak didukung

Kemampuan berikut saat ini tidak tersedia di Claude Platform on AWS:

• Kesiapan HIPAA: Program siap-HIPAA dari Anthropic tidak tersedia. Lihat API dan retensi data.
• Toolset computer use dan browser use: computer_toolset_20260801 dan browser_toolset_20260801 saat ini tidak tersedia di Claude Platform on AWS. Versi alat computer use beta tetap tersedia untuk model yang tercantum di bawah Versi alat sebelumnya.

• Admin API: Endpoint workspace (create, get, list, update, dan archive pada /v1/organizations/workspaces), endpoint kunci eksternal (register, get, list, update, dan delete pada /v1/organizations/external_keys, untuk CMEK; kunci divalidasi saat dilampirkan ke workspace, bukan melalui endpoint validasi), dan endpoint tujuan telemetri tersedia. Endpoint Admin API lainnya (anggota organisasi, anggota workspace, undangan, kunci API, laporan penggunaan, laporan biaya, dan laporan batas laju) saat ini tidak tersedia. Sebagai gantinya, lihat data penggunaan dan biaya di Claude Console. AWS IAM mengelola keanggotaan organisasi.
• Manajemen anggota workspace: Menambahkan atau menghapus pengguna dari workspace individual tidak tersedia. Kebijakan AWS IAM pada ARN workspace mengontrol akses.
• Workspace Claude Code dan Analytics API: Workspace Claude Code dengan batas laju otomatis tidak tersedia. Penggunaan Claude Code muncul di tampilan penggunaan umum, bukan di layar khusus.
• Autentikasi OAuth: Tidak didukung. Gunakan autentikasi SigV4 atau kunci API.
• Fast mode: Tidak tersedia di Claude Platform on AWS.
• Endpoint API yang kompatibel dengan OpenAI: Tidak tersedia di Claude Platform on AWS.
• Tunnel MCP: Hanya server MCP yang diekspos melalui internet publik yang didukung.

Residensi data

Claude Platform on AWS mendukung geografi inferensi berikut:

• US: Inferensi tetap berada di dalam pusat data AS. Pengali harga 1,1x berlaku.
• Global: Inferensi dapat dirutekan ke pusat data mana pun yang dioperasikan Anthropic di seluruh dunia. Harga standar berlaku.

Atur geografi inferensi per permintaan dengan parameter inference_geo:

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

Jika Anda menghilangkan inference_geo, permintaan menggunakan default_inference_geo milik workspace jika dikonfigurasi, atau global jika tidak.

Kontrol geografi inferensi tingkat workspace (allowed_inference_geos dan default_inference_geo) juga tersedia di Claude Platform on AWS. Lihat Pembatasan tingkat workspace.

Workspace

Permintaan inferensi dan sumber daya di Claude Platform on AWS menargetkan sebuah workspace. Anda meneruskan ID workspace di header anthropic-workspace-id pada panggilan API ini. ID workspace menggunakan format bertag wrkspc_ diikuti oleh pengenal alfanumerik (misalnya, wrkspc_01AbCdEf23GhIj). Lihat Dapatkan ID workspace Anda jika Anda belum memilikinya.

Cakupan workspace

Workspace terikat pada satu region AWS. Workspace yang dibuat di us-west-2 hanya dapat diakses melalui endpoint us-west-2. Penggunaan, kuota, biaya, file, batch, dan Skills semuanya diakumulasikan per workspace, sehingga Anda mendapatkan rincian per region di Claude Console.

Workspace juga berfungsi sebagai sumber daya IAM utama untuk Claude Platform on AWS. Anda memberikan atau menolak akses ke workspace tertentu melalui kebijakan AWS IAM menggunakan ARN workspace. Segmen sumber daya ARN adalah ID berawalan wrkspc_ yang sama dengan yang Anda teruskan di header anthropic-workspace-id:

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

Sebagai contoh:

arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj

Lihat Kebijakan IAM untuk contoh kebijakan.

Mengelola workspace

Buat workspace tambahan, ganti nama workspace, atau arsipkan workspace dari halaman Workspaces di AWS Console atau dengan endpoint workspace Admin API. Endpoint ini tidak memerlukan header anthropic-workspace-id. Create dan list bekerja pada organisasi; get, update, dan archive menerima ID workspace di path URL. Workspace baru terikat pada region AWS dari endpoint yang Anda panggil untuk membuatnya (lihat Cakupan workspace). Dengan peran Admin, Anda juga dapat membuat, mengganti nama, dan mengarsipkan workspace dari halaman Workspaces di Claude Console.

Menggunakan Claude Console

Claude Platform on AWS menggunakan Claude Console standar di platform.claude.com. Saat Anda masuk dari AWS Console, indikator Account managed by AWS muncul di kiri bawah sidebar Claude Console dan Console dibatasi pada organisasi Claude Platform on AWS Anda. Console menyediakan analitik penggunaan, rincian biaya, visibilitas batas laju, manajemen workspace, serta halaman untuk mengelola file, Agent Skills, pekerjaan batch, dan sumber daya Claude Managed Agents (agen, sesi, lingkungan, vault kredensial, penyimpanan memori, dan webhook).

Masuk

Akses ke Claude Console difederasikan melalui AWS IAM. Lihat Siapkan akun Anda untuk alur masuk pertama kali secara lengkap. Singkatnya:

1. Asumsikan peran IAM dengan izin aws-external-anthropic:AssumeConsole. Lihat Tindakan IAM untuk Claude Platform on AWS.
2. Buka halaman Claude Platform on AWS di AWS Console.
3. Pilih Open Claude Console. AWS Console menerbitkan JWT dan mengarahkan Anda ke platform.claude.com.
4. Saat masuk pertama kali, Anda diminta memasukkan alamat email. Masukkan email kerja Anda. Platform menyediakan pengguna Claude Console Anda secara just-in-time.

Tersedia dua peran Claude Console: Admin dan Developer. Peran Admin memberikan akses ke semua halaman dan pengaturan Claude Console yang tersedia untuk Claude Platform on AWS. Peran Developer memberikan akses baca ke informasi penggunaan, biaya, batas laju, dan workspace. Hubungi perwakilan akun Anthropic Anda untuk menetapkan peran Admin atau Developer kepada sebuah principal.

Halaman yang tersedia

Kolom Melalui gateway AWS menunjukkan apakah halaman membaca dan menulis data melalui gateway AWS (dan karenanya diatur oleh tindakan IAM). Halaman yang ditandai Tidak membaca metadata tingkat organisasi langsung dari Anthropic dan melewati pemeriksaan tindakan IAM.

Beralih organisasi

Claude Console tidak mendukung peralihan organisasi untuk Claude Platform on AWS. Untuk mengakses organisasi lain, keluar dan lakukan autentikasi ulang melalui AWS Console menggunakan peran IAM untuk akun AWS organisasi tersebut.

Batas laju dan kuota

Organisasi di Claude Platform on AWS ditempatkan pada tier Start. Anthropic mengelola batas laju secara langsung, bukan melalui sistem kuota AWS.

Organisasi di Claude Platform on AWS dapat berpindah ke tier penggunaan yang lebih tinggi secara otomatis seiring mereka membangun riwayat faktur AWS Marketplace yang telah dibayar. Alur swalayan Request tier increase di Claude Console tidak tersedia: halaman Rate limits mengarahkan Anda ke perwakilan akun Anthropic Anda sebagai gantinya.

Untuk meminta batas yang lebih tinggi, hubungi perwakilan akun Anthropic Anda atau dukungan Anthropic. Sertakan hal berikut dalam permintaan Anda:

• Model yang batasnya perlu Anda naikkan
• Puncak token input per menit dan token output per menit untuk setiap model (bukan total harian)
• Perkiraan porsi input Anda yang merupakan konteks yang di-cache atau berulang (pembacaan cache tidak dihitung terhadap batas token input untuk sebagian besar model; lihat ITPM yang sadar cache)

Tier penggunaan adalah tingkatan tetap: setiap tier memasangkan batas laju dengan batas atas pengeluaran bulanan, dan berpindah ke tier yang lebih tinggi menaikkan keduanya. Untuk detail tier dan batas per model, lihat Batas laju.

Penagihan

Claude Platform on AWS menagih melalui AWS Marketplace. Penggunaan dinyatakan dalam Claude Consumption Units (CCU), diukur per jam, dan ditagihkan bulanan di akhir periode pada tagihan AWS Anda. CCU bukan kredit prabayar. Tidak ada saldo atau komitmen CCU.

Untuk harga CCU, mekanisme konversi, penerapan diskon, dan tarif token per model, lihat Harga Claude Platform on AWS.

Batas pengeluaran

Tier penggunaan Start, Build, dan Scale masing-masing memiliki batas atas pengeluaran bulanan; lihat batas atas pengeluaran per tier untuk nilai saat ini. Ketika penggunaan organisasi Anda untuk bulan kalender mencapai batas atas tier-nya, permintaan API gagal dengan error batas atas pengeluaran hingga pukul 00:00 UTC pada hari pertama bulan berikutnya, dan mencoba ulang lebih awal tidak akan berhasil. Batas atas pengeluaran dan batas laju termasuk dalam tier yang sama. Untuk menaikkan batas atas, atau untuk memulihkan akses setelah mencapainya, minta kenaikan tier melalui perwakilan akun Anthropic Anda atau dukungan Anthropic (lihat Batas laju dan kuota).

Anda juga dapat menetapkan batas pengeluaran bulanan Anda sendiri di bawah batas atas, setelah menambahkan setidaknya satu penerima di bawah Email recipients di halaman Billing:

• Batas pengeluaran organisasi: Buka Settings > Billing di Claude Console untuk menetapkan batas pengeluaran bulanan.
• Batas pengeluaran workspace: Di halaman Workspaces (platform.claude.com/settings/workspaces) di Claude Console, pilih sebuah workspace. Di panel yang terbuka, klik Spend limits.

Ketika penggunaan mencapai batas yang Anda tetapkan, permintaan gagal dengan HTTP 400 (lihat error batas pengeluaran) hingga pukul 00:00 UTC pada hari pertama bulan berikutnya, atau hingga Anda menaikkan atau menghapus batas tersebut.

Pengeluaran dihitung berdasarkan harga daftar dan dapat memerlukan sekitar 2 jam untuk mencerminkan penggunaan terbaru, sehingga penggunaan dapat melebihi batas atas atau batas sebelum permintaan mulai gagal. Kelebihan tersebut tetap ditagihkan. Ketika batas atas tier atau batas pengeluaran organisasi menghentikan permintaan Anda, pemberitahuan email dikirim ke penerima yang tercantum di bawah Email recipients di halaman Billing. Penerima berbasis peran, seperti semua admin, tidak tersedia di Claude Platform on AWS. Pemberitahuan batas atas tier juga dikirim ke alamat email yang digunakan saat pendaftaran AWS Marketplace.

Pemantauan dan logging

AWS CloudTrail dapat merekam semua permintaan ke Claude Platform on AWS. Operasi workspace, kunci eksternal, tujuan telemetri, kepatuhan, vault, dan webhook dicatat sebagai Management event secara default. Operasi inferensi, batch, file, skill, model, profil pengguna, dan Claude Managed Agents (selain vault dan webhook) diklasifikasikan sebagai Data event dan memerlukan konfigurasi logging data event secara eksplisit, yang menimbulkan biaya CloudTrail tambahan. Lihat referensi tindakan IAM untuk klasifikasi jenis event lengkap dan dokumentasi AWS CloudTrail untuk detail konfigurasi.

ID permintaan

Setiap respons menyertakan dua ID permintaan di header respons:

• ID permintaan AWS (x-amzn-requestid): ID utama, diindeks di CloudTrail. Gunakan ini saat menyelidiki permintaan melalui perangkat AWS atau saat menghubungi dukungan AWS.
• ID permintaan Anthropic (request-id): ID sekunder. Gunakan ini saat menghubungi dukungan Anthropic.

from anthropic import AnthropicAWS

client = AnthropicAWS()

response = client.messages.with_raw_response.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.headers.get("x-amzn-requestid"))  # AWS request ID
print(response.headers.get("request-id"))  # Anthropic request ID

message = response.parse()
print(message.content)

Anthropic merekomendasikan untuk mencatat aktivitas Anda setidaknya secara bergulir selama 30 hari untuk memahami pola penggunaan dan menyelidiki masalah.

Migrasi dari Amazon Bedrock

Jika saat ini Anda menggunakan Claude di Bedrock, migrasi ke Claude Platform on AWS memerlukan perubahan di seluruh integrasi Anda. Penandatanganan SigV4 tetap didukung, tetapi konteks penandatanganan, base URL, format API, ID model, klien dan paket SDK, format streaming, header permintaan, dan ketersediaan region semuanya berubah. Claude Platform on AWS juga menyediakan organisasi Anthropic baru. Tabel berikut merangkum perbedaannya.

Apa yang berubah

Perbedaan migrasi bergantung pada integrasi Bedrock mana yang Anda gunakan sebelumnya. Tabel berikut menunjukkan integrasi Bedrock saat ini (Messages API di bedrock-mantle.{region}.api.aws) dan integrasi InvokeModel lama.

Jika Anda menggunakan integrasi Bedrock saat ini, format body permintaan sudah berupa Messages API. Perubahannya adalah base URL, nama layanan SigV4, ID model, dan penambahan header anthropic-workspace-id. Jika Anda menggunakan InvokeModel lama atau Converse API, Anda juga perlu menulis ulang bentuk permintaan dan respons ke format Messages API. Lihat Claude on Amazon Bedrock (Opus 4.6 dan sebelumnya) untuk pemetaan bentuk permintaan.

Apa yang Anda dapatkan

• Biasanya akses di hari yang sama ke model dan fitur baru (lihat keterbatasan fitur)
• Agent Skills untuk pembuatan dokumen (PowerPoint, Excel, Word, PDF)
• Eksekusi kode di sandbox terkelola Anthropic
• Fitur beta Claude API yang tidak ditawarkan Amazon Bedrock, melalui header anthropic-beta (lihat keterbatasan fitur)
• Claude Console untuk visibilitas kuota dan analitik penggunaan
• Dukungan langsung dari Anthropic
• Autentikasi kunci API sebagai alternatif SigV4 (lihat Autentikasi kunci API)

Apa yang tetap sama

• Autentikasi AWS IAM (SigV4)
• AWS sebagai pihak penagih. Saluran penagihan berubah dari layanan AWS native ke AWS Marketplace (lihat Pertimbangan komersial).
• Pemenuhan komitmen AWS

Jebakan migrasi

Pertimbangan komersial

• Ketentuan layanan Anthropic: Menggunakan Claude Platform on AWS memerlukan penerimaan Ketentuan Layanan Komersial dan Kebijakan Penggunaan Anthropic. Jika organisasi Anda belum menerimanya (misalnya, jika Anda hanya menggunakan Claude melalui Bedrock), Anda akan diminta selama penyiapan akun. Lihat Siapkan akun Anda.
• Diskon dan penawaran privat: Diskon yang dinegosiasikan dan penawaran privat AWS Marketplace tidak berpindah secara otomatis antara Bedrock dan Claude Platform on AWS. Bekerja samalah dengan perwakilan akun Anthropic Anda untuk menyiapkan ketentuan komersial untuk Claude Platform on AWS.

Kebijakan IAM

Claude Platform on AWS terintegrasi dengan AWS IAM untuk kontrol akses. Anda memberikan atau menolak akses ke tindakan API tertentu pada workspace tertentu menggunakan sintaks kebijakan IAM standar.

Nama layanan SigV4 dan namespace tindakan IAM adalah aws-external-anthropic. Tindakan mengikuti pola aws-external-anthropic:<Action> (misalnya, aws-external-anthropic:CreateInference).

Contoh: menolak inferensi batch

Kebijakan berikut mengizinkan inferensi real-time sambil memblokir pemrosesan batch:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateInference",
        "aws-external-anthropic:CountTokens",
        "aws-external-anthropic:GetModel",
        "aws-external-anthropic:ListModels",
        "aws-external-anthropic:GetWorkspace"
      ],
      "Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"
    },
    {
      "Effect": "Allow",
      "Action": "aws-external-anthropic:ListWorkspaces",
      "Resource": "*"
    },
    {
      "Effect": "Deny",
      "Action": [
        "aws-external-anthropic:CreateBatchInference",
        "aws-external-anthropic:GetBatchInference",
        "aws-external-anthropic:ListBatchInferences"
      ],
      "Resource": "*"
    }
  ]
}

Tindakan GetBatchInference mengotorisasi rute metadata batch dan rute hasil batch. Menolaknya akan memblokir kedua pembacaan tersebut. Untuk kebijakan khusus Deny yang cocok untuk beban kerja yang sensitif terhadap ZDR, lihat Penguncian fitur untuk workspace yang sensitif terhadap ZDR.

Kebijakan terkelola

AWS menyediakan lima kebijakan terkelola (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess, dan AnthropicSelfHostedEnvironmentAccess) untuk pola akses umum. Untuk tindakan yang diberikan setiap kebijakan, daftar lengkap tindakan IAM, pemetaan rute ke tindakan, dan contoh kebijakan tambahan, lihat Tindakan IAM untuk Claude Platform on AWS.

Langkah selanjutnya

Sumber daya tambahan