Claude auf Google Cloud einrichten (von Google verwaltet)

Wenn dein Unternehmen Claude über Google Cloud's Agent Platform kauft, erreichen Claude Code, Claude Desktop und die Anwendungen, die du erstellst, Claude alle über dein eigenes Google Cloud-Projekt. Du meldest dich mit Google Cloud-Anmeldedaten an, sodass du keinen Anthropic API-Key brauchst, und Google Cloud rechnet die Nutzung ab.

Die Einrichtung besteht aus vier Teilen. Jemand richtet das Projekt einmal ein, dann gibt sich jede Person selbst Zugriff. Als Nächstes sendest du Claude eine Anfrage von deinem Terminal aus und erhältst die Antwort. Danach richtest du die App, die du verwendest, auf das Projekt aus. Wenn du Claude nur aus deinem eigenen Code aufrufst, kannst du bei der Antwort aufhören. Bei Claude Code bist du fertig, wenn es dir antwortet und /status deine Projekt-ID anzeigt.

Google Cloud verkauft Claude als zwei Dienste, und sie werden unterschiedlich eingerichtet. Die erste Aufgabe besteht also darin, zu prüfen, welchen du hast.

Prüfe, welchen Dienst du hast

Die beiden Dienste unterscheiden sich darin, wer Claude betreibt. Bei Claude Models on Google Cloud (von Google verwaltet) betreibt Google die Claude-Modelle als Teil von Google Cloud's Agent Platform, früher Vertex AI. Agent Platform ist der Teil von Google Cloud, in dem diese Schritte funktionieren: Du schaltest dessen API ein, du erhältst eine seiner Rollen, und deine Nutzung wird als Agent Platform-Nutzung abgerechnet. Beim von Anthropic verwalteten Dienst betreibt Anthropic die Claude API.

Um herauszufinden, welcher deiner ist, schau dir etwas an, das du bereits hast. Die Tabelle zeigt, worauf du achten solltest.

Model Garden ist der Teil der Google Cloud Console, in dem jedes Modell seine eigene Karte hat.

Anfrage-URLs sind ein drittes Anzeichen. Bei der von Google verwalteten Variante verweisen sie auf einen Agent Platform-Host, und der URL-Pfad enthält .../publishers/anthropic/models/{model}. Die Übersicht der beiden Dienste listet die Hosts auf.

Wenn du die von Anthropic verwaltete Variante hast, folge stattdessen Claude auf Google Cloud einrichten (von Anthropic verwaltet). Wenn du api.anthropic.com mit einem API-Key aufrufst, nutzt du keinen der beiden Dienste.

Was du brauchst und was es kostet

Halte Folgendes bereit, bevor du beginnst:

• Ein Google Cloud-Projekt mit aktivierter Abrechnung und dessen Projekt-ID
• Kontingent für die Claude-Modelle, die du verwenden wirst, in der Region, die du verwenden wirst. Googles Kontingente für Anthropic Claude-Modelle listet die Standardkontingente auf und zeigt, wo du die deines Projekts einsehen oder weitere anfordern kannst.
• Die gcloud CLI, das Kommandozeilen-Tool von Google Cloud
• curl und eine Bash-Shell, um die Testanfrage zu senden
• Claude Code, Version 2.1.293 oder neuer, falls du es verwenden wirst. Um es zu aktualisieren, führe claude update aus.

Wo immer ein Befehl unten YOUR-PROJECT-ID oder PROJECT_ID zeigt, ersetze es durch deine Projekt-ID.

Wenn du die gcloud CLI gerade erst installiert hast, melde sie mit gcloud auth login oder gcloud init an. Das ist die eigene Anmeldung der gcloud CLI, und die Testanfrage verwendet sie. Application Default Credentials, die Claude Code verwendet, sind eine separate Anmeldung, die unter „Gib dir selbst Zugriff“ behandelt wird.

Google Cloud rechnet die Nutzung als Agent Platform-Nutzung ab. Das schließt ein, was du von Claude Code oder Claude Desktop aus sendest. Um Preise nachzuschlagen, beginne beim Abrechnungsabschnitt der Dokumentationsseite dieses Dienstes.

