​
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) 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. Aktifkan akses model

Pertama, pastikan Anda memiliki akses ke model Claude yang diperlukan di akun AWS Anda:

  1. Navigasi ke konsol Amazon Bedrock
  2. Pergi ke Model access di navigasi kiri
  3. Minta akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4)
  4. Tunggu persetujuan (biasanya instan untuk sebagian besar wilayah)

​
2. Konfigurasi kredensial AWS

Claude Code menggunakan rantai kredensial AWS SDK default. Atur kredensial Anda menggunakan salah satu metode berikut:

Claude Code saat ini tidak mendukung manajemen kredensial dinamis (seperti secara otomatis memanggil aws sts assume-role). Anda perlu menjalankan aws configure, aws sso login, atau mengatur variabel lingkungan AWS_ sendiri.

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

​
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

AWS_REGION adalah variabel lingkungan yang diperlukan. Claude Code tidak membaca dari file konfigurasi .aws untuk pengaturan ini.

​
4. Konfigurasi model

Claude Code menggunakan model default berikut untuk Bedrock:

Jenis modelNilai default
Model utamaus.anthropic.claude-3-7-sonnet-20250219-v1:0
Model kecil/cepatus.anthropic.claude-3-5-haiku-20241022-v1:0

Untuk menyesuaikan model, gunakan salah satu metode berikut:

# Menggunakan ID profil inferensi
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-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'

​
Konfigurasi IAM

Buat kebijakan IAM dengan izin yang diperlukan untuk Claude Code.

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 error “on-demand throughput isn’t supported”:

​
Sumber daya tambahan