--- title: Claude di Amazon Bedrock (Opus 4.7 dan yang lebih baru) url: https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock description: Akses model Claude melalui Amazon Bedrock dengan autentikasi, penagihan, dan batas keamanan native AWS. --- Panduan ini memandu Anda dalam menyiapkan dan melakukan panggilan API ke Claude di Amazon Bedrock. Claude di Amazon Bedrock berjalan pada infrastruktur yang dikelola AWS dengan akses operator nol (personel Anthropic tidak memiliki akses ke infrastruktur inferensi), sehingga Anda dapat membangun aplikasi sensitif sepenuhnya di dalam batas keamanan AWS sambil menggunakan bentuk Messages API yang sama dengan yang Anda gunakan pada API pihak pertama Anthropic. Halaman ini membahas Claude di Amazon Bedrock, yang menyajikan Claude melalui Messages API di `/anthropic/v1/messages` pada infrastruktur yang dikelola AWS. Integrasi Amazon Bedrock sebelumnya (API `InvokeModel` dan `Converse` dengan pengidentifikasi model berversi ARN) tetap tersedia dan didokumentasikan di [Claude di Amazon Bedrock (Opus 4.6 dan yang lebih lama)](https://platform.claude.com/docs/id/build-with-claude/claude-on-amazon-bedrock-legacy). Untuk alternatif yang dioperasikan Anthropic di AWS dengan penagihan AWS Marketplace dan akses fitur yang biasanya tersedia di hari yang sama, lihat [Claude Platform on AWS](https://platform.claude.com/docs/id/build-with-claude/claude-platform-on-aws). ## Akses Amazon Bedrock menetapkan kriteria akses untuk setiap model Claude secara individual. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7, dan Claude Haiku 4.5 terbuka untuk semua pelanggan Amazon Bedrock. Untuk kriteria terkini model lainnya, periksa [akses model Amazon Bedrock](https://console.aws.amazon.com/bedrock/home#/modelaccess) di konsol AWS. Claude Mythos Preview memerlukan undangan melalui [Project Glasswing](https://anthropic.com/glasswing). Untuk ketersediaan region, lihat [Region](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock#regions). ## Prasyarat Sebelum memulai, pastikan Anda memiliki: * Akun AWS dengan [akses model Amazon Bedrock](https://console.aws.amazon.com/bedrock/home#/modelaccess) yang diaktifkan untuk model Claude yang ingin Anda gunakan. * [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) yang terinstal dan terkonfigurasi (opsional, untuk manajemen kredensial). Claude Mythos Preview juga memerlukan akun AWS khusus yang telah dimasukkan ke dalam allowlist oleh tim Bedrock Marketplace. Account executive Anthropic Anda dapat mengajukan ID akun Anda untuk dimasukkan ke allowlist (biasanya diproses dalam 24 jam), dan AWS akan mengirimkan email sambutan setelah prosesnya selesai. ## Autentikasi Claude di Amazon Bedrock mendukung tiga jalur autentikasi. Pilih yang paling sesuai dengan persyaratan keamanan Anda. ### Service role Bedrock (direkomendasikan) Gunakan service role Bedrock dengan kunci yang dikelola AWS untuk akses jangka panjang yang paling aman: Administrator AWS menyediakan service role Bedrock dan memberikan izin `iam:PassRole` kepada developer pada ARN service role tersebut. Saat memanggil API, Bedrock mengambil (assume) service role tersebut atas nama Anda. Lihat [dokumentasi Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-mantle.html) untuk cara mengaitkan role dengan permintaan Anda. ### IAM assumed role Untuk akses terfederasi identitas dengan sesi maksimum 12 jam: Buat IAM role yang dibatasi cakupannya pada model Claude Anda. Trust policy menyebutkan penyedia identitas Anda (SAML, OIDC, atau AWS Identity Center). Permissions policy memberikan `bedrock-mantle:CreateInference` hanya pada ARN model yang diizinkan. Lakukan autentikasi melalui penyedia identitas perusahaan Anda, lalu assume IAM role tersebut. AWS STS menerbitkan kredensial sementara yang digunakan SDK atau CLI untuk menandatangani permintaan. ### Bearer token Untuk akses jangka pendek tanpa IAM role (maksimum 12 jam, paling tidak disarankan): Blokir kunci jangka panjang dengan melampirkan policy yang menolak `bedrock:CallWithBearerToken` kecuali kondisi `bedrock:BearerTokenType` cocok dengan token jangka pendek. Gunakan CLI `aws-bedrock-token-generator` untuk membuat bearer token. Teruskan token tersebut dalam header `x-api-key` pada setiap permintaan. ## Instal SDK [SDK klien](https://platform.claude.com/docs/id/cli-sdks-libraries/overview) Anthropic mendukung Claude di Amazon Bedrock melalui paket atau modul khusus Bedrock. ```bash pip install -U "anthropic[bedrock]" ``` ```bash npm install @anthropic-ai/bedrock-sdk ``` ```bash dotnet add package Anthropic.Bedrock ``` ```bash go get github.com/anthropics/anthropic-sdk-go/bedrock ``` ```kotlin implementation("com.anthropic:anthropic-java:2.73.0") implementation("com.anthropic:anthropic-java-bedrock:2.73.0") ``` ```xml com.anthropic anthropic-java 2.73.0 com.anthropic anthropic-java-bedrock 2.73.0 ``` ```bash composer require anthropic-ai/sdk aws/aws-sdk-php ``` ```bash # Gemfile gem "anthropic" gem "aws-sdk-core" ``` ## Membuat permintaan pertama Anda Endpoint mengikuti pola `https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages`. Tidak seperti integrasi berbasis `InvokeModel`, endpoint ini menggunakan streaming SSE standar dan bentuk body permintaan yang sama dengan API pihak pertama Anthropic. SDK menentukan kredensial dan region menggunakan urutan prioritas standar AWS: argumen konstruktor, lalu variabel lingkungan (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_REGION`), lalu file konfigurasi AWS dan rantai kredensial (SSO, assumed role, ECS task role, IMDS). ```bash curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \ --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \ --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \ -H "x-amz-security-token: $AWS_SESSION_TOKEN" \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "anthropic.claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` CLI `ant` tidak mendukung Amazon Bedrock. Gunakan cURL atau SDK. ```python from anthropic import AnthropicBedrockMantle client = AnthropicBedrockMantle(aws_region="us-east-1") message = client.messages.create( model="anthropic.claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], ) print(next(block.text for block in message.content if block.type == "text")) ``` ```typescript import { AnthropicBedrockMantle } from "@anthropic-ai/bedrock-sdk"; const client = new AnthropicBedrockMantle({ awsRegion: "us-east-1" }); const message = await client.messages.create({ model: "anthropic.claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }] }); const textBlock = message.content.find((block) => block.type === "text"); if (textBlock) { console.log(textBlock.text); } ``` ```csharp using Anthropic.Bedrock; using Anthropic.Models.Messages; var client = new AnthropicBedrockMantleClient(new() { AwsRegion = "us-east-1" }); var message = await client.Messages.Create(new() { Model = "anthropic.claude-opus-5-5", MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], }); foreach (var item in message.Content) { if (item.Value is TextBlock block) { Console.WriteLine(block.Text); break; } } ``` ```go client, err := bedrock.NewMantleClient(context.Background(), bedrock.MantleClientConfig{ AWSRegion: "us-east-1", }) if err != nil { panic(err) } message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{ Model: "anthropic.claude-opus-5-5", MaxTokens: 1024, Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")), }, }) if err != nil { panic(err) } for _, block := range message.Content { if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok { fmt.Println(textBlock.Text) break } } ``` ```java import com.anthropic.bedrock.backends.BedrockMantleBackend; import com.anthropic.client.AnthropicClient; import com.anthropic.client.okhttp.AnthropicOkHttpClient; import com.anthropic.models.messages.ContentBlock; import com.anthropic.models.messages.Message; import com.anthropic.models.messages.MessageCreateParams; void main() { AnthropicClient client = AnthropicOkHttpClient.builder() .backend(BedrockMantleBackend.fromEnv()) .build(); Message message = client.messages().create( MessageCreateParams.builder() .model("anthropic.claude-opus-5-5") .maxTokens(1024) .addUserMessage("Hello, Claude") .build() ); message.content().stream() .filter(ContentBlock::isText) .findFirst() .ifPresent(block -> IO.println(block.asText().text())); } ``` ```php use Anthropic\Bedrock\MantleClient; $client = new MantleClient(awsRegion: 'us-east-1'); $message = $client->messages->create( model: 'anthropic.claude-opus-5-5', maxTokens: 1024, messages: [ ['role' => 'user', 'content' => 'Hello, Claude'], ], ); echo array_find($message->content, fn ($block) => $block->type === 'text')->text; ``` ```ruby require "anthropic" client = Anthropic::BedrockMantleClient.new(aws_region: "us-east-1") message = client.messages.create( model: "anthropic.claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}] ) puts message.content.find { it.type == :text }.text ``` Anda juga dapat membuat klien standar dengan `Anthropic` (go: `anthropic.NewClient()`; java: `AnthropicOkHttpClient.builder()`; csharp: `AnthropicClient`; php: `Anthropic\Client`; ruby: `Anthropic::Client`): atur `base_url` (typescript: `baseURL`; go: `option.WithBaseURL()`; java: `.baseUrl()`; csharp: `BaseUrl`; php: `baseUrl`) ke `https://bedrock-mantle.{region}.api.aws/anthropic` dan teruskan bearer token Anda sebagai `api_key` (typescript, php: `apiKey`; go: `option.WithAPIKey()`; java: `.apiKey()`; csharp: `ApiKey`). Jalur ini hanya mendukung autentikasi bearer token. Penandatanganan SigV4 memerlukan `AnthropicBedrockMantle` (csharp: `AnthropicBedrockMantleClient`; go: `bedrock.NewMantleClient`; java: `BedrockMantleBackend`; php: `MantleClient`; ruby: `Anthropic::BedrockMantleClient`). ## Model yang didukung ID model di Claude di Amazon Bedrock memiliki prefiks penyedia `anthropic.`. Kemampuan dan perilaku model didokumentasikan di halaman [Ikhtisar model](https://platform.claude.com/docs/id/models/overview). | Model | Model ID | Access | | :------------------------------------------------------------------------------------------ | :-------------------------------- | :-------------------------------------------------------------------------------------------------- | | Claude Fable 5.1 | `anthropic.claude-fable-5-1` | Open | | Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5-1` | Active (verification required) | | Claude Fable 5 | `anthropic.claude-fable-5` | Open | | Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5` | Active (verification required) | | Claude Mythos Preview ([limited availability](https://anthropic.com/glasswing)) | `anthropic.claude-mythos-preview` | Invitation only | | Claude Opus 5.5 | `anthropic.claude-opus-5-5` | [See Access](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 5 | `anthropic.claude-opus-5` | [See Access](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 4.8 | `anthropic.claude-opus-4-8` | Open | | Claude Opus 4.7 | `anthropic.claude-opus-4-7` | Open | | Claude Sonnet 5.5 | `anthropic.claude-sonnet-5-5` | [See Access](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Sonnet 5 | `anthropic.claude-sonnet-5` | Open | | Claude Haiku 5.5 | `anthropic.claude-haiku-5-5` | [See Access](https://platform.claude.com/docs/id/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Haiku 4.5 | `anthropic.claude-haiku-4-5` | Open | Gunakan versi terbaru Claude Code dengan Claude di Amazon Bedrock; jalankan `claude update` untuk memperbarui. Meng-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 [Bermigrasi ke model Claude yang lebih baru](https://platform.claude.com/docs/id/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model). ## Dukungan fitur Untuk daftar fitur lengkap beserta ketersediaannya di Amazon Bedrock, lihat [Ikhtisar fitur](https://platform.claude.com/docs/id/build-with-claude/overview). ### Sorotan fitur yang didukung * [Messages API](https://platform.claude.com/docs/id/api/messages/create) (`/anthropic/v1/messages`) * [Caching prompt](https://platform.claude.com/docs/id/build-with-claude/prompt-caching) * [Pemikiran](https://platform.claude.com/docs/id/build-with-claude/thinking) * [Penggunaan alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/overview), termasuk [alat Bash](https://platform.claude.com/docs/id/agents-and-tools/tool-use/bash-tool), [alat Computer use](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool), [alat Memory](https://platform.claude.com/docs/id/agents-and-tools/tool-use/memory-tool), dan [alat Text editor](https://platform.claude.com/docs/id/agents-and-tools/tool-use/text-editor-tool) * [Sitasi](https://platform.claude.com/docs/id/build-with-claude/citations) ### Fitur yang tidak didukung * [Output terstruktur](https://platform.claude.com/docs/id/build-with-claude/structured-outputs) * Sumber input (sumber URL untuk gambar dan dokumen, Files API) * Alat sisi server (eksekusi kode, pencarian web, web fetch, advisor) * Infrastruktur agen (Agent Skills, konektor MCP, pemanggilan alat terprogram) * Endpoint API (Message Batches, Models, Admin, Compliance, Usage and Cost) * Claude Managed Agents * Fallback sisi server ([parameter `fallbacks`](https://platform.claude.com/docs/id/build-with-claude/refusals-and-fallback#server-side-fallback); gunakan [pola fallback sisi klien](https://platform.claude.com/docs/id/build-with-claude/refusals-and-fallback#client-side-fallback) sebagai gantinya) * Toolset [computer use](https://platform.claude.com/docs/id/agents-and-tools/tool-use/computer-use-tool) dan [browser use](https://platform.claude.com/docs/id/agents-and-tools/tool-use/browser-use-tool) (`computer_toolset_20260801` dan `browser_toolset_20260801` saat ini tidak tersedia di Amazon Bedrock; versi beta alat computer use tetap tersedia) ## Region Claude di Amazon Bedrock tersedia di region AWS berikut. Amazon Bedrock menawarkan dua jenis endpoint: * **Global:** perutean dinamis di seluruh region yang tersedia untuk ketersediaan maksimum. Tanpa premi harga. * **Regional:** endpoint diarahkan ke satu region AWS yang Anda tentukan, untuk persyaratan residensi data. Endpoint regional dikenakan premi harga 10% dibandingkan endpoint global. Untuk merutekan ke beberapa region dalam satu wilayah geografis, gunakan "[inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html)" (profil inferensi) (US, EU, JP, atau AU). Region yang ditandai **In-region only** dalam tabel mendukung perutean langsung ke satu region tanpa profil inferensi. Endpoint global tersedia untuk Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5.5, Claude Sonnet 5, Claude Haiku 5.5, dan Claude Haiku 4.5. Untuk Claude Fable 5.1, endpoint regional saat ini hanya tersedia di `us-east-1`. Claude Mythos Preview hanya bersifat regional dan tersedia di `us-east-1`. | Region AWS | Lokasi | Jenis endpoint | | ---------------- | --------------------------- | -------------------------- | | `af-south-1` | Afrika (Cape Town) | Global | | `ap-northeast-1` | Asia Pasifik (Tokyo) | Global, JP, In-region only | | `ap-northeast-2` | Asia Pasifik (Seoul) | Global | | `ap-northeast-3` | Asia Pasifik (Osaka) | Global, JP | | `ap-south-1` | Asia Pasifik (Mumbai) | Global | | `ap-south-2` | Asia Pasifik (Hyderabad) | Global | | `ap-southeast-1` | Asia Pasifik (Singapura) | Global | | `ap-southeast-2` | Asia Pasifik (Sydney) | Global, AU | | `ap-southeast-3` | Asia Pasifik (Jakarta) | Global | | `ap-southeast-4` | Asia Pasifik (Melbourne) | Global, AU, In-region only | | `ca-central-1` | Kanada (Tengah) | Global, US | | `ca-west-1` | Kanada Barat (Calgary) | Global | | `eu-central-1` | Eropa (Frankfurt) | Global, EU | | `eu-central-2` | Eropa (Zurich) | Global, EU | | `eu-north-1` | Eropa (Stockholm) | Global, EU, In-region only | | `eu-south-1` | Eropa (Milan) | Global, EU | | `eu-south-2` | Eropa (Spanyol) | Global, EU | | `eu-west-1` | Eropa (Irlandia) | Global, EU, In-region only | | `eu-west-2` | Eropa (London) | Global, EU | | `eu-west-3` | Eropa (Paris) | Global, EU | | `il-central-1` | Israel (Tel Aviv) | Global | | `me-central-1` | Timur Tengah (UEA) | Global | | `sa-east-1` | Amerika Selatan (São Paulo) | Global | | `us-east-1` | AS Timur (N. Virginia) | Global, US, In-region only | | `us-east-2` | AS Timur (Ohio) | Global, US, In-region only | | `us-west-1` | AS Barat (N. California) | Global, US | | `us-west-2` | AS Barat (Oregon) | Global, US, In-region only | ## Kuota Kuota default adalah 2 juta token input per menit (TPM). Anda dapat meminta hingga 5 juta TPM input dan 500.000 TPM output tanpa persetujuan tambahan dari Anthropic. AWS memberlakukan batas requests-per-minute (RPM) di sisi Bedrock; hubungi dukungan AWS untuk penyesuaian RPM. ## Retensi data Penanganan data untuk penawaran ini diatur oleh Amazon Bedrock. Untuk detailnya, lihat [Perlindungan data di Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/data-protection.html). ## Pemantauan dan logging Claude di Amazon Bedrock mengirimkan log ke CloudWatch dan CloudTrail. Anthropic merekomendasikan untuk menyimpan log aktivitas setidaknya secara bergulir selama 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah. ## Dukungan Untuk dukungan, hubungi **[bedrock-ant-eap@amazon.com](mailto:bedrock-ant-eap@amazon.com)**. Sertakan ID akun AWS Anda dan `request-id` dari respons API yang gagal. **Claude Mythos Preview** adalah model pratinjau riset yang tersedia bagi pelanggan yang diundang di Amazon Bedrock. Untuk informasi lebih lanjut, lihat [Project Glasswing](https://anthropic.com/glasswing).