Claude Models on Google Cloud (Anthropic managed)

Google Cloud menangani akses dan penagihan untuk Claude Models on Google Cloud (Anthropic managed). Untuk membandingkan kedua penawaran Google Cloud, atau untuk memeriksa mana yang Anda gunakan, lihat Claude Models on Google Cloud.

Menyiapkan akun Anda

Untuk menyiapkan akun Anda untuk Claude Models on Google Cloud (Anthropic managed), Anda memerlukan hal-hal berikut:

• Izin untuk melakukan pembelian di Google Cloud Marketplace pada akun penagihan Anda
• Izin untuk mengaktifkan layanan pada proyek
• Peran IAM yang memungkinkan Anda membuka Claude Console, yang Anda perlukan untuk langkah 4

Langkah-langkah ini membuat organisasi Anthropic baru untuk proyek Google Cloud Anda. Organisasi ini terpisah dari organisasi Anthropic mana pun yang sudah dimiliki perusahaan Anda. Itu termasuk organisasi Claude Enterprise. Untuk berpindah dari organisasi yang sudah ada, lihat Berpindah dari organisasi Anthropic yang sudah ada.

Jika Anda memiliki diskon yang sudah ada, hubungi perwakilan akun Anthropic atau Google Cloud Anda sebelum memulai langkah-langkah ini. Diskon tidak dapat diterapkan pada penggunaan sebelumnya.

1. 1

   Berlangganan di Marketplace

   1. Buka Google Cloud Marketplace dan temukan listing Claude Models on Google Cloud (Anthropic managed).
   2. Pilih Subscribe dan selesaikan alur pembelian.
   3. Kembali ke listing dan pilih Manage on Console. Ini akan membuka halaman Claude di Google Cloud console.

   Untuk kembali ke halaman Claude nanti, pilih proyek Anda di Google Cloud console. Lalu buka Agent Platform > Models > Claude Platform dan pilih Anthropic managed.

2. 2

   Mengaktifkan layanan

   Aktifkan dua layanan pada setiap proyek yang memanggil Claude Models on Google Cloud (Anthropic managed):

   • claude.googleapis.com menyajikan API untuk Claude Models on Google Cloud (Anthropic managed). Layanan ini juga mendefinisikan izin IAM. Panggilan akan gagal tanpanya.
   • anthropic-managed-claude.cloudpartnerservices.goog adalah layanan Marketplace yang mengatribusikan penggunaan proyek ke langganan Anda.

   CLI

   

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=my-project-id

   Ganti my-project-id dengan ID proyek Anda.

   Anda juga dapat mengaktifkan keduanya dari halaman Claude atau dari APIs & Services. Pengaktifan adalah langkah satu kali untuk setiap proyek. Untuk memeriksa bahwa kedua layanan telah diaktifkan, jalankan gcloud services list --enabled --project=my-project-id dan cari kedua nama tersebut.

3. 3

   Menyiapkan organisasi Anthropic Anda

   1. Di halaman Claude, pilih Activate.
   2. Dalam alur penyiapan Anthropic, masukkan alamat email kontak.
   3. Buka tautan penyiapan yang dikirim ke alamat tersebut.
   4. Isi nama organisasi, jenis entitas, negara, dan tujuan penggunaan.
   5. Terima Ketentuan Layanan Komersial dan Kebijakan Penggunaan Anthropic.

   Alamat kontak hanya digunakan untuk penyiapan dan pemberitahuan layanan. Untuk cara orang membuka Claude Console setelah penyiapan, lihat Menggunakan Claude Console.

4. 4

   Membuka Claude Console

   Ketika organisasi Anthropic Anda aktif, tombol di halaman Claude berubah menjadi Open Claude Console. Pilih tombol tersebut. Google Cloud memeriksa akses IAM Anda. Kemudian browser Anda dialihkan ke platform.claude.com. Anda masuk ke organisasi baru tersebut.

   Selagi Anda berada di Claude Console, temukan ID workspace Anda dan salin. Setiap orang yang memanggil Claude Models on Google Cloud (Anthropic managed) memerlukannya. Teruskan ID tersebut kepada developer Anda.

Untuk menambahkan proyek lain, ulangi langkah-langkah ini di proyek tersebut, mulai dari langkah 2.

Pemecahan masalah penyiapan akun

Jika Anda mengalami salah satu masalah berikut saat menyiapkan Claude Models on Google Cloud (Anthropic managed), terapkan perbaikannya:

