Claude Code di Amazon Bedrock

​

Prasyarat

• Akun AWS dengan akses Amazon Bedrock yang diaktifkan
• Akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4.6) di Amazon Bedrock
• AWS CLI terinstal dan dikonfigurasi (opsional - hanya diperlukan jika Anda tidak memiliki mekanisme lain untuk mendapatkan kredensial)
• Izin IAM yang sesuai

​

Masuk dengan Bedrock

​

Atur secara manual

​

1. Kirimkan detail kasus penggunaan

1. Pastikan Anda memiliki izin IAM yang tepat seperti dijelaskan di bawah
2. Navigasikan ke konsol Amazon Bedrock
3. Pilih model Anthropic dari Model catalog
4. Lengkapi formulir kasus penggunaan. Akses diberikan segera setelah pengajuan.

​

2. Konfigurasi kredensial AWS

aws configure

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

aws sso login --profile=your-profile-name

export AWS_PROFILE=your-profile-name

aws login

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

​

Penyimpanan kredensial dan batas waktu resolusi

​

Konfigurasi kredensial lanjutan

• awsAuthRefresh: berjalan hanya ketika Claude Code mendeteksi bahwa kredensial AWS Anda kedaluwarsa, baik secara lokal berdasarkan stempel waktu mereka atau ketika API mengembalikan kesalahan kredensial, kemudian mencoba ulang permintaan dengan kredensial yang disegarkan.
• awsCredentialExport: berjalan pada awal sesi dan pada setiap pemuatan ulang kredensial, bahkan ketika kredensial dalam rantai penyedia kredensial default AWS Anda masih berlaku. Gunakan ini ketika akun Amazon Bedrock Anda memerlukan kredensial lintas akun yang berbeda dari yang akan diselesaikan oleh rantai penyedia default.

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

​

3. Konfigurasi Claude Code

# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # optional if your AWS profile already sets a region

# Optional: Override the AWS region for the small/fast model (Bedrock and Mantle).
# On Bedrock, has no effect without ANTHROPIC_DEFAULT_HAIKU_MODEL
# or the deprecated ANTHROPIC_SMALL_FAST_MODEL set.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

• Anda hanya perlu mengatur AWS_REGION untuk menimpa wilayah profil AWS Anda atau ketika profil Anda tidak memiliki wilayah. Claude Code menyelesaikan wilayah dalam urutan ini:
  • AWS_REGION
  • AWS_DEFAULT_REGION
  • region yang ditetapkan pada profil AWS aktif Anda, dibaca dari file kredensial bersama AWS terlebih dahulu dan kemudian file konfigurasi bersama, mencocokkan prioritas SDK AWS
  • us-east-1
  Jika nilai dari salah satu sumber ini tidak berbentuk seperti nama wilayah, Claude Code memperlakukannya sebagai tidak diatur dan melanjutkan ke bawah urutan. Misalnya, Claude Code memperlakukan nilai yang berisi garis miring, titik, atau spasi sebagai tidak diatur. Profil aktif adalah AWS_PROFILE jika diatur, jika tidak default. Atur AWS_SHARED_CREDENTIALS_FILE atau AWS_CONFIG_FILE untuk menunjuk ke jalur file non-default. Jalankan /status untuk melihat wilayah yang diselesaikan. Ketika wilayah berasal dari file konfigurasi AWS Anda atau fallback default, Claude Code juga mencatat sumber dalam output /status.
• Saat menggunakan Amazon Bedrock, perintah /logout tidak tersedia karena autentikasi ditangani melalui kredensial AWS.
• Alat WebSearch tidak tersedia di Amazon Bedrock. Lihat perilaku alat WebSearch.
• Anda dapat menggunakan file pengaturan untuk variabel lingkungan seperti AWS_PROFILE yang tidak ingin Anda bocorkan ke proses lain. Lihat Settings untuk informasi lebih lanjut.

​

4. Pin versi model

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

