Langsung ke konten utama

​
Prasyarat

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

​
Pengaturan

​
1. Kirimkan detail kasus penggunaan

Pengguna pertama kali dari model Anthropic harus mengirimkan detail kasus penggunaan sebelum memanggil model. Ini dilakukan sekali per akun.
  1. Pastikan Anda memiliki izin IAM yang tepat (lihat lebih lanjut di bawah)
  2. Navigasikan ke konsol Amazon Bedrock
  3. Pilih Chat/Text playground
  4. Pilih model Anthropic apa pun dan Anda akan diminta untuk mengisi formulir kasus penggunaan

​
2. Konfigurasi kredensial AWS

Claude Code menggunakan rantai kredensial AWS SDK default. Atur kredensial Anda menggunakan salah satu metode berikut: Opsi A: Konfigurasi AWS CLI 
aws configure
Opsi B: Variabel lingkungan (kunci akses) 
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
Opsi C: Variabel lingkungan (profil SSO) 
aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name
Opsi D: Kunci API Bedrock 
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
Kunci API Bedrock menyediakan metode autentikasi yang lebih sederhana tanpa memerlukan kredensial AWS lengkap. Pelajari lebih lanjut tentang kunci API Bedrock.

​
Konfigurasi kredensial lanjutan

Claude Code mendukung penyegaran kredensial otomatis untuk AWS SSO dan penyedia identitas perusahaan. Tambahkan pengaturan ini ke file pengaturan Claude Code Anda (lihat Pengaturan untuk lokasi file). Ketika Claude Code mendeteksi bahwa kredensial AWS Anda telah kadaluarsa (baik secara lokal berdasarkan stempel waktu mereka atau ketika Bedrock mengembalikan kesalahan kredensial), Claude Code akan secara otomatis menjalankan perintah awsAuthRefresh dan/atau awsCredentialExport yang dikonfigurasi untuk mendapatkan kredensial baru sebelum mencoba ulang permintaan.
Contoh konfigurasi
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
Pengaturan konfigurasi dijelaskan
awsAuthRefresh: Gunakan ini untuk perintah yang memodifikasi direktori .aws (misalnya, memperbarui kredensial, cache SSO, atau file konfigurasi). Output ditampilkan kepada pengguna (tetapi input pengguna tidak didukung), menjadikannya cocok untuk alur autentikasi berbasis browser di mana CLI menampilkan kode untuk dimasukkan di browser. awsCredentialExport: Hanya gunakan ini jika Anda tidak dapat memodifikasi .aws dan harus secara langsung mengembalikan kredensial. Output ditangkap secara diam-diam (tidak ditampilkan kepada pengguna). Perintah harus menampilkan JSON dalam format ini: 
{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value"
  }
}

​
3. Konfigurasi Claude Code

Atur variabel lingkungan berikut untuk mengaktifkan Bedrock: 
# Aktifkan integrasi Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # atau wilayah pilihan Anda

# Opsional: Ganti wilayah untuk model kecil/cepat (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2
Saat mengaktifkan Bedrock untuk Claude Code, perhatikan hal berikut:
  • AWS_REGION adalah variabel lingkungan yang diperlukan. Claude Code tidak membaca dari file konfigurasi .aws untuk pengaturan ini.
  • Saat menggunakan Bedrock, perintah /login dan /logout dinonaktifkan karena autentikasi ditangani melalui kredensial AWS.
  • Anda dapat menggunakan file pengaturan untuk variabel lingkungan seperti AWS_PROFILE yang tidak ingin Anda bocorkan ke proses lain. Lihat Pengaturan untuk informasi lebih lanjut.

​
4. Konfigurasi model

Claude Code menggunakan model default ini untuk Bedrock:
Jenis modelNilai default
Model utamaglobal.anthropic.claude-sonnet-4-5-20250929-v1:0
Model kecil/cepatus.anthropic.claude-haiku-4-5-20251001-v1:0
Untuk pengguna Bedrock, Claude Code tidak akan secara otomatis meningkatkan dari Haiku 3.5 ke Haiku 4.5. Untuk beralih secara manual ke model Haiku yang lebih baru, atur variabel lingkungan ANTHROPIC_DEFAULT_HAIKU_MODEL ke nama model lengkap (misalnya, us.anthropic.claude-haiku-4-5-20251001-v1:0).
Untuk menyesuaikan model, gunakan salah satu metode berikut: 
# Menggunakan ID profil inferensi
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

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

# Opsional: Nonaktifkan penyimpanan cache prompt jika diperlukan
export DISABLE_PROMPT_CACHING=1
Penyimpanan cache prompt mungkin tidak tersedia di semua wilayah

​
5. Konfigurasi token output

Saat menggunakan Claude Code dengan Amazon Bedrock, kami merekomendasikan pengaturan token berikut: 
# Pengaturan token output yang direkomendasikan untuk Bedrock
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024
Mengapa nilai-nilai ini:
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096: Logika pembatasan burndown Bedrock menetapkan minimum 4096 token sebagai penalti max_token. Menetapkan ini lebih rendah tidak akan mengurangi biaya tetapi mungkin memotong penggunaan alat yang panjang, menyebabkan loop agen Claude Code gagal secara persisten. Claude Code biasanya menggunakan kurang dari 4096 token output tanpa pemikiran yang diperluas, tetapi mungkin memerlukan ruang kepala ini untuk tugas yang melibatkan pembuatan file yang signifikan atau penggunaan alat Write.
  • MAX_THINKING_TOKENS=1024: Ini menyediakan ruang untuk pemikiran yang diperluas tanpa memotong respons penggunaan alat, sambil tetap mempertahankan rantai penalaran yang terfokus. Keseimbangan ini membantu mencegah perubahan lintasan yang tidak selalu bermanfaat untuk tugas pengkodean secara khusus.

​
Konfigurasi IAM

Buat kebijakan IAM dengan izin yang diperlukan untuk Claude Code: 
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "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"
        }
      }
    }
  ]
}
Untuk izin yang lebih ketat, Anda dapat membatasi Resource ke ARN profil inferensi tertentu. Untuk detail, lihat dokumentasi IAM Bedrock.
Kami merekomendasikan membuat akun AWS khusus untuk Claude Code untuk menyederhanakan pelacakan biaya dan kontrol akses.

​
Pemecahan masalah

Jika Anda mengalami 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
Jika Anda menerima kesalahan “on-demand throughput isn’t supported”: Claude Code menggunakan API Invoke Bedrock dan tidak mendukung API Converse.

​
Sumber daya tambahan