• gcloud services enable tidak dapat menemukan anthropic-managed-claude.cloudpartnerservices.goog: Jalankan perintah sebagai akun yang menyelesaikan pembelian Marketplace, atau hubungi perwakilan akun Anthropic Anda.
• Error izin pada panggilan API pertama Anda: Periksa bahwa claude.googleapis.com telah diaktifkan pada proyek yang Anda panggil. Periksa bahwa pemanggil memiliki roles/claude.user atau roles/claude.admin pada proyek tersebut. Untuk apa yang diizinkan setiap peran, lihat Peran IAM. Pemberian izin baru atau layanan yang baru diaktifkan dapat memerlukan waktu sejenak untuk berlaku.
• "Signed in as a different account" setelah mengikuti tautan penyiapan: Pilih Log out and continue. Lalu gunakan alamat email yang Anda masukkan di langkah 3.
• Tombol menampilkan "Finish Setup" alih-alih "Open Claude Console": Organisasi Anthropic Anda sudah ada, tetapi penyiapannya belum selesai. Seorang administrator harus menyelesaikan formulir detail organisasi.
• Halaman Usage tidak menampilkan data setelah panggilan API pertama Anda: Data penggunaan dapat memerlukan beberapa menit untuk muncul di Claude Console.

Mengelola akses

Peran IAM

Claude Models on Google Cloud (Anthropic managed) memiliki tiga peran IAM yang telah ditentukan sebelumnya. Berikan peran pada proyek.

Sebagai contoh, perintah berikut memungkinkan service account memanggil Claude Models on Google Cloud (Anthropic managed):

gcloud projects add-iam-policy-binding my-project-id \
  --member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
  --role="roles/claude.user"

Untuk izin, peran yang telah ditentukan sebelumnya, dan jenis log audit, lihat Izin IAM untuk Claude Models on Google Cloud (Anthropic managed).

Mengaktifkan claude.googleapis.com akan membuat service agent untuk proyek. Jangan hapus pemberian perannya. Menghapusnya akan menghentikan Claude Models on Google Cloud (Anthropic managed) agar tidak berfungsi di proyek tersebut.

Menggunakan Claude Console

Dengan Claude Models on Google Cloud (Anthropic managed), Anda tidak dapat menggunakan alamat email untuk masuk ke organisasi Anthropic Anda. Sebagai gantinya, pilih Open Claude Console di halaman Claude di Google Cloud console. Google Cloud IAM mengontrol siapa yang dapat membuka Claude Console. Dari tiga peran IAM yang telah ditentukan sebelumnya, hanya roles/claude.admin pada proyek yang memungkinkan Anda membuka Claude Console.

Workspace

Di Claude Models on Google Cloud (Anthropic managed), penyiapan membuat organisasi Anthropic Anda dengan satu workspace, yaitu Default Workspace. Untuk membuat lebih banyak workspace, buka Claude Console dan buka Settings > Workspaces. Di halaman yang sama, Anda dapat mengganti nama atau mengarsipkan workspace mana pun kecuali Default Workspace. Setiap workspace memiliki ID workspace sendiri. File, skill, batch, sesi Claude Managed Agents, dan sumber daya workspace lainnya menjadi milik workspace yang ID-nya Anda tetapkan untuk permintaan.

Anda memberikan peran IAM pada proyek, sehingga sebuah peran berlaku untuk setiap workspace di proyek tersebut. Ketika tim memerlukan akses terpisah, berikan setiap tim proyek Google Cloud sendiri. Setiap proyek memiliki organisasi Anthropic sendiri, jadi ulangi langkah-langkah penyiapan di setiap proyek, mulai dari langkah 2.

Sebelum melakukan panggilan API

Untuk memanggil Claude Models on Google Cloud (Anthropic managed), Anda memerlukan hal-hal berikut:

1. Proyek Google Cloud dengan langganan aktif dan organisasi Anthropic yang penyiapannya telah selesai. Lihat Menyiapkan akun Anda.
2. gcloud CLI yang terinstal, untuk pengembangan lokal.
3. Peran roles/claude.user, yang diberikan pada proyek kepada identitas yang melakukan panggilan.
4. Application Default Credentials untuk identitas tersebut. Lihat Autentikasi.
5. ID proyek dan ID workspace Anda.