Richte das Projekt einmalig ein

Bevor jemand Claude aus einem Projekt aufrufen kann, muss für das Projekt die Agent Platform API eingeschaltet und ein Claude-Modell aktiviert sein. Diese Schritte werden einmal pro Google Cloud-Projekt durchgeführt, normalerweise von einem Admin. Wenn jemand das für deines bereits erledigt hat, fahre mit „Gib dir selbst Zugriff“ fort.

1. Schalte die Agent Platform API ein. Richte gcloud auf das Projekt aus und aktiviere dann den Dienst aiplatform.googleapis.com.

   bash

   gcloud config set project YOUR-PROJECT-ID
   gcloud services enable \
     aiplatform.googleapis.com

   Googles Schritte, bevor du beginnst, für Claude-Modelle decken diesen Schritt und die Abrechnungsprüfung ab.

2. Aktiviere in Model Garden die Claude-Modelle, die du verwenden wirst. Google listet die Claude-Modellkarten auf. Öffne die Karte für jedes Modell und klicke auf Enable. Aktiviere für Claude Code claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 und claude-sonnet-5. Die ersten drei pinnst du, wenn du Claude Code verbindest. Pinne Claude Sonnet 5 nicht. Mit diesen Pins ist es das Standardmodell, das Aktionen im Auto-Modus prüft, dem Modus, in dem interaktive Sitzungen bei diesem Dienst starten, sofern du keinen anderen festlegst. Ohne die Pins verwendet Claude Code ein Standard-Claude-Sonnet-Modell, das bei diesem Dienst abgekündigt ist.

Wer auch immer auf Enable klickt, muss die Rolle Consumer Procurement Entitlement Manager in Identity and Access Management (IAM) haben. Ihre ID lautet roles/consumerprocurement.entitlementManager.

Gib dir selbst Zugriff

Das Projekt ist bereit, aber dein eigenes Konto braucht noch die Berechtigung, Claude aufzurufen, sowie eine Anmeldung, die Claude Code nutzen kann. Jede Person führt diese Schritte für ihr eigenes Konto durch.

1. Richte gcloud auf das Projekt aus.

   bash

   gcloud config set project YOUR-PROJECT-ID

2. Hol dir eine Rolle, die es dir erlaubt, Claude aufzurufen. Die Identität, die die Aufrufe durchführt, braucht eine IAM-Rolle, die die Berechtigung aiplatform.endpoints.predict enthält, etwa Agent Platform User (roles/aiplatform.user). Dieser Befehl gewährt diese Rolle:

   bash

   gcloud projects add-iam-policy-binding \
     PROJECT_ID \
     --member=PRINCIPAL \
     --role=roles/aiplatform.user

   Ersetze PRINCIPAL durch user: gefolgt von deiner E-Mail-Adresse, zum Beispiel user:you@example.com. Googles Seite zum Gewähren von Zugriff zeigt die anderen Formen, die PRINCIPAL annehmen kann. Wenn du die IAM-Richtlinie des Projekts nicht ändern darfst, bitte einen Admin, den Befehl für dich auszuführen.

3. Melde dich mit Application Default Credentials an. Das sind die Google Cloud-Anmeldedaten, die Claude Code verwendet, wenn es Claude aufruft.

   bash

   gcloud auth application-default login

Sende Claude eine Testanfrage

Sende Claude eine Anfrage, bevor du eine App verbindest. Eine Antwort zeigt dir, dass das Projekt und dein Zugriff beide funktionieren. Die Anfrage ruft die Agent Platform API direkt auf, so wie es eine von dir erstellte Anwendung tut.

1. Prüfe, als welches Konto die gcloud CLI angemeldet ist. Die Anfrage bezieht ihr Token aus der eigenen Anmeldung der gcloud CLI, nicht aus Application Default Credentials.

   bash

   gcloud auth list

   Das aktive Konto muss dasjenige sein, das die Rolle aus „Gib dir selbst Zugriff“ hat. Falls nicht, führe gcloud auth login aus.