• Ketika Anda memilih model utama dengan --model, ANTHROPIC_MODEL, atau pengaturan model, tugas latar belakang menggunakan model itu. Ketika Claude Code memulai sesi pada model yang Anda atur dengan ANTHROPIC_DEFAULT_MODEL, tugas latar belakang juga menggunakan model itu. Pengaturan ANTHROPIC_DEFAULT_OPUS_MODEL tanpa ANTHROPIC_DEFAULT_SONNET_MODEL juga dihitung sebagai pilihan, karena model Sonnet bawaan mungkin tidak diaktifkan di akun yang mengarahkan Opus-nya sendiri.
• Untuk menggunakan Haiku untuk tugas latar belakang, atur ANTHROPIC_DEFAULT_HAIKU_MODEL ke ID model yang tersedia di akun Anda.

# Using inference profile ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# Using application inference profile ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Optional: Disable prompt caching if needed
# export DISABLE_PROMPT_CACHING=1

# Optional: Request 1-hour prompt cache TTL instead of the 5-minute default
# export ENABLE_PROMPT_CACHING_1H=1

​

Petakan setiap versi model ke profil inferensi

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}

​

Pemeriksaan model startup

​

Prefiks profil inferensi lintas wilayah

export ANTHROPIC_BEDROCK_REGION_PREFIX=global
# Di wilayah us-*, model utama sekarang diselesaikan ke
# global.anthropic.claude-opus-5-5 bukan us.anthropic.claude-opus-5-5

• Ketika Claude Code dapat mencantumkan profil inferensi di akun Anda, Claude Code menyelesaikan setiap model dalam urutan ini:
  1. Profil dengan prefiks pilihan Anda.
  2. Profil yang cocok, untuk model yang tidak memiliki profil dengan prefiks tersebut.
  3. ID model bawaan dengan prefiks pilihan Anda, untuk model yang tidak memiliki profil yang cocok sama sekali. Claude Code menerapkan ID ini tanpa memeriksa ketersediaan pada langkah ini; pemeriksaan model startup masih mencakup model default sesi.
• Ketika penemuan profil tidak tersedia, Claude Code menerapkan prefiks tanpa memeriksa ketersediaan. Jika akun Anda tidak memiliki profil inferensi dengan prefiks tersebut diaktifkan, permintaan gagal dengan kesalahan 400.

• Di wilayah AWS GovCloud, Claude Code selalu menggunakan us-gov., satu-satunya prefiks yang merutekan dalam partisi GovCloud.
• Ketika Anda menetapkan nilai yang bukan salah satu dari nilai yang valid, Claude Code kembali ke prefiks pilihan yang diturunkan dari wilayah.

​

Konfigurasi IAM

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

​

Jendela konteks token 1M

​

Tingkat layanan

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

​

AWS Guardrails

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

​

Gunakan endpoint Mantle

​

Aktifkan Mantle

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

​

Pilih model Mantle

claude --model anthropic.claude-haiku-4-5

​

Jalankan Mantle bersama Invoke API

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

{
  "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]
}

​

Rutekan Mantle melalui gateway

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

​

Variabel lingkungan Mantle

​

Pemecahan Masalah

​

Loop autentikasi dengan SSO dan proxy perusahaan

​

Kesalahan sertifikat di belakang proxy yang melakukan inspeksi TLS

• Penemuan model
• Penghitungan token
• Panggilan kredensial peran STS dan SSO yang menyelesaikan kredensial AWS Anda
• Verifikasi kredensial dan pemeriksaan model wizard penyiapan

​

Masalah wilayah

• Periksa ketersediaan model: aws bedrock list-inference-profiles --region your-region
• Beralih ke wilayah yang didukung: export AWS_REGION=us-east-1
• Pertimbangkan menggunakan profil inferensi untuk akses lintas wilayah

• Tentukan model sebagai ID profil inferensi

​

Kesalahan streaming di belakang gateway atau proxy

​

Penghitungan token nol dalam /context

​

Kesalahan endpoint Mantle

• Jika kesalahan menyebutkan tindakan bedrock-mantle:, berikan identitas IAM Anda tindakan itu.
• Jika kesalahan tidak menyebutkan tindakan dan kredensial Anda valid, akun AWS Anda belum diberikan akses ke model yang Anda minta. Hubungi tim akun AWS Anda untuk meminta akses.

​

Sumber daya tambahan

• Dokumentasi Amazon Bedrock
• Harga Amazon Bedrock
• Profil inferensi Amazon Bedrock
• Burndown token Amazon Bedrock dan kuota
• Claude Code di Amazon Bedrock: Panduan Pengaturan Cepat
• Implementasi Pemantauan Claude Code (Amazon Bedrock)