Untuk memberikan peran tersebut ke akun Anda sendiri untuk pengembangan lokal, jalankan perintah berikut. Anda memerlukan izin untuk mengubah kebijakan IAM proyek.

gcloud projects add-iam-policy-binding my-project-id \
  --member="user:you@example.com" \
  --role="roles/claude.user"

Ganti my-project-id dengan ID proyek Anda. Ganti you@example.com dengan alamat email akun Google Anda. Untuk melihat proyek yang digunakan gcloud, jalankan gcloud config get-value project. Untuk service account dan peran lainnya, lihat Peran IAM.

Menemukan ID workspace Anda

Untuk menemukan ID workspace Anda untuk Claude Models on Google Cloud (Anthropic managed), buka Claude Console dan buka Settings > Workspaces. ID tersebut diawali dengan wrkspc_. Jika Anda tidak dapat membuka Claude Console, minta seseorang yang dapat membukanya untuk mengirimkan ID tersebut kepada Anda.

Tetapkan proyek dan workspace sebagai variabel lingkungan agar klien SDK dan ant CLI dapat membacanya:

export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"

Menginstal SDK

Klien SDK untuk Claude Models on Google Cloud (Anthropic managed) adalah AnthropicGoogleCloud. Klien ini menyelesaikan kredensial Google Anda. Klien ini juga membangun base URL dari proyek, lokasi, dan ID workspace Anda.

Instal paket yang menyediakan klien tersebut:

pip install -U "anthropic[google_cloud]"

Untuk menggunakan ant CLI sebagai gantinya, instal atau perbarui ke versi terbaru. Versi tanpa dukungan untuk Claude Models on Google Cloud (Anthropic managed) akan mengabaikan variabel ANTHROPIC_GOOGLE_CLOUD_*. Versi tersebut kemudian melakukan salah satu hal berikut:

• Mengirim permintaan ke Claude API dengan kredensial lain yang telah Anda siapkan
• Gagal dengan error autentikasi

Melakukan permintaan

Claude Models on Google Cloud (Anthropic managed) menyajikan endpoint Claude API di bawah base URL yang menyebutkan proyek Anda, sebuah lokasi, dan workspace Anda:

https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke

Rute tingkat organisasi, yang path-nya diawali dengan /v1/organizations/, menggunakan base URL tanpa workspace:

https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke

Jika Anda tidak menetapkan base URL, klien SDK akan memilih di antara keduanya untuk setiap permintaan.

Tambahkan path Claude API ke base URL. Sebagai contoh, Messages API berada di .../invoke/v1/messages. Tiga hal berbeda dari permintaan Claude API:

• Base URL: URL dengan cakupan proyek yang ditunjukkan sebelumnya, sebagai pengganti https://api.anthropic.com.
• Autentikasi: Header Authorization: Bearer dengan access token Google. Jangan kirim header x-api-key.
• Workspace: ID workspace merupakan bagian dari URL. Jangan kirim header anthropic-workspace-id.

Semua hal lainnya sama seperti di Claude API, termasuk yang berikut:

• Header anthropic-version dan anthropic-beta
• Body permintaan
• Streaming
• Respons

Contoh kode di bagian lain dokumentasi ini membuat klien Claude API dan membaca kunci API. Untuk menjalankannya dengan Claude Models on Google Cloud (Anthropic managed), ganti import dan konstruktor kliennya dengan yang ada di contoh berikut. Untuk contoh cURL, terapkan tiga perbedaan yang tercantum sebelumnya.

Sebelum menjalankan contoh-contoh ini, selesaikan langkah-langkah di Sebelum melakukan panggilan API.

from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(message)

Contoh cURL meminta token Application Default Credentials dari gcloud. Access token berumur pendek. Buat token untuk setiap sesi alih-alih menyimpannya.

ID model API

Claude Models on Google Cloud (Anthropic managed) menggunakan ID model yang sama dengan Claude API, misalnya claude-opus-5-5. Untuk model dan ID-nya, lihat Ikhtisar model.

Di Claude Models on Google Cloud (Anthropic managed), permintaan untuk model yang tidak tersedia bagi organisasi Anthropic Anda akan mengembalikan error. Pesan error-nya berbunyi Model {model} is not available for this organization's inference configuration.

Resolusi proyek, lokasi, dan workspace