2. Sende die Anfrage. Ersetze zuerst YOUR-PROJECT-ID. Google Cloud rechnet diese Anfrage genauso ab wie jede andere.

   bash

   curl https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "anthropic_version": "2026-10-21",
       "messages": [{"role": "user", "content": "Hey Claude!"}],
       "max_tokens": 100
     }'

   Diese Anfrage verwendet die Region global. Wenn du Datenresidenz benötigst, ändern sich sowohl der Host als auch der Pfad. Die Dokumentation zeigt dieselbe Anfrage für die us-Multi-Region.

3. Lies die Antwort. Sie ist JSON, und Claudes Worte stehen im content-Eintrag, dessen type text ist. Deine wird andere Worte und mehr Felder haben als diese gekürzte:

   json

   {
     "type": "message",
     "role": "assistant",
     "content": [{"type": "text", "text": "Hello! Nice to meet you."}],
     "stop_reason": "end_turn"
   }

Ein Fehler kommt ebenfalls als JSON zurück, mit einem dieser Codes:

Die Codes stehen in Googles Liste der API-Fehler. Sobald du eine Antwort erhalten hast, schau dir, falls eine App Claude nicht erreichen kann, zuerst die Anmeldung und Einstellungen dieser App an.

Verbinde Claude Code oder Claude Desktop

Nachdem das Projekt bereit ist, dein Zugriff eingerichtet ist und du eine Antwort von Claude erhalten hast, richte die App, die du verwendest, auf das Projekt aus. Beide Apps fragen nach denselben zwei Werten: deiner Projekt-ID und einer Region. Die folgenden Schritte verwenden die Region global.

Wenn du Datenresidenz benötigst, verwende die us- oder eu-Multi-Region. Sie kostet 10 Prozent mehr als global, das Anfragen an jede Region mit verfügbarer Kapazität sendet. Regionale Endpunkte bedienen nur Claude Sonnet 4.6 und frühere Modelle. Die Dokumentation vergleicht globale, Multi-Region- und regionale Endpunkte.

Claude Code

Der Anmeldeassistent kümmert sich um die Claude Code-Seite.

1. Starte Claude Code.

   bash

   claude

2. Wähle Agent Platform. Wähle bei der Anmeldeaufforderung 3rd-party platform, dann Google Vertex AI. Das ist die Bezeichnung, die die Anmeldeaufforderung immer noch für Google Cloud's Agent Platform verwendet. Wenn du bereits angemeldet bist, führe /login aus, um dasselbe Menü zu öffnen.

3. Folge den Aufforderungen des Assistenten. Wenn er fragt, wie du dich bei Google Cloud authentifizierst, wähle Application Default Credentials von gcloud, die du unter „Gib dir selbst Zugriff“ eingerichtet hast. Gib ihm dann deine Projekt-ID und die Region global. Der Assistent prüft, welche Claude-Modelle dein Projekt aufrufen kann, und lässt dich diese pinnen. Pinne alle drei: claude-opus-5-5, claude-sonnet-5-5 und claude-haiku-5-5. Wenn der Assistent von einer anderen Version eines Modells ausgeht, ändere diese, bevor du pinnst. Mit einem gepinnten Haiku-Modell verwendet Claude Code dieses für Hintergrundaufgaben. Der Assistent speichert das Ergebnis in deiner Benutzereinstellungsdatei, sodass du selbst keine Umgebungsvariablen exportieren musst.

4. Sende Claude Code eine Nachricht. Wenn es antwortet, erreicht Claude Code Claude über Google Cloud.

Prüfe, dass es das Projekt verwendet, das du gemeint hast. Führe /status aus. Die Zeile API provider zeigt Google Vertex AI. Die Zeilen GCP project, Default region und Model zeigen deine Projekt-ID, deine Region und das aufgelöste Modell. Vergleiche die Projekt-ID mit dem Projekt aus „Richte das Projekt einmalig ein“.

