• Pesan
  • Managed Agents
  • Admin
Search...
⌘K
Langkah pertama
Pengenalan ClaudeMulai cepat
Membangun dengan Claude
Ikhtisar fiturMenggunakan Messages APIAlasan berhenti dan fallbackPenolakan dan fallbackKredit fallback
Kemampuan model
Pemikiran diperpanjangPemikiran adaptifUpayaAnggaran tugas (beta)Mode cepat (pratinjau riset)Output terstrukturSitasiStreaming PesanPemrosesan batchHasil pencarianStreaming penolakanDukungan multibahasaEmbeddings
Alat
IkhtisarCara kerja penggunaan alatTutorial: Membangun agen yang menggunakan alatMendefinisikan alatMenangani panggilan alatPenggunaan alat paralelTool Runner (SDK)Penggunaan alat ketatPenggunaan alat dengan caching promptAlat serverPemecahan masalahAlat pencarian webAlat pengambilan webAlat eksekusi kodeAlat penasihatAlat memoriAlat BashAlat penggunaan komputerAlat editor teks
Infrastruktur alat
Referensi alatMengelola konteks alatKombinasi alatPencarian alatPemanggilan alat terprogramStreaming alat terperinci
Manajemen konteks
Jendela konteksPemadatanPengeditan konteksCaching promptPesan sistem di tengah percakapanMembangun mode orkestrasiDiagnostik cache (beta)Penghitungan token
Bekerja dengan file
Files APIDukungan PDFGambar dan visi
Skills
IkhtisarMulai cepatPraktik terbaikSkills untuk enterpriseSkills di API
MCP
Server MCP jarak jauhKonektor MCP
Claude di platform cloud
Amazon BedrockAmazon Bedrock (lama)Claude Platform di AWSMicrosoft FoundryVertex AI
Log in
Claude Platform di AWS
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Pesan/Claude di platform cloud

Claude Platform di AWS

Akses kemampuan platform Claude secara penuh melalui AWS dengan infrastruktur yang dikelola Anthropic.

Claude Platform di 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. Berbeda dengan Amazon Bedrock, di mana AWS mengoperasikan tumpukan inferensi, Anthropic mengoperasikan Claude Platform di AWS. AWS menyediakan lapisan autentikasi (SigV4 atau kunci API), kontrol akses berbasis IAM, dan integrasi penagihan melalui AWS Marketplace.

SDK Anthropic mendukung Claude Platform di AWS.

Cara kerja integrasi platform

Model Claude berjalan pada 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 di bawah model marketplace. Pelanggan yang menggunakan Claude melalui Claude Platform di AWS tunduk pada ketentuan penggunaan data Anthropic. Anthropic terus memberikan komitmen keamanan dan data terdepan di industri.

Perhatikan karakteristik operasional berikut: data mungkin tidak berada di AWS; inferensi dapat dirutekan ke cloud utama Anthropic; dan sublayanan dapat berpindah di balik layar tanpa pemberitahuan. Atur parameter inference_geo per permintaan untuk menetapkan inferensi ke geografi tertentu.

Claude Platform di 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 di AWS vs Amazon Bedrock

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

