Langsung ke konten utama
Model Claude di Google Cloud (dikelola Anthropic) adalah Claude API, yang dijalankan oleh Anthropic dan diakses melalui proyek Google Cloud Anda. Untuk menggunakannya dari Claude Code, masuk ke Google Cloud dan atur tiga environment variable.
Google Cloud juga menawarkan Claude melalui Agent Platform milik Google Cloud, yang sebelumnya bernama Vertex AI, yang dikelola oleh Google. Jika Anda menggunakan Agent Platform, ikuti Claude Code di Agent Platform Google Cloud sebagai gantinya. Untuk mengetahui mana yang Anda gunakan, lihat Which offering are you using?
Sebelum memulai, instal Claude Code v2.1.307 atau yang lebih baru. Untuk memeriksa versi Anda, jalankan claude --version di shell Anda. Untuk memperbarui, jalankan claude update.

Prasyarat

  • Proyek Google Cloud yang penyiapan akunnya sudah selesai
  • Peran IAM roles/claude.user pada proyek tersebut, untuk setiap akun Google atau akun layanan yang menjalankan Claude Code
  • ID proyek Anda dan ID workspace Anda, yang diawali dengan wrkspc_
  • gcloud CLI, jika Anda masuk dengan akun Google, bukan dengan file kunci akun layanan

Menyiapkan Claude Code

1

Buat Application Default Credentials

Jalankan perintah ini di shell Anda, lalu masuk dengan akun Google yang memiliki peran roles/claude.user:
Jalankan perintah ini meskipun Anda sudah menjalankan gcloud auth login.Jika GOOGLE_APPLICATION_CREDENTIALS diatur, hapus pengaturannya. Selama variabel tersebut diatur, Claude Code menggunakan file yang ditunjuknya dan mengabaikan kredensial yang disimpan oleh perintah tersebut.
2

Tambahkan variabel ke pengaturan Anda

Tambahkan tiga variabel ke blok env di file pengaturan pengguna Anda, ~/.claude/settings.json. Jika file tersebut belum ada, buat file dengan isi berikut:
Gunakan ID proyek dan ID workspace Anda sendiri sebagai pengganti my-project-id dan nilai wrkspc_. Untuk mengonfigurasi satu shell atau job CI saja, atur tiga variabel yang sama di lingkungan tersebut.Anda tidak perlu masuk ke akun Anthropic, atau keluar dari akun Anthropic.
3

Mulai Claude Code dan periksa penyedia

Jalankan claude di shell Anda, lalu jalankan /status di prompt Claude Code. Baris API provider berisi on Google Cloud, dan baris-baris setelahnya menampilkan Workspace ID, GCP project, dan GCP location Anda. Untuk mencetak baris yang sama dari shell atau job CI, jalankan claude auth status --text.Jika Anda melihat on Google Cloud, kirim sebuah prompt, atau jalankan claude -p "hello" di job CI. Balasan mengonfirmasi bahwa kredensial dan peran IAM Anda berfungsi. Jika Anda tidak melihatnya, atau Claude Code menampilkan error, lakukan pemecahan masalah penyiapan penyedia.

Menyiapkan Claude Code untuk tim

Letakkan blok env dari langkah 2 di Menyiapkan Claude Code dalam file pengaturan terkelola di mesin setiap developer. Berikan peran roles/claude.user pada proyek kepada setiap developer, dan minta masing-masing menjalankan gcloud auth application-default login di mesin mereka sendiri.

Menyematkan versi model

Jika Anda men-deploy ke tim, sematkan ID model, agar pembaruan Claude Code tidak memindahkan semua orang ke model yang lebih baru sekaligus. Tambahkan variabel-variabel ini ke blok env yang berisi tiga variabel dari Menyiapkan Claude Code:
Gunakan ID model Claude API yang Anda inginkan dari Models overview sebagai pengganti nilai contoh.

Environment variable

Fitur Claude Code yang tidak tersedia

Dengan Claude Models on Google Cloud (Anthropic managed), fitur yang tidak dapat Anda gunakan meliputi: Untuk melihat fitur lain yang tidak tersedia atau hanya didukung sebagian, pilih tab Google Cloud (Anthropic managed) di ringkasan ketersediaan fitur.

Pemecahan masalah

Jika Claude Code meminta Anda untuk masuk, atau baris API provider di /status tidak berisi on Google Cloud:
  • Pastikan CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD bernilai 1
  • Pastikan claude --version mencetak 2.1.307 atau yang lebih baru
  • Hapus CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY, dan CLAUDE_CODE_USE_ANTHROPIC_AWS dari shell dan file pengaturan Anda
CLAUDE_CODE_USE_VERTEX boleh tetap diatur. Setelah Anda mengubah variabel, mulai ulang Claude Code. Jika /status tidak menampilkan perubahan tersebut, lihat Nilai yang Anda atur diabaikan.

No workspace ID found

Atur ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID ke ID workspace Anda, lalu mulai ulang Claude Code. Abaikan opsi konstruktor workspaceId yang disebutkan dalam pesan tersebut: opsi itu ditujukan bagi orang yang memanggil SDK Anthropic dari kode mereka sendiri.

No project was given

Atur ANTHROPIC_GOOGLE_CLOUD_PROJECT ke ID proyek Google Cloud Anda, lalu mulai ulang Claude Code.

Could not load Google Cloud credentials

Ulangi langkah 1 di Menyiapkan Claude Code, dengan kunci baru jika Anda menggunakan file kunci akun layanan.

Google Cloud credentials expired or invalid

Jika pesan tersebut meminta Anda untuk memperbarui kredensial Google Cloud, ulangi langkah 1 di Menyiapkan Claude Code. Dengan file kunci akun layanan, gunakan kunci baru.

Google Cloud authentication failed

Ikuti langkah-langkah untuk Google Cloud credentials expired or invalid. Jika itu tidak menghilangkan error:
  • Proyek: di /status, pastikan baris GCP project menyebutkan proyek Anda. Jika baris tersebut menyebutkan proyek lain, atau baris tersebut tidak ada, ikuti No project was given
  • Workspace: di /status, pastikan baris Workspace ID menampilkan ID workspace Anda. Jika menampilkan ID lain, ikuti No workspace ID found
  • Peran IAM: pastikan akun Google atau akun layanan yang menjalankan Claude Code memiliki roles/claude.user atau roles/claude.admin pada proyek di baris GCP project. Untuk memberikan peran tersebut, gunakan perintah pemberian peran layanan tersebut, atau minta admin proyek untuk memberikannya
  • Layanan: pastikan layanan claude.googleapis.com diaktifkan pada proyek di baris GCP project. Untuk mengaktifkannya, ikuti langkah-langkah penyiapan akun layanan tersebut, atau minta admin proyek untuk mengaktifkannya