Claude Code di Google Vertex AI
Pelajari tentang mengonfigurasi Claude Code melalui Google Vertex AI, termasuk pengaturan, konfigurasi IAM, dan pemecahan masalah.
Prasyarat
Sebelum mengonfigurasi Claude Code dengan Vertex AI, pastikan Anda memiliki:
- Akun Google Cloud Platform (GCP) dengan penagihan diaktifkan
- Proyek GCP dengan Vertex AI API diaktifkan
- Akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4)
- Google Cloud SDK (
gcloud
) terinstal dan dikonfigurasi - Kuota dialokasikan di wilayah GCP yang diinginkan
Vertex AI mungkin tidak mendukung model default Claude Code di wilayah non-us-east5
. Pastikan Anda menggunakan us-east5
dan memiliki kuota yang dialokasikan, atau beralih ke model yang didukung.
Pengaturan
1. Aktifkan Vertex AI API
Aktifkan Vertex AI API di proyek GCP Anda:
2. Minta akses model
Minta akses ke model Claude di Vertex AI:
- Navigasi ke Vertex AI Model Garden
- Cari model “Claude”
- Minta akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4)
- Tunggu persetujuan (mungkin memakan waktu 24-48 jam)
3. Konfigurasi kredensial GCP
Claude Code menggunakan autentikasi Google Cloud standar.
Untuk informasi lebih lanjut, lihat dokumentasi autentikasi Google Cloud.
4. Konfigurasi Claude Code
Atur variabel lingkungan berikut:
Untuk batas tingkat yang lebih tinggi dan pengaktifan prompt caching, hubungi dukungan Google Cloud. Setelah diaktifkan, hapus pengaturan DISABLE_PROMPT_CACHING
.
5. Konfigurasi model
Claude Code menggunakan model default ini untuk Vertex AI:
Jenis model | Nilai default |
---|---|
Model utama | claude-sonnet-4@20250514 |
Model kecil/cepat | claude-3-5-haiku@20241022 |
Untuk menyesuaikan model:
Konfigurasi IAM
Berikan peran IAM yang diperlukan untuk Claude Code.
Untuk detail, lihat dokumentasi Vertex IAM.
Kami merekomendasikan membuat proyek GCP khusus untuk Claude Code untuk menyederhanakan pelacakan biaya dan kontrol akses.
Pemecahan masalah
Jika Anda mengalami masalah kuota:
- Periksa kuota saat ini atau minta peningkatan kuota melalui Cloud Console
Jika Anda mengalami kesalahan 404 “model not found”:
- Verifikasi bahwa Anda memiliki akses ke wilayah yang ditentukan
- Konfirmasi model Diaktifkan di Model Garden
Jika Anda mengalami kesalahan 429:
- Pastikan model utama dan model kecil/cepat didukung di wilayah yang Anda pilih