> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code dengan Model Claude di Google Cloud (dikelola Anthropic)

> Konfigurasikan Claude Code untuk menggunakan Claude API yang dijalankan Anthropic melalui proyek Google Cloud Anda, dengan kredensial Google Cloud, IAM, dan penagihan Marketplace.

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.

> [!NOTE]
>
> 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](https://code.claude.com/docs/id/google-vertex-ai.md) sebagai gantinya. Untuk mengetahui mana yang Anda gunakan, lihat [Which offering are you using?](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/overview#which-offering-are-you-using)

Sebelum memulai, [instal Claude Code](https://code.claude.com/docs/id/setup.md#install-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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) sudah selesai
* [Peran IAM](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `roles/claude.user` pada proyek tersebut, untuk setiap akun Google atau akun layanan yang menjalankan Claude Code
* ID proyek Anda dan [ID workspace](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) Anda, yang diawali dengan `wrkspc_`
* [gcloud CLI](https://cloud.google.com/sdk/docs/install), jika Anda masuk dengan akun Google, bukan dengan file kunci akun layanan

## Menyiapkan Claude Code

**1. Buat Application Default Credentials**

> [tab] Akun Google
>
> Jalankan perintah ini di shell Anda, lalu masuk dengan akun Google yang memiliki peran `roles/claude.user`:
>
> ```bash theme={null}
> gcloud auth application-default login
> ```
>
> 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.

> [tab] File kunci akun layanan
>
> Di shell atau job CI yang menjalankan Claude Code, atur `GOOGLE_APPLICATION_CREDENTIALS` ke path [file kunci akun layanan](https://docs.cloud.google.com/iam/docs/keys-create-delete). Untuk sumber kredensial lainnya, lihat [cara melakukan autentikasi](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. Tambahkan variabel ke pengaturan Anda**

Tambahkan tiga variabel ke blok `env` di [file pengaturan pengguna](https://code.claude.com/docs/id/settings.md) Anda, `~/.claude/settings.json`. Jika file tersebut belum ada, buat file dengan isi berikut:

```json theme={null}
{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}
```

Gunakan ID proyek dan [ID workspace](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) 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`](https://code.claude.com/docs/id/cli-reference).

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](#troubleshooting).

### Menyiapkan Claude Code untuk tim

Letakkan blok `env` dari langkah 2 di [Menyiapkan Claude Code](#set-up-claude-code) dalam file [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) 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](https://code.claude.com/docs/id/model-config.md#pin-models-for-third-party-deployments), 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](#set-up-claude-code):

```json theme={null}
{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}
```

Gunakan ID model Claude API yang Anda inginkan dari [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview) sebagai pengganti nilai contoh.

## Environment variable

| Variabel | Wajib | Deskripsi |
| - | - | - |
| `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` | Ya | Atur ke `1` untuk mengirim permintaan model ke Model Claude di Google Cloud (dikelola Anthropic) |
| `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` | Ya, kecuali Anda mengatur `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | ID workspace Anda |
| `ANTHROPIC_GOOGLE_CLOUD_PROJECT` | Disarankan | ID proyek Google Cloud Anda. Tanpa variabel ini, Claude Code menggunakan `GOOGLE_CLOUD_PROJECT` |
| `ANTHROPIC_GOOGLE_CLOUD_LOCATION` | Tidak | [Lokasi](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) dalam URL permintaan. Default-nya `global` |
| `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | Tidak | Menggantikan URL dasar yang dibangun Claude Code dari proyek, lokasi, dan ID workspace, misalnya dengan alamat [LLM gateway](https://code.claude.com/docs/id/llm-gateway). Claude Code menambahkan path API di belakangnya, seperti `/v1/messages` |
| `CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH` | Tidak | Atur ke `1` ketika gateway melampirkan kredensial Google sendiri, sehingga Claude Code tidak mengirim token akses Google |

## Fitur Claude Code yang tidak tersedia

Dengan Claude Models on Google Cloud (Anthropic managed), fitur yang tidak dapat Anda gunakan meliputi:

* [Fast mode](https://code.claude.com/docs/id/fast-mode.md): Anda tidak dapat mengaktifkannya dengan `/fast` atau pengaturan `fastMode`
* [Remote Control](https://code.claude.com/docs/id/remote-control.md) dan [sesi cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md)
* [Konektor MCP dari claude.ai](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai)
* [Channel](https://code.claude.com/docs/id/channels.md)
* [Perintah `/design-sync` dan `/import`](https://code.claude.com/docs/id/commands#all-commands)
* [Pengaturan yang dikelola server](https://code.claude.com/docs/id/server-managed-settings.md). Untuk memberlakukan pengaturan bagi tim Anda, gunakan [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) di setiap mesin sebagai gantinya

Untuk melihat fitur lain yang tidak tersedia atau hanya didukung sebagian, pilih tab **Google Cloud (Anthropic managed)** di [ringkasan ketersediaan fitur](https://code.claude.com/docs/id/feature-availability.md#summary-by-provider).

## 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](https://code.claude.com/docs/id/settings.md#find-or-create-your-settings-files) 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](https://code.claude.com/docs/id/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Atur `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` ke [ID workspace](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) 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](#set-up-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](#set-up-claude-code). Dengan file kunci akun layanan, gunakan kunci baru.

### `Google Cloud authentication failed`

Ikuti langkah-langkah untuk [`Google Cloud credentials expired or invalid`](#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`](#no-project-was-given)
* **Workspace**: di `/status`, pastikan baris `Workspace ID` menampilkan ID workspace Anda. Jika menampilkan ID lain, ikuti [`No workspace ID found`](#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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls), 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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account), atau minta admin proyek untuk mengaktifkannya

## Sumber daya terkait

* [Model Claude di Google Cloud (dikelola Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed): penyiapan akun, peran IAM, penagihan, retensi data, dan dukungan fitur
* [Ikhtisar deployment enterprise](https://code.claude.com/docs/id/third-party-integrations.md): cara lain untuk men-deploy Claude Code, serta penyiapan proxy dan gateway
* [Konfigurasi model](https://code.claude.com/docs/id/model-config.md): alias model, menyematkan versi model, dan membatasi model mana yang dapat dipilih pengguna