Klien untuk Claude Models on Google Cloud (Anthropic managed) menerima pengaturan dalam tabel berikut. Nilai yang Anda berikan saat membuat klien lebih diutamakan daripada variabel lingkungan. Untuk menetapkan proyek dan ID workspace secara eksplisit, berikan project dan workspace_id.

Biarkan lokasi tetap global. Lokasi terpisah dari tempat inferensi dijalankan, jadi untuk inferensi khusus AS, tetapkan inference_geo: "us" pada setiap permintaan, seperti yang dijelaskan di Residensi data.

ant CLI menerima pengaturan yang sama sebagai flag:

• ID proyek: --google-cloud-project
• ID workspace: --google-cloud-workspace-id
• Lokasi: --google-cloud-location
• Base URL: --google-cloud-base-url

CLI menggunakan Claude Models on Google Cloud (Anthropic managed) ketika proyek, ID workspace, atau lokasi ditetapkan. Menetapkan GOOGLE_CLOUD_PROJECT, base URL, atau keduanya tidaklah cukup.

Autentikasi

Setiap permintaan ke Claude Models on Google Cloud (Anthropic managed) membawa access token Google OAuth 2.0 dalam header Authorization: Bearer. Token tersebut memiliki cakupan https://www.googleapis.com/auth/cloud-platform.

Google Cloud menangani akses. Gateway-nya di claude.googleapis.com melakukan hal berikut untuk setiap permintaan:

1. Memeriksa kredensial Google Cloud Anda.
2. Memeriksa bahwa pemanggil memiliki izin IAM yang diperlukan permintaan. Jika pemanggil tidak memilikinya, Google Cloud mengembalikan error HTTP 403.
3. Meneruskan permintaan ke Anthropic. Anthropic memvalidasi permintaan tersebut.

Untuk memberikan izin, lihat Peran IAM.

Klien SDK mendapatkan token dari Application Default Credentials (ADC). Sumber kredensial apa pun yang didukung ADC dapat digunakan:

• Pengembangan lokal: Jalankan gcloud auth application-default login.
• Di Google Cloud: Klien secara otomatis menggunakan service account yang terpasang pada workload, misalnya di Compute Engine, GKE, atau Cloud Run.
• File kunci service account: Tetapkan GOOGLE_APPLICATION_CREDENTIALS ke path-nya.
• Workload Identity Federation dan impersonasi service account: Konfigurasikan seperti yang Anda lakukan untuk Google Cloud API mana pun.

Periksa bahwa ADC berfungsi:

gcloud auth application-default print-access-token

Claude Models on Google Cloud (Anthropic managed) tidak menggunakan kunci API. Di Claude Console, Anda tidak dapat membuat kunci API untuk organisasi Anthropic yang dibuat oleh penyiapan. Klien SDK untuk Claude Models on Google Cloud (Anthropic managed) mengabaikan variabel lingkungan berikut:

• ANTHROPIC_API_KEY
• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_BASE_URL

Prioritas kredensial

Klien SDK untuk Claude Models on Google Cloud (Anthropic managed) memeriksa kredensial dalam urutan berikut. Klien menggunakan yang pertama kali ditemukannya:

1. Token provider yang Anda berikan sebagai token_provider saat Anda membuat klien. Ini adalah fungsi atau sumber token yang mengembalikan access token. Klien memintanya untuk token pada setiap permintaan. Caching dan penyegaran token menjadi tanggung jawab Anda.
2. Objek kredensial Google yang Anda berikan sebagai credentials saat Anda membuat klien. Go SDK tidak memiliki opsi ini.
3. Application Default Credentials.

Go dan Java berbeda dari SDK lainnya:

• Go: Untuk opsi 1, klien menerima oauth2.TokenSource. Klien melakukan caching token hingga token kedaluwarsa.
• Java: Gunakan GoogleCloudBackend.fromEnv() untuk membaca Application Default Credentials dan variabel lingkungan di Resolusi proyek, lokasi, dan workspace.

Klien tidak memiliki variabel lingkungan sendiri untuk kredensial. Gunakan GOOGLE_APPLICATION_CREDENTIALS milik ADC sebagai gantinya.

Jika permintaan Anda melewati proxy yang melampirkan token untuk Anda, tetapkan skip_auth. Klien kemudian tidak mengirim header Authorization. Anda tidak dapat menggabungkan pengaturan ini dengan opsi kredensial sebelumnya.

Ketika ant CLI menggunakan Claude Models on Google Cloud (Anthropic managed), CLI selalu mendapatkan token dari Application Default Credentials. CLI tidak menerima token provider, objek kredensial, atau pengaturan skip-auth.

