Claude Platform on AWS
Claude Platform on AWS dioperasikan Anthropic dengan autentikasi IAM dan penagihan lewat AWS Marketplace.
Intisari
- Dioperasikan Anthropic, bukan AWS โ jadi paritas fiturnya sama hari dengan API utama.
- Berbeda dari Amazon Bedrock, yang dioperasikan AWS dengan subset fitur dan prefix model sendiri.
- ID model tetap polos (
claude-opus-5) โ tanpa prefixanthropic.. - Autentikasi SigV4 dengan kredensial AWS; wajib mengatur region dan
workspace_id. - Setelah client dibuat, seluruh kode aplikasi identik dengan API utama.
Tiga jalur ke Claude di AWS
| Claude API | Claude Platform on AWS | Amazon Bedrock | |
|---|---|---|---|
| Dioperasikan | Anthropic | Anthropic | AWS |
| Paritas fitur | Penuh | Penuh, hari yang sama | Subset |
| ID model | claude-opus-5 | claude-opus-5 | anthropic.claude-opus-5 |
| Autentikasi | API key | AWS SigV4 / IAM | AWS SigV4 / IAM |
| Penagihan | Anthropic | AWS Marketplace | AWS |
| Managed Agents | โ | โ | โ |
| Batches API | โ | โ | โ |
Kenapa kamu memilih Claude Platform on AWS: kamu butuh kontrol akses lewat IAM dan penagihan lewat AWS Marketplace, tanpa kehilangan fitur apa pun. Bedrock memberi ekosistem AWS yang lebih luas (Knowledge Bases, Agents, Guardrails), tapi rilisnya menyusul dan sebagian fitur belum tersedia.
Setup
uv add -U "anthropic[aws]"
from anthropic import AnthropicAWS
client = AnthropicAWS() # region & workspace_id dari environment
response = client.messages.create(
model="claude-opus-5", # โ ID polos, tanpa prefix
max_tokens=16000,
messages=[{"role": "user", "content": "Halo"}],
)
Dua nilai yang wajib ada
| Nilai | Env var | Catatan |
|---|---|---|
| AWS region | AWS_REGION | Wajib. Tidak ada default โ beda dengan AnthropicBedrock. |
| Workspace ID | ANTHROPIC_AWS_WORKSPACE_ID | Wajib. Mengarahkan request ke workspace Claude-mu. |
Kalau salah satu tidak ada, client gagal dibuat โ tidak ada request yang dikirim.
Sedangkan 403 berarti request sudah sampai server: kemungkinan
workspace_id salah, atau IAM principal-mu kekurangan izin.
Autentikasi
Client memakai rantai kredensial AWS standar:
- Argumen eksplisit ke konstruktor
- Environment:
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_SESSION_TOKEN - Shared profile (
~/.aws/credentials) - Assumed role / instance metadata (EC2, ECS, Lambda)
Endpoint-nya berpola https://aws-external-anthropic.{region}.api.aws/v1/...
dan request ditandatangani SigV4 dengan nama layanan aws-external-anthropic.
API key berumur pendek
Untuk kasus di mana SigV4 tidak praktis (browser, script sederhana), kamu bisa mencetak
API key sementara dan meneruskannya sebagai api_key. Masa berlakunya adalah
yang terpendek di antara: durasi yang diminta, masa berlaku kredensial dasarnya, dan 12 jam.
Setelah itu, semuanya sama
client.messages.create(...)
client.messages.stream(...)
client.messages.parse(...)
client.messages.count_tokens(...)
client.beta.messages.tool_runner(...)
Semua yang kamu pelajari di materi sebelumnya berlaku tanpa perubahan. Perbedaannya hanya di baris pembuatan client.
Bahasa lain
| Bahasa | Install | Client |
|---|---|---|
| Python | anthropic[aws] | AnthropicAWS() |
| TypeScript | @anthropic-ai/aws-sdk | new AnthropicAws() |
| Go | anthropic-sdk-go | anthropicaws.NewClient(...) |
| C# | Anthropic.Aws | new AnthropicAwsClient() |
Kesalahan yang sering terjadi
| Gejala | Penyebab |
|---|---|
| Error saat membuat client | AWS_REGION atau ANTHROPIC_AWS_WORKSPACE_ID belum diatur |
| 403 | workspace_id salah, atau IAM policy kurang izin |
| 404 pada model | Menambahkan prefix anthropic. โ itu untuk Bedrock, bukan di sini |
| Fitur dianggap tidak tersedia | Menerapkan daftar batasan Bedrock; platform ini punya paritas penuh |
Untuk sertifikasi AWS
Yang perlu kamu bedakan dengan jelas untuk ujian: Bedrock adalah layanan AWS dengan ekosistemnya sendiri (Knowledge Bases, Agents, Guardrails, Converse API), sedangkan Claude Platform on AWS adalah Claude API yang diakses lewat jalur AWS. Materi ujian AIP-C01 berfokus pada yang pertama โ jadi materi Bedrock berikutnya lebih relevan untuk sertifikasi, sementara halaman ini relevan untuk keputusan arsitektur nyata.
Rangkuman ini sengaja dipangkas ke bagian yang dipakai di roadmap. Buka sumber aslinya saat kamu butuh detail lengkap atau referensi parameter.