Claude Code di Platform Agen Google Cloud

​

Prasyarat

• Akun Google Cloud Platform (GCP) dengan penagihan diaktifkan
• Proyek GCP dengan Google Cloud’s Agent Platform API diaktifkan
• Akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4.6)
• Google Cloud SDK (gcloud) terinstal dan dikonfigurasi
• Kuota dialokasikan di wilayah GCP yang diinginkan

​

Masuk dengan Agent Platform

​

Konfigurasi wilayah

​

Pengaturan manual

​

1. Aktifkan Agent Platform API

# Atur ID proyek Anda
gcloud config set project YOUR-PROJECT-ID

# Aktifkan Agent Platform API
gcloud services enable aiplatform.googleapis.com

​

2. Minta akses model

1. Navigasikan ke Google Cloud’s Agent Platform Model Garden
2. Cari model “Claude”
3. Minta akses ke model Claude yang diinginkan (misalnya, Claude Sonnet 4.6)
4. Tunggu persetujuan (mungkin memakan waktu 24-48 jam)

​

3. Konfigurasi kredensial GCP

​

Konfigurasi kredensial lanjutan

{
  "gcpAuthRefresh": "gcloud auth application-default login",
  "env": {
    "ANTHROPIC_VERTEX_PROJECT_ID": "your-project-id"
  }
}

​

4. Konfigurasi Claude Code

# Aktifkan integrasi Agent Platform
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# Opsional: Timpa URL titik akhir Agent Platform untuk titik akhir kustom atau gateway
# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

# Ketika CLOUD_ML_REGION=global, timpa wilayah untuk model yang tidak mendukung titik akhir global
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

• VERTEX_REGION_CLAUDE_*: Claude Code kembali ke CLOUD_ML_REGION.
• CLOUD_ML_REGION: Claude Code kembali ke us-east5.

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5, dan yang lebih baru: Claude Code mengaktifkan pencarian alat secara default.
• Model sebelumnya, termasuk semua model Claude 3.x: Claude Code memuat definisi alat MCP di muka, karena tumpukan penyajian Agent Platform mereka menolak header beta yang diperlukan. Mengatur ENABLE_TOOL_SEARCH=true tidak mengganti ini.

​

5. Pin versi model

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

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

export ANTHROPIC_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

​

6. Verifikasi konfigurasi Anda

​

Pemeriksaan model startup

​

Konfigurasi IAM

• aiplatform.endpoints.predict - Diperlukan untuk invokasi model dan penghitungan token

​

Jendela konteks token 1M

​

Pemecahan masalah

• Jalankan gcloud auth application-default login untuk menyiapkan Application Default Credentials
• Atur GOOGLE_APPLICATION_CREDENTIALS ke jalur file kunci akun layanan
• Lihat Configure GCP credentials untuk semua opsi

• Periksa kuota saat ini atau minta peningkatan kuota melalui Cloud Console

• Konfirmasi model diaktifkan di Model Garden
• Verifikasi model tersedia di lokasi yang Anda tentukan. Beberapa model hanya ditawarkan di lokasi global atau multi-region seperti eu dan us, bukan di wilayah spesifik
• Jika menggunakan CLOUD_ML_REGION=global, periksa bahwa model Anda mendukung titik akhir global di Model Garden di bawah “Supported features”. Untuk model yang tidak mendukung titik akhir global, baik:
  • Tentukan model yang didukung melalui ANTHROPIC_MODEL atau ANTHROPIC_DEFAULT_HAIKU_MODEL, atau
  • Atur wilayah atau lokasi multi-region menggunakan variabel lingkungan VERTEX_REGION_<MODEL_NAME>

• Untuk titik akhir regional, pastikan model utama dan model kecil/cepat didukung di wilayah yang Anda pilih
• Pertimbangkan untuk beralih ke CLOUD_ML_REGION=global untuk ketersediaan yang lebih baik

​

Sumber daya tambahan

• Dokumentasi Google Cloud’s Agent Platform
• Harga Google Cloud’s Agent Platform
• Kuota dan batas Google Cloud’s Agent Platform