Sebelum Anda menggunakan ant dengan Claude Models on Google Cloud (Anthropic managed), pastikan tidak ada satu pun dari berikut ini yang ditetapkan:

• Kunci API
• Auth token
• --profile atau ANTHROPIC_PROFILE, jika menyebutkan profil konfigurasi yang dapat digunakan CLI untuk autentikasi
• Salah satu variabel federasi Anthropic:
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_SERVICE_ACCOUNT_ID
  • ANTHROPIC_IDENTITY_TOKEN
  • ANTHROPIC_IDENTITY_TOKEN_FILE

Jika salah satunya ditetapkan, CLI menggunakan kredensial tersebut alih-alih pengaturan Google Cloud dari Menemukan ID workspace Anda. Jika hanya sebagian variabel federasi yang ditetapkan, CLI berhenti dengan error. Ketika lebih dari satu kredensial ditetapkan, CLI mencetak catatan yang menyebutkan kredensial yang digunakannya.

Biarkan juga ANTHROPIC_WORKSPACE_ID dan flag --workspace-id tidak ditetapkan. CLI tetap mengirim nilai tersebut sebagai header anthropic-workspace-id. Permintaan ke Claude Models on Google Cloud (Anthropic managed) tidak boleh membawa header tersebut. Tetapkan workspace dengan --google-cloud-workspace-id atau ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID sebagai gantinya.

Seperti klien SDK, CLI tidak mengirim permintaan untuk Claude Models on Google Cloud (Anthropic managed) ke --base-url atau ANTHROPIC_BASE_URL.

Dukungan fitur

Bagian ini mencantumkan fitur yang berfungsi di Claude Models on Google Cloud (Anthropic managed) dan fitur yang tidak didukung di sana. Bagian ini tidak mencantumkan setiap fitur Claude API, dan tidak menyatakan apakah fitur yang tidak tercantum berfungsi.

Fitur-fitur berikut berfungsi di Claude Models on Google Cloud (Anthropic managed) sebagaimana di Claude API:

• Fast mode: Fast mode untuk Claude Opus 5.5.

• Fitur beta: Jika sebuah beta dibatasi untuk organisasi tertentu di Claude API, organisasi Anthropic yang dibuat oleh penyiapan memerlukan akses yang sama.
• Alat: "Tool use" (penggunaan alat), termasuk:
  • Web search
  • Web fetch
  • Code execution
  • Memory tool
  • Advisor tool
  • MCP connector
• Skill dan file: Agent Skills dan Files API.
• Kemampuan model:
  • "Prompt caching" (caching prompt)
  • "Extended thinking" (pemikiran diperpanjang)
  • Fallback sisi server
  • Streaming
  • Structured outputs
  • Penghitungan token
• Batch dan model: Message Batches API dan Models API.

Untuk mengaktifkan atau menonaktifkan Compliance API untuk organisasi Anthropic yang dibuat oleh penyiapan, buka Claude Console, buka Settings > Compliance, dan gunakan toggle Compliance API.

"Customer-managed encryption keys" (kunci enkripsi yang dikelola pelanggan), atau CMEK, tersedia dengan kunci Google Cloud KMS. Untuk mengaktifkan CMEK untuk organisasi Anthropic yang dibuat oleh penyiapan, lihat Kunci enkripsi yang dikelola pelanggan. Untuk menyiapkan kunci, ikuti Mengonfigurasi Google Cloud KMS untuk CMEK. Kemudian daftarkan, verifikasi, dan lampirkan kunci di Claude Console, seperti yang dijelaskan tab Claude Console di halaman penyiapan.

Claude Managed Agents

Claude Managed Agents tersedia melalui Claude Models on Google Cloud (Anthropic managed), termasuk yang berikut:

• Agent
• Environment
• Sesi
• Credential vault
• Memory store
• Deployment terjadwal
• Sandbox yang di-host sendiri

Akses diperiksa saat sesi atau deployment dibuat, bukan saat sedang berjalan:

• Sesi yang sedang berjalan tetap berjalan. Jika Anda mencabut akses Google Cloud dari identitas yang membuat sesi, sesi tersebut tidak berhenti. Untuk menghentikannya, kirimkan event user.interrupt secara tersendiri. Setelah sesi berstatus idle, Anda dapat mengarsipkan atau menghapusnya.
• Deployment terjadwal tetap berjalan. Deployment tidak memeriksa ulang akses pembuatnya pada setiap eksekusi terjadwal. Untuk menghentikannya, jeda, perbarui, atau arsipkan deployment tersebut.