Claude Opus-Modelle haben einen höheren Preis pro Token als Sonnet-Modelle. Mit allen drei gepinnten ist Claude Codes primäres Modell weiterhin Opus, sodass dir der Opus-Tarif berechnet wird, bis du mit /model das Modell wechselst. Um später deine Modell-Pins, dein Projekt, deine Region oder deine Anmeldedaten zu ändern, führe /setup-vertex aus, um den Assistenten erneut zu öffnen.

Um Claude Code ohne den Assistenten einzurichten, zum Beispiel in CI oder einem skriptgesteuerten Rollout, setze diese Umgebungsvariablen in der Shell, in der du claude startest:

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-5-5'

Wenn /status dann keine API provider-Zeile zeigt, erreichen die Variablen den Prozess nicht. Die manuellen Einrichtungsschritte behandeln den Rest, einschließlich wie du Modellversionen für ein Team pinnst.

Claude Desktop

Claude Desktop kann Claude-Modelle über dasselbe Projekt nutzen, und Claude Cowork-Sitzungen laufen in dieser App. Ein IT-Administrator stellt sie normalerweise auf jedem Gerät bereit, frag also nach, ob das bei deinem bereits erfolgt ist. Um es auf einem Gerät auszuprobieren, trage dieselben Werte von Hand ein.

1. Öffne das In-App-Konfigurationsfenster. Gehe zu Help → Troubleshooting → Enable Developer Mode, dann Developer → Configure Third-Party Inference….

2. Wähle den Anbieter. Stelle im Abschnitt Connection Inference provider auf Vertex AI.

3. Fülle die Vertex AI-Anmeldedatenkarte aus. Trage deine Projekt-ID in GCP project ID und eine Region in GCP region ein. Die Region kann global sein. Gib dann genau eine Anmeldedatenquelle an. GCP credentials file path akzeptiert die Datei, die gcloud auth application-default login erzeugt. Google listet auf, wo diese Datei gespeichert wird.

4. Füge ein Modell hinzu. Füge unter Models mindestens einen Model list-Eintrag hinzu, wobei du die Publisher-Modell-ID eines von dir aktivierten Modells verwendest, zum Beispiel claude-opus-5-5.

5. Wende die Einstellungen an. Klicke auf Apply Changes. Die App schreibt die Konfiguration nur auf dieses Gerät und startet damit neu. Sende dann eine Nachricht, um zu prüfen, ob Claude antwortet.

Claude Desktop auf 3P mit Google Cloud's Agent Platform bereitstellen behandelt die anderen Anmeldemöglichkeiten und wie du die Einstellungen auf jedes Gerät ausrollst.

Wenn es nicht funktioniert

Diese Fehler können verhindern, dass Claude Code Claude erreicht. Finde deinen in der Tabelle und wende die entsprechende Lösung an.

Ein Modell kann an einem Standort fehlen. Manche Modelle werden nur an global- oder Multi-Region-Standorten wie eu und us angeboten, nicht in bestimmten Regionen. Wenn du deine Region änderst, überprüfe, dass deine Modelle dort verfügbar sind.

Diese Lösungen stammen aus Fehlerbehebung bei Claude Code auf Google Cloud's Agent Platform, wo noch mehr behandelt wird. Beginne für Claude Desktop mit dem eigenen Abschnitt „Troubleshoot“.

Wie es weitergeht

Bewahre deine Projekt-ID und deine Region an einem Ort auf, an dem du sie wiederfindest. Claude Code, Claude Desktop und die SDK-Clients fragen alle danach.

• Um Claude Code zu lernen, absolviere Claude Code 101, dann Claude Code in action.
• Um Claude Cowork zu lernen, absolviere Introduction to Claude Cowork.
• Um Claude aus deinem eigenen Code aufzurufen, folge der Dokumentationsseite zur von Google verwalteten Variante. Sie zeigt, wie du ein SDK installierst und eine Anfrage mit dem AnthropicVertex-Client stellst.

Für mehr zum Dienst selbst hat die Dokumentation einen Abschnitt zu jedem dieser Themen:

• Globale, Multi-Region- und regionale Endpunkte
• Ratenlimits
• Überwachung und Protokollierung
• Abrechnung