AspekClaude Platform di AWSClaude di Amazon BedrockAmazon Bedrock (legacy)
Siapa yang mengoperasikan tumpukanAnthropicAWSAWS
Permukaan APIClaude API (/v1/{endpoint})Messages API di /anthropic/v1/messagesBedrock Converse / InvokeModel
Ketersediaan fiturBiasanya pada hari yang sama dengan Claude API (lihat keterbatasan fitur)Sesuai jadwal rilis Amazon BedrockSesuai jadwal rilis Amazon Bedrock
Agent SkillsTersedia (beta)Tidak tersedia (memerlukan eksekusi kode)Tidak tersedia
Fitur betaDiteruskan dengan header anthropic-beta (lihat keterbatasan fitur)Header anthropic-beta tidak didukungHeader anthropic-beta tidak didukung
AutentikasiAWS IAM / SigV4 atau kunci APIAWS IAM / SigV4AWS IAM / SigV4 atau bearer token (hanya SDK C#, Go, dan Java)
PenagihanAWS MarketplaceAWS (layanan native)AWS (layanan native)
Base URLaws-external-anthropic.{region}.api.awsbedrock-mantle.{region}.api.awsbedrock-runtime.{region}.amazonaws.com
Klien SDKKelas klien khusus platform (misalnya, AnthropicAWS di Python), dalam betaAnthropicBedrockMantleAnthropicBedrock / Bedrock SDK
KonsolClaude Console (platform.claude.com, akses melalui AWS Console)Bedrock ConsoleBedrock Console
Batas laju dan kuotaDikelola oleh AnthropicDikelola oleh AWSDikelola oleh AWS
Pemroses data inferensiAnthropicAWSAWS

Jika Anda membutuhkan Claude yang dioperasikan AWS, lihat Claude di Amazon Bedrock. Claude Platform di AWS menggunakan kumpulan kapasitas 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 di AWS.

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

Menyiapkan akun Anda

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

Mendaftar melalui AWS Console akan menyediakan organisasi Anthropic baru yang terikat dengan akun AWS Anda. Organisasi ini terpisah dari organisasi apa pun yang sudah dimiliki perusahaan Anda dengan Anthropic, termasuk organisasi Claude Enterprise yang diperoleh melalui AWS Marketplace. Kunci API, workspace, dan pengaturan Claude Console dari organisasi Anthropic pihak pertama tidak terbawa.

Jika Anda memiliki private offer Amazon Bedrock yang sudah ada, hubungi perwakilan akun Anthropic atau AWS Anda sebelum mendaftar agar diskon Anda berlaku sejak permintaan pertama. Diskon tidak dapat diterapkan secara retroaktif pada penggunaan yang terjadi sebelum private offer Anda diterima. Lihat Private offer.

  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 ketentuan (End User License Agreement Anthropic, AWS Privacy Notice, dan AWS Customer Agreement) dan centang kotak persetujuan.
    4. Pilih Continue.

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

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

    Jika Anda menggunakan Claude Platform di AWS, konten Anda (seperti prompt dan completion) diproses oleh Anthropic di luar AWS. Lihat kebijakan penggunaan data Anthropic untuk detail tentang bagaimana konten dan metadata diproses dan disimpan.

  2. 2

    Menyiapkan organisasi Anthropic Anda

    Setelah pendaftaran selesai, Anda dialihkan 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 dan Usage Policy Anthropic. Halaman layanan AWS Console sekarang 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 Workspace untuk detail tentang pengikatan region, pelingkupan sumber daya 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. Asumsikan peran IAM dengan izin aws-external-anthropic:AssumeConsole. Lihat Tindakan IAM untuk Claude Platform di AWS.
    2. Dari halaman layanan Claude Platform on AWS, pilih Open Claude Console. AWS Console menerbitkan JWT dan mengalihkan Anda ke platform.claude.com.
    3. Pada saat masuk pertama kali, 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 dilingkupkan ke organisasi Claude Platform di AWS Anda. Indikator Account managed by AWS muncul di kiri bawah sidebar Claude Console.

Pemecahan masalah penyiapan akun

  • "Sign-up failed: Failed to enable OutboundWebIdentityFederation": Jika Anda melihat banner ini pada pengiriman pertama, pilih Continue lagi. Pengaktifan IAM dapat memerlukan waktu sejenak untuk berlaku.
  • Tidak ada indikator progres selama pendaftaran: Pendaftaran memerlukan beberapa menit. Halaman menampilkan banner statis Sign-up in progress tanpa bilah progres 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" selama proses 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.

Sebelum melakukan panggilan API

Pastikan Anda memiliki:

  1. Akun AWS aktif dengan langganan Claude Platform di AWS (lihat Menyiapkan akun Anda)
  2. AWS CLI terinstal dan terkonfigurasi
  3. Outbound web identity federation diaktifkan pada akun AWS Anda (langkah penyiapan satu kali; lihat Mengaktifkan outbound web identity federation)
  4. ID workspace Anda (lihat Mendapatkan ID workspace Anda)

Mengaktifkan outbound web identity federation

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

CLI
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:

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

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

Mendapatkan ID workspace Anda

Anda membuat workspace dari AWS Console setelah menyelesaikan penyiapan akun (lihat Menyiapkan akun Anda). Workspace terikat pada 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:

CLI
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/awsRegion ke konstruktor, atau atur AWS_REGION (atau AWS_DEFAULT_REGION). Semua region komersial AWS didukung.

Autentikasi

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

Autentikasi SigV4

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

  • 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
  • Layanan metadata instans EC2 (IMDS)

Verifikasi bahwa kredensial Anda berfungsi:

CLI
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 apiKey ke konstruktor SDK.

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

Kunci API untuk Claude Platform di AWS dikelola di AWS Console, bukan Claude Console. Kunci yang dibuat di Claude Console standar (untuk akses API pihak pertama) tidak berfungsi dengan endpoint Claude Platform di AWS.

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 rantai penyedia standar dan mengembalikan token berbatas waktu yang berfungsi dengan header x-api-key. Masa berlaku token secara default adalah 12 jam dan dibatasi pada nilai terkecil di antara durasi yang Anda minta, masa berlaku 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 menyegarkan kunci jangka pendek secara otomatis. Ketika token kedaluwarsa, buat yang baru dan konstruksi klien baru. Principal yang menggunakan token tetap memerlukan tindakan IAM aws-external-anthropic:CallWithBearerToken.

Prioritas kredensial

Klien khusus platform menyelesaikan autentikasi dalam urutan berikut. Nama argumen bervariasi menurut konvensi bahasa (TypeScript dan PHP menggunakan camelCase seperti yang ditunjukkan; Python dan Ruby menggunakan snake_case; Go menggunakan PascalCase dengan akronim berhuruf kapital; C# dan Java menggunakan idiom properti atau builder bahasa tersebut).

  1. Argumen konstruktor apiKey → header x-api-key
  2. Argumen konstruktor awsAccessKey + awsSecretAccessKey → AWS SigV4
  3. Argumen konstruktor awsProfile → AWS SigV4 dengan profil bernama
  4. Variabel lingkungan ANTHROPIC_AWS_API_KEY → header x-api-key
  5. Rantai penyedia kredensial AWS default → AWS SigV4

Resolusi region

Klien membaca AWS_REGION dari lingkungan jika aws_region/awsRegion tidak diberikan ke konstruktor, dengan fallback ke AWS_DEFAULT_REGION untuk kompatibilitas dengan SDK AWS standar. Region wajib diisi; tidak ada default fallback. Berbeda dengan AnthropicBedrock, yang melakukan fallback ke us-east-1, klien AnthropicAWS/AnthropicAws memunculkan error jika baik argumen konstruktor maupun variabel lingkungan tidak diatur.

Menginstal SDK

SDK klien Anthropic mendukung Claude Platform di AWS. Setiap SDK menyediakan kelas klien khusus platform yang menangani penandatanganan SigV4, konstruksi base URL berbasis region, dan header anthropic-workspace-id.

Klien SDK untuk Claude Platform di AWS masih dalam beta.

Model yang tersedia

Model berikut tersedia di Claude Platform di AWS:

ModelID Model
Claude Fable 5claude-fable-5
Claude Opus 4.8claude-opus-4-8
Claude Opus 4.7claude-opus-4-7
Claude Opus 4.6claude-opus-4-6
Claude Sonnet 4.6claude-sonnet-4-6
Claude Opus 4.5claude-opus-4-5
Claude Sonnet 4.5claude-sonnet-4-5
Claude Haiku 4.5claude-haiku-4-5

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

Model baru diluncurkan di Claude Platform di AWS secara bersamaan dengan Claude API pihak pertama.

Melakukan upgrade ke model Claude yang lebih baru? Di Claude Code, jalankan /claude-api migrate untuk menerapkan penggantian ID model dan perubahan parameter yang bersifat breaking di seluruh codebase Anda. Skill ini mendeteksi platform cloud mana yang ditargetkan oleh kode Anda dan menyesuaikan format ID model serta perubahan fitur untuk platform tersebut. Lihat Migrasi ke model Claude yang lebih baru.

Membuat permintaan

Claude Platform di AWS menggunakan endpoint API yang sama dengan Claude API pihak pertama. Perbedaannya adalah base URL, metode autentikasi, dan header anthropic-workspace-id yang wajib untuk mengidentifikasi workspace mana yang ditargetkan permintaan.

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-4-6",
    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 / awsRegion atau workspace_id / workspaceId ke konstruktor. Baik region maupun ID workspace wajib diisi. Konstruktor memunculkan error jika ID workspace tidak dapat diselesaikan; region yang hilang juga memunculkan error.

Header x-amz-security-token (cURL) hanya diperlukan untuk kredensial sementara seperti peran IAM, SSO, atau STS. Hilangkan header ini saat menggunakan kredensial pengguna IAM jangka panjang. Klien SDK menangani ini secara otomatis berdasarkan sumber kredensial.

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 generik alih-alih diagnostik spesifik.

Jendela konteks

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

Dukungan fitur

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

  • Akses fitur: Karena Anthropic mengoperasikan kedua platform, sebagian besar fitur baru dan header beta tersedia di Claude Platform di AWS tanpa langkah integrasi terpisah. Lihat keterbatasan 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 dan header beta yang sama seperti Claude API. Semua Skills bawaan (PowerPoint, Excel, Word, PDF) berfungsi langsung.
  • Eksekusi kode: Jalankan kode di sandbox terkelola Anthropic menggunakan alat eksekusi kode.
  • Penggunaan alat: Computer use dan semua kemampuan penggunaan alat lainnya tersedia.
  • Pemikiran diperpanjang: Aktifkan pemikiran diperpanjang 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 caching prompt (TTL 5 menit, TTL 1 jam, dan caching otomatis) tersedia.
  • Files API: Unggah dan referensikan file di seluruh permintaan.
  • Customer-managed encryption keys (CMEK): CMEK tersedia hanya dengan kunci AWS KMS; kunci Google Cloud KMS dan Azure Key Vault tidak dapat didaftarkan. Buat, validasi, dan lampirkan kunci di Claude Console; endpoint Admin API external_keys saat ini tidak tersedia. Kunci harus berada di region AWS yang sama dengan workspace tempat kunci dilampirkan.
  • Compliance API: Compliance API tersedia. Akses diotorisasi melalui AWS IAM.

Lihat tabel perbandingan untuk perbedaan ketersediaan fitur dari Amazon Bedrock.

Claude Managed Agents

Claude Managed Agents tersedia di Claude Platform di AWS, termasuk agen, environment, sesi, credential vault, memory store, webhook, orkestrasi multiagen, dan sandbox self-hosted.

Perilaku sesi pada Claude Platform di AWS berbeda dari Claude Managed Agents pihak pertama dalam satu 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 dilanjutkan. Untuk mengautentikasi ulang, kirim event peran pengguna apa pun ke sesi (lihat Event dan streaming). Claude Managed Agents pihak pertama tidak memiliki batas waktu berjalan sesi otonom.

Fitur yang tidak didukung

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

  • Kesiapan HIPAA: Program HIPAA-ready Anthropic tidak tersedia. Lihat API dan retensi data.
  • Admin API: Endpoint workspace (create, get, list, update, dan archive pada /v1/organizations/workspaces) tersedia. Endpoint Admin API lainnya (anggota organisasi, anggota workspace, undangan, kunci API, laporan penggunaan, laporan biaya, laporan batas laju, dan kunci eksternal) saat ini tidak tersedia. Kelola kunci CMEK di Claude Console sebagai gantinya. Lihat data penggunaan dan biaya di Claude Console sebagai gantinya. 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.
  • Batas pengeluaran: Tidak tersedia. Andalkan kontrol penagihan AWS sebagai gantinya.
  • Workspace Claude Code dan Analytics API: Workspace Claude Code dengan batas laju otomatis tidak tersedia. Penggunaan Claude Code muncul di tampilan penggunaan umum alih-alih layar khusus.
  • Autentikasi OAuth: Tidak didukung. Gunakan autentikasi SigV4 atau kunci API.
  • Fast mode: Tidak tersedia di Claude Platform di AWS.
  • Endpoint API yang kompatibel dengan OpenAI: Tidak tersedia di Claude Platform di AWS.
  • Endpoint work-list sandbox self-hosted: Endpoint GET /v1/environments/{id}/work, yang mencantumkan pekerjaan tertunda untuk sandbox self-hosted, saat ini tidak tersedia. Endpoint work lainnya (poll, ack, heartbeat, stop, post results, per-item get, dan stats) berfungsi normal.
  • Tunnel MCP: Hanya server MCP yang diekspos melalui internet publik yang didukung.

Residensi data

Claude Platform di 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.

Region AWS tempat workspace Anda terikat mengontrol endpoint gateway mana yang Anda panggil dan di mana sumber daya sisi AWS (IAM, CloudTrail, penagihan) dilingkupkan. Ini tidak menetapkan di mana inferensi model berjalan. Untuk menetapkan inferensi ke geografi tertentu, atur inference_geo pada setiap permintaan atau konfigurasikan default workspace.

Atur geografi inferensi per permintaan dengan parameter inference_geo:

Parameter inference_geo didukung pada Claude Opus 4.6, Claude Sonnet 4.6, dan model yang lebih baru. Permintaan dengan inference_geo pada Claude Opus 4.5, Claude Sonnet 4.5, atau Claude Haiku 4.5 mengembalikan error 400. Lihat Residensi data untuk detail ketersediaan model.

from anthropic import AnthropicAWS

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

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

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

Workspace

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

Pelingkupan 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, memberi Anda rincian per region di Claude Console.

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

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

Misalnya:

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. Workspace baru terikat pada region AWS dari endpoint yang Anda panggil untuk membuatnya (lihat Pelingkupan workspace). Halaman Workspaces di Claude Console bersifat hanya-baca.

Menggunakan Claude Console

Claude Platform di 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 dilingkupkan ke organisasi Claude Platform di AWS Anda. Console menyediakan analitik penggunaan, rincian biaya, visibilitas batas laju, visibilitas workspace, dan halaman untuk mengelola file, Agent Skills, pekerjaan batch, dan sumber daya Claude Managed Agents (agen, sesi, environment, credential vault, memory store, dan webhook).

Masuk

Akses ke Claude Console difederasikan melalui AWS IAM. Lihat Menyiapkan 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 di AWS.
  2. Navigasikan ke halaman Claude Platform on AWS di AWS Console.
  3. Pilih Open Claude Console. AWS Console menerbitkan JWT dan mengalihkan Anda ke platform.claude.com.
  4. Pada saat masuk pertama kali, Anda diminta memasukkan alamat email; masukkan email kerja Anda. Platform menyediakan pengguna Claude Console Anda secara just-in-time.

Dua peran Claude Console tersedia: Admin dan Developer. Peran Admin memberikan akses ke semua halaman dan pengaturan Claude Console yang tersedia untuk Claude Platform di 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 ke sebuah principal.

Halaman yang tersedia

Kolom Through AWS gateway menunjukkan apakah halaman tersebut membaca dan menulis data melalui gateway AWS (dan oleh karena itu diatur oleh tindakan IAM). Halaman yang ditandai No membaca metadata tingkat organisasi langsung dari Anthropic dan melewati pemeriksaan tindakan IAM.

HalamanTersediaMelalui gateway AWSCatatan
UsageYaTidakMelihat penggunaan token berdasarkan model, workspace, dan dimensi. Data dapat memerlukan beberapa menit untuk muncul setelah permintaan.
CostYaTidakMelihat rincian biaya berdasarkan model dan workspace. AWS Cost Explorer menampilkan item baris Claude Consumption Unit (CCU) yang diagregasi.
LimitsYaTidakMelihat batas laju (hanya-baca).
WorkspacesYaTidakMelihat workspace per-region (hanya-baca).
FilesYaYaMelihat dan mengelola file yang diunggah.
SkillsYaYaMelihat dan mengelola Agent Skills.
BatchesYaYaMelihat dan mengelola pekerjaan pemrosesan batch.
AgentsYaYaMelihat dan mengelola definisi agen.
SessionsYaYaMelihat sesi agen dan riwayat peristiwa.
EnvironmentsYaYaMelihat dan mengelola konfigurasi sandbox cloud untuk sesi.
Credential vaultsYaYaMelihat dan mengelola credential vault untuk autentikasi sesi.
Memory storesYaYaMelihat dan mengelola memori agen yang persisten.
WebhooksYaYaMelihat dan mengelola endpoint webhook di bawah Settings → Webhooks.
API keysTidakN/AKelola kunci API di AWS Console (Claude Platform on AWS → API keys). Lihat Autentikasi kunci API.
MembersTidakN/ATidak berlaku. AWS IAM mengelola akses.
BillingTidakN/ATidak berlaku. AWS Marketplace mengelola penagihan dan pembuatan faktur. Lihat rincian biaya di halaman Cost.
Claude CodeTidakN/ALihat penggunaan Claude Code di halaman Usage.

Beralih organisasi

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

Batas laju dan kuota

Claude Platform on AWS menetapkan batas laju Tier 1 saat pendaftaran. Anthropic mengelola batas laju secara langsung, bukan melalui sistem kuota AWS.

Tidak seperti Claude API pihak pertama, peningkatan tier otomatis tidak berlaku. Jika Anda memerlukan batas yang lebih tinggi, hubungi perwakilan akun Anthropic Anda. 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" (Unit Konsumsi Claude), atau CCU, diukur per jam, dan ditagih bulanan di belakang 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.

Pemantauan dan pencatatan log

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

ID Permintaan

Setiap respons menyertakan dua ID permintaan dalam 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-4-6",
    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 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah apa pun.

AWS CloudTrail dikonfigurasi dalam akun AWS Anda. Mengaktifkan pencatatan log tidak memberikan AWS atau Anthropic akses ke konten Anda di luar yang diperlukan untuk penagihan dan operasi layanan.

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, URL dasar, format API, ID model, klien dan paket SDK, format streaming, header permintaan, dan ketersediaan region semuanya berubah. Tabel berikut merangkum perbedaannya.

Apa yang berubah

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

AspekDari Claude di Amazon BedrockDari Amazon Bedrock (lama)Ke Claude Platform on AWS
URL dasarbedrock-mantle.{region}.api.awsbedrock-runtime.{region}.amazonaws.comaws-external-anthropic.{region}.api.aws
Format APIMessages API di /anthropic/v1/messagesBedrock Converse / InvokeModelClaude API (/v1/{endpoint})
ID Modelanthropic.claude-opus-4-6anthropic.claude-opus-4-6-v1 (dengan prefiks opsional us./global.)claude-opus-4-6
Klien SDKAnthropicBedrockMantleAnthropicBedrock / Bedrock SDKKlien spesifik platform (lihat Instal SDK), dalam beta
Paket SDKanthropic[bedrock], @anthropic-ai/bedrock-sdk, dan lainnyaanthropic[bedrock], @anthropic-ai/bedrock-sdk, atau AWS SDKanthropic[aws], @anthropic-ai/aws-sdk, dan lainnya (lihat Instal SDK)
Nama layanan SigV4bedrock-mantlebedrockaws-external-anthropic
Format streamingSSEAWS EventStreamSSE (sama dengan Claude API)
Header workspaceTidak berlakuTidak berlakuanthropic-workspace-id diperlukan
Ketersediaan regionLihat region Amazon BedrockLihat region Amazon BedrockSemua region komersial AWS

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

Apa yang Anda dapatkan

  • Biasanya akses di hari yang sama ke model dan fitur baru (lihat batasan fitur)
  • Agent Skills untuk pembuatan dokumen (PowerPoint, Excel, Word, PDF)
  • Eksekusi kode di sandbox terkelola Anthropic
  • Fitur beta melalui header anthropic-beta (lihat batasan fitur)
  • Claude Console untuk visibilitas kuota dan analitik penggunaan
  • Dukungan langsung dari Anthropic
  • Autentikasi kunci API sebagai alternatif untuk 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)
  • Penghentian komitmen AWS

Jebakan migrasi

Aktifkan outbound web identity federation terlebih dahulu. Jika akun AWS Anda belum pernah menggunakan Claude Platform on AWS sebelumnya, Anda harus mengaktifkan outbound web identity federation satu kali per akun sebelum membuat permintaan. Tanpa langkah ini, semua permintaan gagal dengan error federasi (lihat Aktifkan outbound web identity federation untuk error yang tepat dan cara mengatasinya). Langkah ini tidak diperlukan untuk Bedrock.

Zero Data Retention (ZDR) bersifat opt-in di Claude Platform on AWS. Di Bedrock, AWS adalah pemroses data dan Anthropic tidak menyimpan input atau output inferensi; program ZDR Anthropic tidak berlaku di sana. Di Claude Platform on AWS, Anthropic memproses data inferensi sebagai pemroses data independen, dan ZDR mengikuti model Claude API pihak pertama: tersedia berdasarkan permintaan melalui perwakilan akun Anthropic Anda. Konfirmasikan pendaftaran ZDR sebelum memigrasikan beban kerja produksi yang bergantung pada jaminan retensi data.

Pertimbangan komersial

  • Ketentuan layanan Anthropic: Menggunakan Claude Platform on AWS mengharuskan Anda menerima Commercial Terms of Service dan Usage Policy Anthropic. Jika organisasi Anda belum menerima ketentuan ini (misalnya, jika Anda hanya menggunakan Claude melalui Bedrock), Anda akan diminta untuk menerimanya selama penyiapan akun. Lihat Siapkan akun Anda.
  • Diskon dan penawaran privat: Diskon yang dinegosiasikan dan penawaran privat AWS Marketplace tidak ditransfer 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 Deny-only yang cocok untuk beban kerja yang sensitif terhadap ZDR, lihat Penguncian fitur untuk workspace yang sensitif terhadap ZDR.

ListWorkspaces bercakupan akun, sehingga muncul dalam pernyataan Allow terpisah dengan "Resource": "*". Menentukan ARN workspace pada tindakan bercakupan akun tidak memiliki efek (lihat Otomatisasi penyediaan).

Kebijakan ini mengasumsikan autentikasi AWS SigV4. Jika principal mengautentikasi dengan kunci API, tambahkan juga aws-external-anthropic:CallWithBearerToken ke pernyataan Allow "Resource": "*". CallWithBearerToken adalah tindakan lapisan autentikasi tanpa rute yang tidak terikat ke ARN workspace. Lihat Isolasi workspace per-pelanggan untuk pola dua pernyataan.

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.

Sumber daya tambahan

  • Claude Console untuk Claude Platform on AWS: platform.claude.com (akses melalui AWS Console)
  • Detail harga: Harga
  • Bedrock (Claude yang dioperasikan AWS): Claude di Amazon Bedrock
  • AWS Marketplace: aws.amazon.com/marketplace

Was this page helpful?

  • Cara kerja integrasi platform
  • Claude Platform di AWS vs Amazon Bedrock
  • Menyiapkan akun Anda
  • Pemecahan masalah penyiapan akun
  • Sebelum melakukan panggilan API
  • Mengaktifkan outbound web identity federation
  • Mendapatkan ID workspace Anda
  • Autentikasi
  • Autentikasi SigV4
  • Autentikasi kunci API
  • Prioritas kredensial
  • Resolusi region
  • Menginstal SDK
  • Model yang tersedia
  • Membuat permintaan
  • Jendela konteks
  • Dukungan fitur
  • Claude Managed Agents
  • Fitur yang tidak didukung
  • Residensi data
  • Workspace
  • Pelingkupan workspace
  • Mengelola workspace
  • Menggunakan Claude Console
  • Masuk
  • Halaman yang tersedia
  • Beralih organisasi
  • Batas laju dan kuota
  • Penagihan
  • Pemantauan dan pencatatan log
  • ID Permintaan
  • Migrasi dari Amazon Bedrock
  • Apa yang berubah
  • Apa yang Anda dapatkan
  • Apa yang tetap sama
  • Jebakan migrasi
  • Pertimbangan komersial
  • Kebijakan IAM
  • Contoh: menolak inferensi batch
  • Kebijakan terkelola
  • Sumber daya tambahan