Ketika Anda menghapus pengguna atau merotasi service account, tinjau sesi dan deployment yang dibuat oleh identitas tersebut.

Fitur yang tidak didukung

Hal-hal berikut tidak didukung di Claude Models on Google Cloud (Anthropic managed):

• Kunci API: Autentikasi hanya melalui kredensial Google Cloud.
• Tunnel MCP: Tunnel MCP tidak tersedia di Claude Models on Google Cloud (Anthropic managed).
• Memory store pada environment self-hosted: Memory store tidak didukung untuk sesi pada environment self-hosted.
• Worker sandbox yang di-host sendiri yang sudah jadi: Worker yang di-host sendiri di ant CLI dan di SDK Python, TypeScript, dan Go tidak mendukung Claude Models on Google Cloud (Anthropic managed). Sebagai gantinya, implementasikan worker Anda sendiri yang memanggil endpoint Environments Work secara langsung. Untuk peran dan izin yang dibutuhkan worker Anda, lihat izin IAM untuk environment.

Jendela konteks

Ukuran "context window" (jendela konteks) di Claude Models on Google Cloud (Anthropic managed) sama dengan di Claude API. Untuk batas setiap model, lihat Jendela konteks.

Penagihan, batas laju, dan logging

Batas laju

Anthropic mengelola "rate limit" (batas laju) untuk Claude Models on Google Cloud (Anthropic managed). Untuk meminta batas yang lebih tinggi, hubungi perwakilan akun Anthropic Anda atau hubungi tim penjualan. Untuk cara batas laju diukur dan dilaporkan, lihat Batas laju.

Penagihan

Claude Models on Google Cloud (Anthropic managed) ditagih melalui Google Cloud Marketplace. Anthropic mengukur penggunaan Anda. Anthropic melaporkan penggunaan tersebut ke Google Cloud dalam Claude Consumption Units. Biaya muncul di tagihan Google Cloud Anda. Anthropic tidak mengirimkan faktur terpisah.

Lihat data penggunaan dan biaya di halaman Usage dan Cost di Claude Console.

Jika Anda memiliki komitmen pembelanjaan Google Cloud, penggunaan dihitung terhadap komitmen tersebut seperti pembelian Marketplace lainnya.

Retensi data

Anthropic adalah pemroses data untuk Claude Models on Google Cloud (Anthropic managed). Beberapa layanan pendukung, seperti sistem trust and safety Anthropic, memproses data di luar Google Cloud.

Claude Models on Google Cloud (Anthropic managed) mengikuti kebijakan retensi data yang sama dengan Claude API. Lihat API dan retensi data. "Zero Data Retention" (retensi data nol), atau ZDR, tersedia berdasarkan permintaan. Hubungi perwakilan akun Anthropic Anda.

Pengaturan ZDR pada organisasi Anthropic lain tidak berlaku untuk organisasi Anda untuk Claude Models on Google Cloud (Anthropic managed).

Pemantauan dan logging

Cloud Audit Logs mencatat aktivitas API untuk Claude Models on Google Cloud (Anthropic managed) di proyek Anda. Entri muncul di bawah layanan claude.googleapis.com. Setiap rute API termasuk dalam salah satu dari dua jenis log:

• Log Data Access: Log ini mencakup sebagian besar rute, termasuk messages, batches, files, skills, models, dan sebagian besar sumber daya Claude Managed Agents. Log ini nonaktif secara default.
• Log Admin Activity: Log ini mencakup rute lainnya, termasuk rute kunci enkripsi dan sebagian besar rute credential vault. Pengecualiannya adalah rute untuk vaults.verify, yang termasuk Data Access. Log Admin Activity selalu aktif.

Untuk menyimpan catatan permintaan, aktifkan log Data Access untuk claude.googleapis.com di pengaturan log audit proyek Anda.

Untuk jenis log audit berdasarkan rute, lihat Izin IAM untuk Claude Models on Google Cloud (Anthropic managed).

ID permintaan

Respons yang berhasil dari Claude Models on Google Cloud (Anthropic managed) membawa header request-id.

Berpindah dari organisasi Anthropic yang sudah ada

Anda tidak dapat mengonversi organisasi Anthropic yang sudah ada menjadi organisasi untuk Claude Models on Google Cloud (Anthropic managed). Itu termasuk organisasi yang Anda gunakan dengan Claude API secara langsung.

Rencanakan perpindahan sebagai cutover ke organisasi baru:

• Buat organisasi baru terlebih dahulu. Ikuti Menyiapkan akun Anda.
• Buat ulang akses dan konfigurasi. Kunci API, workspace, dan pengaturan Claude Console tidak ikut terbawa. Berikan peran IAM pada proyek alih-alih membuat kunci API. Untuk membuat ulang workspace Anda, lihat Workspace. Untuk pengaturan ZDR, lihat Retensi data.
• Rencanakan untuk sumber daya yang tersimpan. File, skill, batch, dan sumber daya Claude Managed Agents tetap berada di organisasi yang sudah ada.
• Perbarui integrasi Anda. Untuk apa yang berubah dan apa yang tetap sama, lihat Melakukan permintaan. Untuk fitur yang tidak didukung, lihat Fitur yang tidak didukung.
• Lakukan cutover sesuai jadwal Anda sendiri. Kedua organisasi bersifat independen dan dapat melayani traffic secara paralel. Anda dapat memindahkan workload secara bertahap. Organisasi yang sudah ada tetap menggunakan penagihannya saat ini. Sebelum Anda mengalihkan traffic produksi, periksa batas laju.

Bermigrasi dari Claude Models on Google Cloud (Google managed)

Untuk beralih ke Claude Models on Google Cloud (Anthropic managed), selesaikan langkah-langkah berikut. Sebelum Anda memindahkan beban kerja yang bergantung pada pengaturan ZDR, lihat Retensi data. Untuk mengetahui apa yang berubah saat Anda beralih, lihat Perbedaan kedua penawaran Google Cloud.

1. 1

   Siapkan akun Anda

   Selesaikan setiap langkah di Siapkan akun Anda.

2. 2

   Siapkan akses

   Berikan roles/claude.user kepada setiap identitas yang memanggil Claude Models on Google Cloud (Anthropic managed). Tetapkan project dan ID workspace Anda sebagai variabel lingkungan. Untuk keduanya, lihat Sebelum melakukan panggilan API.

3. 3

   Instal paket SDK

   Instal paket yang menyediakan klien untuk Claude Models on Google Cloud (Anthropic managed). Lihat Instal SDK.

4. 4

   Ganti import dan klien

   Ubah kode yang mengimpor dan membuat klien Anda. Gunakan AnthropicGoogleCloud sebagai pengganti AnthropicVertex. Dalam permintaan cURL, ubah URL, header, dan body. Kode Anda saat ini membuat klien untuk Claude Models on Google Cloud (Google managed). Misalnya, kode berikut membuat klien tersebut dengan endpoint global:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   Kode berikut membuat klien untuk Claude Models on Google Cloud (Anthropic managed):

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   Klien baru membaca project dan ID workspace Anda dari variabel lingkungan yang Anda tetapkan di Temukan ID workspace Anda. Anda tidak meneruskannya saat membuat klien. Panggilan Messages API Anda tetap seperti semula, kecuali untuk ID model dan fitur pada langkah berikutnya.

5. 5

   Periksa ID model dan fitur

   • ID model: Jika Anda menggunakan model yang lebih lama dari Claude 4.6, ganti @ sebelum tanggal snapshot dalam ID-nya dengan tanda hubung. Misalnya, claude-haiku-4-5@20251001 menjadi claude-haiku-4-5-20251001. Untuk model dan ID-nya, lihat ID model API.
   • Fitur: Periksa Dukungan fitur untuk setiap fitur yang digunakan kode Anda.
   • Lokasi: Jika saat ini Anda menggunakan endpoint multi-region atau regional, periksa lokasi mana yang digunakan Claude Models on Google Cloud (Anthropic managed). Lihat Resolusi project, lokasi, dan workspace.
6. 6

   Jalankan permintaan uji

   Jalankan permintaan di Membuat permintaan untuk memeriksa bahwa penyiapan Anda berfungsi. Kemudian jalankan kode Anda sendiri. Jika panggilan gagal dengan kesalahan izin, lihat Pemecahan masalah penyiapan akun. Sebelum Anda memindahkan lalu lintas produksi, periksa batas laju.

Langkah selanjutnya