Es gibt zwei Wege, Claude zu nutzen und dabei Ihren Google-Cloud-Vertrag und die Abrechnung beizubehalten. Der eine ist die Von Google verwaltete Variante, die Google als Teil der Agent Platform (früher Vertex AI) betreibt. Der andere ist die Von Anthropic verwaltete Variante, bei der Sie die von Anthropic betriebene Claude API aus einem Google-Cloud-Projekt heraus nutzen. Sie ist seit dem 22. Oktober 2026 allgemein verfügbar (Ankündigung von Anthropic). Beide erscheinen auf Ihrer Google-Cloud-Rechnung, unterscheiden sich aber bei den verfügbaren Funktionen, den Regionen, der Frage, wer die Nutzungslimits verwaltet, und der Unterstützung für Claude Code.

Kurz gesagt: Welche Variante wählen?

Von Google verwaltet

Aktiviert über Model Garden in der Agent Platform (früher Vertex AI)

  • Sie möchten Claude Code auf Google Cloud nutzen
  • Ihre Daten sollen nur von Google verarbeitet werden, oder die Inferenz muss in der EU bleiben
  • Sie möchten Kontingente in der Google Cloud Console verwalten

Von Anthropic verwaltet

Abonniert über den Google Cloud Marketplace

  • Sie benötigen die Files API, Agent Skills, Managed Agents, Web Fetch, den MCP-Connector und ähnliche Funktionen
  • Sie möchten den Fast Mode für Opus 5.5
  • Sie möchten neue Funktionen früh nutzen (erklärte Richtlinie ist die Verfügbarkeit am selben Tag wie in der Claude API)

Wenn Sie nur Claude Code brauchen, wählen Sie die von Google verwaltete Variante. Die Dokumentation von Claude Code beschreibt keine Einrichtung für Claude Code mit der von Anthropic verwalteten Variante.

Auf Grundlage der offiziellen Dokumentation von Anthropic und Google Cloud (geprüft am 26. Oktober 2026) erklärt dieser Artikel die Unterschiede zwischen den beiden Varianten, die Preise, die Regionen, den Einstieg, die Einrichtung von Claude Code und den Umgang mit Kontingenten und 429-Fehlern. In Abschnitten, die beide Varianten behandeln, erscheinen sie in der Reihenfolge Von Google verwaltet → Von Anthropic verwaltet, in denselben Farben.

1. Wie sich die beiden Varianten unterscheiden

Beide heißen „Claude Models on Google Cloud“ und werden durch „Google managed“ bzw. „Anthropic managed“ in Klammern unterschieden. Google nennt Vertex AI inzwischen „Gemini Enterprise Agent Platform“, und die Titel der Dokumentation lauten nun Agent Platform. Der Anmeldebildschirm von Claude Code zeigt jedoch weiterhin „Google Vertex AI“ an.

PunktVon Google verwaltetVon Anthropic verwaltet
Betrieben vonGoogle (Teil der Agent Platform)Anthropic
Wer die Daten verarbeitetGoogle CloudAnthropicGoogle übernimmt Authentifizierung, API-Routing, Audit-Logs und Abrechnung; Inferenz und Datenspeicherung laufen auf der Infrastruktur von Anthropic
Form der APIPrediction-Endpunkt der Agent PlatformDer Modellname steht in der URLWie die Claude APINur Basis-URL und Authentifizierung unterscheiden sich
AbrechnungGoogle Cloud (als Nutzung der Agent Platform)Google Cloud MarketplaceGemessen in Claude Consumption Units (1 CCU = 0,01 US-Dollar)
Nutzungslimits verwaltet vonGoogle Cloud (Kontingente)Anthropic
IAM-Rollenroles/aiplatform.user und weitereroles/claude.user, roles/claude.admin, roles/claude.viewer
Admin-KonsoleGoogle Cloud Console (Model Garden)Claude Console (aus der Google Cloud Console geöffnet)
SDK-ClientAnthropicVertexAnthropicGoogleCloud (Beta)
Neue Modelle und FunktionenNach dem Zeitplan von Agent Platform und Model GardenRichtlinie: Verfügbarkeit am selben Tag wie in der Claude API

Quellen: die Vergleichstabelle in „Claude Models on Google Cloud“ von Anthropic sowie „Use Claude models on Google Cloud (Anthropic managed)“ und „Anthropic Claude models“ von Google Cloud. Geprüft am 26. Oktober 2026.

Es gibt auch Gemeinsamkeiten. Beide werden mit Google-Cloud-Anmeldedaten aufgerufen (einschließlich Application Default Credentials, kurz ADC), und die Kosten erscheinen auf Ihrer Google-Cloud-Rechnung. Ab Claude 4.6 sind die Modell-IDs in beiden Varianten dieselben wie in der Claude API (zum Beispiel claude-opus-5-5). Bei älteren Modellen setzt nur die von Google verwaltete Variante ein @ vor das Datum (zum Beispiel claude-haiku-4-5@20251001).

Bei der Von Anthropic verwalteten Variante wird für jedes Google-Cloud-Projekt eine neue Anthropic-Organisation angelegt. Sie ist getrennt von jeder Organisation, die Sie bereits mit der Claude API oder mit Claude Enterprise nutzen, und eine bestehende Organisation lässt sich nicht übertragen. API-Schlüssel, Workspaces und Console-Einstellungen werden nicht übernommen, und Ressourcen wie Dateien und Batches bleiben in der ursprünglichen Organisation.

2. So wählen Sie: 5 Fragen

Gehen Sie von oben nach unten und nehmen Sie die erste Frage, die zutrifft. Trifft keine zu, entscheiden Sie danach, wie gut sich die Kosten abschätzen lassen. Die Von Google verwaltete Variante veröffentlicht ihre Preisliste und Standardkontingente, sodass Sie Budget und Limits vorab abschätzen können. Der Funktionsumfang der Von Anthropic verwalteten Variante und der frühe Zugang zu Neuerungen werden zum Vorteil, wenn Sie die Preise im Marketplace-Eintrag und die Limits bei Ihrem Ansprechpartner bei Anthropic klären können.

  • Sie möchten Claude Code mit Abrechnung über Google Cloud nutzen→Von Google verwaltet
  • Ihre Daten sollen nur von Google verarbeitet werden, oder Sie benötigen VPC Service Controls, regionale Datenspeicherung oder Zertifizierungen wie FedRAMP High→Von Google verwaltet
  • Die Inferenz darf nur innerhalb der EU laufen→Von Google verwaltet (Multi-Region eu)
  • Sie nutzen die Files API, Agent Skills, Managed Agents, Web Fetch, den MCP-Connector, Codeausführung oder die Message Batches API→Von Anthropic verwaltet
  • Sie möchten den Fast Mode für Opus 5.5→Von Anthropic verwaltet

Die zweite Frage nennt die Fälle, in denen die Dokumentation von Google Cloud die von Google verwaltete Variante empfiehlt (Use Claude models on Google Cloud (Anthropic managed)).

Sie können auch beide nutzen. Zum Beispiel verwenden Entwickler Claude Code über die von Google verwaltete Variante, während Ihre eigene Anwendung Managed Agents über die von Anthropic verwaltete Variante aufruft. Beide erscheinen auf derselben Google-Cloud-Rechnung, aber Admin-Konsolen und Verwaltung der Nutzungslimits sind getrennt.

3. Unterschiede bei den Funktionen

Die größten Unterschiede liegen bei den serverseitigen Funktionen, die Anthropic betreibt. Die von Google verwaltete Variante konzentriert sich auf die Messages API; Dateispeicher und Laufzeitumgebungen für Agenten sind nicht verfügbar.

FunktionVon Google verwaltetVon Anthropic verwaltet
Messages API, StreamingJaJa
Prompt-CachingJaJa
Extended Thinking, strukturierte AusgabenJaJa
WebsucheJaJa
Computer Use (API-Tool)JaJaNicht in der Funktionsliste der Anthropic-Dokumentation, aber in der Vergleichstabelle von Google Cloud und in der Ankündigung von Anthropic aufgeführt
Web Fetch, Codeausführung, AdvisorNeinJa
Files APINeinJa
Agent Skills, MCP-ConnectorNeinJa
Claude Managed AgentsNeinJaMCP-Tunnel sind nicht verfügbar
Message Batches APINeinStattdessen Batch-Vorhersage der Agent Platform nutzenJa
Fast Mode (Opus 5.5)Keine AngabeNicht in der Liste der unterstützten FunktionenJa

Quellen: Abschnitt Feature support in „Claude Models on Google Cloud (Anthropic managed)“, „Claude Models on Google Cloud (Google managed)“ und „Fast mode“ von Anthropic. Der Fast Mode fehlt bei der von Google verwalteten Variante in der Liste der unterstützten Funktionen der Anthropic-Dokumentation, die weder sagt, dass er verfügbar ist, noch dass er es nicht ist (die Funktionstabelle von Claude Code führt ihn auf der Agent Platform als nicht verfügbar). Geprüft am 26. Oktober 2026.

Wie Managed Agents funktionieren, erklärt „Was sind Claude Managed Agents?“; Geschwindigkeit und Preise des Fast Mode behandelt „Claude Opus 5.5 im Überblick“.

4. Preise: genauso teuer wie die Claude API?

Preise der Von Google verwalteten Variante

Auf dem global-Endpunkt der Von Google verwalteten Variante sind die Preise für Eingabe, Ausgabe und Cache bei Opus 5.5, Sonnet 5.5 und Haiku 5.5 dieselben wie in der Claude API von Anthropic. Die Multi-Regionen us und eu kosten 10 % mehr als global (regionale Endpunkte kosten ebenfalls 10 % mehr, bedienen aber nur Sonnet 4.6 und ältere Modelle; siehe Abschnitt 5).

Quellen: „Pricing“ von Anthropic, Abschnitt Anthropic’s Claude models in „Agent Platform pricing“ von Google Cloud und „Claude Models on Google Cloud (Google managed)“ von Anthropic (Multi-Region- und regionale Endpunkte kosten 10 % mehr als global, für Sonnet 4.5, Haiku 4.5, Opus 4.5 und neuere Modelle). Geprüft am 26. Oktober 2026. Die von Anthropic verwaltete Variante fehlt im Diagramm, weil ihre Preise pro Token nicht in der offiziellen Dokumentation stehen (siehe den Abschnitt unten).

ModellEingabeAusgabeCache-LesenCache-Schreiben (5 Min. / 1 Std.)
Opus 5.54 $20 $0,20 $5 $ / 8 $
Sonnet 5.52 $10 $0,10 $2,50 $ / 4 $
Haiku 5.5Eingabe bis 100.000 Token0,10 $0,50 $0,01 $0,125 $ / 0,20 $
Haiku 5.5Eingabe über 100.000 Token0,50 $2,50 $0,05 $0,625 $ / 1 $

US-Dollar pro Million Token. Preise der Claude API von Anthropic und des global-Endpunkts der von Google verwalteten Variante (Preisseiten beider Unternehmen, geprüft am 26. Oktober 2026). Die Multi-Regionen us/eu kosten das 1,1-Fache dieser Preise. Cache-Lesen kostet bei Opus 5.5 und Sonnet 5.5 das 0,05-Fache der Eingabe, bei Haiku 5.5 das 0,1-Fache (Hinweis auf der Preisseite von Anthropic). Die vollständige Modellliste und die Preishistorie finden Sie in „Claude-Preise nach Modell im Vergleich“.

Provisioned Throughput, bei dem Kapazität gegen eine feste Gebühr reserviert wird, ist auf global und den Multi-Regionen nicht verfügbar und erfordert einen regionalen Endpunkt (Dokumentation von Google Cloud). Da regionale Endpunkte nur Sonnet 4.6 und ältere Modelle bedienen, werden Opus 5.5, Sonnet 5.5 und Haiku 5.5 nutzungsbasiert (Pay-as-you-go) abgerechnet.

Preise der Von Anthropic verwalteten Variante

Bei der Von Anthropic verwalteten Variante misst Anthropic die Nutzung in Claude Consumption Units (CCU, 1 CCU = 0,01 US-Dollar) und meldet sie an Google Cloud, wo sie auf Ihrer Google-Cloud-Rechnung erscheint. Anthropic stellt keine separate Rechnung. Eine Preisliste pro Token ist weder in der offiziellen Dokumentation von Anthropic noch in der von Google Cloud veröffentlicht (geprüft am 26. Oktober 2026). Verlässlich ist es, die Preise vor dem Abonnieren im Eintrag im Google Cloud Marketplace zu prüfen und nach dem Start mit einem kleinen Test den tatsächlichen Betrag auf der Usage-Seite der Claude Console und in den Abrechnungsberichten von Google Cloud zu bestätigen.

Drei Dinge sind offiziell dokumentiert:

  • Der Fast Mode für Opus 5.5 kostet 8 $ für die Eingabe und 40 $ für die Ausgabe pro Million Token (Fast-mode-Seite und Ankündigung von Anthropic).
  • Wer einer Anfrage inference_geo: "us" hinzufügt, um die Inferenz in den USA zu halten, zahlt in allen Kategorien das 1,1-Fache („Data residency“ von Anthropic).
  • Wenn Sie eine Google-Cloud-Ausgabenzusage haben, wird die Nutzung wie andere Marketplace-Käufe darauf angerechnet. Wenn Sie eine Rabattvereinbarung haben, wenden Sie sich vor dem Start an Ihren Ansprechpartner bei Anthropic oder Google Cloud (Rabatte gelten nicht rückwirkend).

Batch-Preise

Die beiden Varianten behandeln Batches unterschiedlich. Die Von Google verwaltete Variante nutzt die Batch-Vorhersage der Agent Platform (mit JSONL-Eingabe aus BigQuery oder Cloud Storage), und ihre Preise stehen in der Batch-Spalte der Preisseite von Google Cloud. Die Von Anthropic verwaltete Variante unterstützt dieselbe Message Batches API wie die Claude API, ihre Batch-Preise stehen aber ebenfalls nicht in der offiziellen Dokumentation. Den Batch-Rabatt der Claude API (direkt) behandelt „Claude-Preise nach Modell im Vergleich“.

5. Regionen und Datenspeicherung

Bei Claude auf Google Cloud bestimmt die aufgerufene location, wo die Inferenz läuft. Die Von Google verwaltete Variante bietet drei Typen, die Von Anthropic verwaltete Variante nur global.

global

Von Google verwaltet Von Anthropic verwaltet

Führt die Inferenz in der Region aus, die gerade Kapazität hat. Preise wie in der Claude API. Die von Anthropic verwaltete Variante kann eine Anfrage mit inference_geo: "us" auf die USA beschränken (1,1x).

Multi-Region us/eu

Von Google verwaltet

Führt die Inferenz nur in den USA oder in der EU aus. Verfügbar für Claude 4.7 und neuere Modelle. Preise 1,1x.

Regional

Von Google verwaltet

Führt die Inferenz nur in der einen angegebenen Region aus. Bedient Sonnet 4.6 und ältere Modelle; neuere Modelle nutzen global oder eine Multi-Region.

Quellen: „Claude Models on Google Cloud (Google managed)“ und „(Anthropic managed)“ von Anthropic, „Agent Platform partner models“ von Google Cloud. Geprüft am 26. Oktober 2026.

Auch die Speicherorte der Daten unterscheiden sich. Die Von Google verwaltete Variante speichert Daten in der gewählten Region oder Multi-Region. Die Seite zu Partnermodellen von Google Cloud sagt jedoch auch, dass der Verarbeitungsort vom Speicherort abweichen kann. Die Dokumentation von Anthropic wiederum sagt, dass die Multi-Region-Inferenz innerhalb von us bzw. eu bleibt, und das Verhältnis der beiden Aussagen wird nicht erklärt. Wenn Sie strenge Anforderungen an den Verarbeitungsort haben, klären Sie das vor Vertragsabschluss mit Google Cloud. Mit der Organisationsrichtlinie constraints/gcp.restrictEndpointUsage können Sie außerdem den global-Endpunkt sperren und nur Multi-Regionen zulassen.

Bei der Von Anthropic verwalteten Variante ist die Speicherregion des Workspace "us" und lässt sich nicht ändern („Data residency“ von Anthropic).

Stand 26. Oktober 2026 decken die Multi-Regionen in der offiziellen Dokumentation beider Varianten nur die USA und die EU ab. Wenn Verarbeitung oder Speicherung in einem bestimmten Land außerhalb dieser Gebiete bleiben müssen, klären Sie vor Vertragsabschluss mit Google Cloud oder Ihrem Ansprechpartner bei Anthropic, ob es eine passende location gibt.

6. Erste Schritte

Beide Varianten setzen ein Google-Cloud-Projekt und ein Rechnungskonto mit aktivierter Abrechnung voraus. Unten stehen die Schritte aus der offiziellen Dokumentation, mit denen Sie jede Variante verfügbar machen, gefolgt von den gemeinsamen Schritten für Authentifizierung und Aufruf.

Von Google verwaltet: erste Schritte

  1. Agent Platform API aktivieren
    gcloud config set project YOUR-PROJECT-ID
    gcloud services enable aiplatform.googleapis.com
    Einmal pro Projekt erforderlich.
  2. Gewünschte Claude-Modelle in Model Garden aktivierenWer sie aktiviert, benötigt die Rolle Consumer Procurement Entitlement Manager (roles/consumerprocurement.entitlementManager). Außerdem muss cloudcommerceconsumerprocurement.googleapis.com durch Ihre Organisationsrichtlinie zugelassen sein. Laut Dokumentation von Claude Code kann die Freigabe des Zugriffs 24 bis 48 Stunden dauern (die Dokumentation von Google Cloud nennt keine Dauer).
  3. Aufrufenden eine Rolle zuweisenWeisen Sie eine Rolle mit der Berechtigung aiplatform.endpoints.predict zu (roles/aiplatform.user).

Quellen: „Claude Models on Google Cloud (Google managed)“ von Anthropic, „Agent Platform partner models“ von Google Cloud. Geprüft am 26. Oktober 2026.

Typische Stolpersteine beim Einstieg (von Google verwaltet)
  • Ein Modell lässt sich in Model Garden nicht aktivieren: Prüfen Sie, ob die aktivierende Person die Rolle Consumer Procurement Entitlement Manager hat und ob cloudcommerceconsumerprocurement.googleapis.com durch Ihre Organisationsrichtlinie zugelassen ist.
  • Aufrufe liefern 404 (Modell nicht gefunden): Prüfen Sie, ob Sie das Modell aktiviert haben und ob es in der gewählten location existiert (neuere Modelle gibt es nur auf global oder einer Multi-Region).
  • Aufrufe liefern 403: Prüfen Sie, ob der Aufrufende roles/aiplatform.user hat.

Von Anthropic verwaltet: erste Schritte

  1. Im Marketplace abonnierenÖffnen Sie „Claude Models on Google Cloud (Anthropic managed)“ im Google Cloud Marketplace und klicken Sie auf „Subscribe“. Sie benötigen Marketplace-Kaufberechtigungen für das Rechnungskonto.
  2. Zwei Dienste aktivieren
    gcloud services enable claude.googleapis.com \
      anthropic-managed-claude.cloudpartnerservices.goog \
      --project=YOUR-PROJECT-ID
    Einmal pro Projekt erforderlich.
  3. Organisation aktivierenKlicken Sie auf der Claude-Seite auf „Activate“ und folgen Sie dann dem Link, der an Ihre Kontakt-E-Mail-Adresse geschickt wird, um Organisationsname, Unternehmensart, Land und Anwendungsfall einzugeben und die Commercial Terms of Service sowie die Usage Policy von Anthropic zu akzeptieren. Dafür ist roles/claude.admin erforderlich.
  4. Workspace-ID notierenGehen Sie in der Claude Console (aus der Google Cloud Console geöffnet) zu „Settings > Workspaces“ und notieren Sie die ID, die mit wrkspc_ beginnt. Sie wird für Aufrufe benötigt.
  5. Aufrufenden eine Rolle zuweisenWeisen Sie roles/claude.user zu. Rollen gelten pro Projekt; wenn Sie Teams trennen möchten, nutzen Sie getrennte Projekte (jedes Projekt wird zu einer eigenen Anthropic-Organisation).

Quelle: Abschnitt Set up your account in „Claude Models on Google Cloud (Anthropic managed)“ von Anthropic (geprüft am 26. Oktober 2026). Bei der Anthropic-Organisation kann man sich nicht mit einer E-Mail-Adresse anmelden; die Console wird aus der Google Cloud Console geöffnet.

Beide Varianten: authentifizieren und aufrufen

Führen Sie bei beiden Varianten auf dem aufrufenden Rechner gcloud auth application-default login aus, um ADC zu erstellen; das SDK verwendet dann diese Anmeldedaten (auf Servern Anmeldedaten eines Dienstkontos verwenden). Rufen Sie das Modell anschließend mit dem SDK-Client aus Abschnitt 7 auf.

Typische Stolpersteine beim Einstieg (von Anthropic verwaltet)
  • Der Dienst wird nicht gefunden: Führen Sie gcloud mit demselben Konto aus, mit dem Sie im Marketplace abonniert haben.
  • Berechtigungsfehler beim ersten Aufruf: Prüfen Sie, ob claude.googleapis.com aktiviert ist und der Aufrufende roles/claude.user hat.
  • Die Schaltfläche bleibt bei „Finish Setup“: Ein Admin hat die Angaben zur Organisation noch nicht vollständig eingegeben.
  • Die Nutzung erscheint nicht in der Console: Es dauert einige Minuten, bis sie angezeigt wird.

7. Claude über das SDK aufrufen

Die offiziellen SDKs von Anthropic unterstützen beide Varianten. Nur das zu installierende Paket und der Clientname unterscheiden sich; messages.create schreibt man genauso wie bei der Claude API.

Von Google verwaltet (Python)

# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global")  # "us" oder "eu" funktionieren auch
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hallo, Claude"}],
)

In TypeScript verwenden Sie AnthropicVertex aus @anthropic-ai/vertex-sdk. Für einen HTTP-Aufruf ohne SDK hat die URL die Form https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict; lassen Sie den Modellnamen im Request-Body weg und geben Sie dort "anthropic_version" an (vertex-2023-10-16 oder 2026-10-21). Für Streaming verwenden Sie :streamRawPredict. Was sich mit der neuen API-Version 2026-10-21 ändert, behandelt „temperature is deprecated for this model: Ursachen und Lösungen“.

Von Anthropic verwaltet (Python)

# pip install -U "anthropic[google_cloud]"
# Umgebungsvariablen: ANTHROPIC_GOOGLE_CLOUD_PROJECT und
#           ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (erforderlich)
from anthropic import AnthropicGoogleCloud

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

In TypeScript ist es AnthropicGoogleCloud aus @anthropic-ai/google-cloud-sdk (beide befinden sich in der Beta). Über HTTP sind Request- und Response-Body dieselben wie bei der Claude API; die Unterschiede:

  • Basis-URL: https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke, die die Workspace-ID enthält (den Header anthropic-workspace-id nicht senden).
  • Authentifizierung: ein Google-Zugriffstoken mit Authorization: Bearer senden (x-api-key nicht senden).
  • API-Schlüssel: können nicht erstellt werden. Die Umgebungsvariablen ANTHROPIC_API_KEY und ANTHROPIC_BASE_URL werden ignoriert.

Quellen: „Claude Models on Google Cloud (Anthropic managed)“ und „(Google managed)“ von Anthropic. Geprüft am 26. Oktober 2026.

8. Claude Code auf Google Cloud nutzen

Auf Google Cloud unterstützt Claude Code die Von Google verwaltete Variante. Die Funktionstabelle von Claude Code definiert die Agent Platform als „von Google betrieben, konfiguriert mit CLAUDE_CODE_USE_VERTEX“. Wie man Claude Code mit der Von Anthropic verwalteten Variante nutzt, beschreibt die Dokumentation von Claude Code nicht (geprüft am 26. Oktober 2026).

Zwei Wege zur Einrichtung

  1. Mit dem Assistenten einrichtenStarten Sie claude und wählen Sie auf dem Anmeldebildschirm „3rd-party platform“ → „Google Vertex AI“ (wenn Sie bereits angemeldet sind, verwenden Sie /login). Der Assistent fragt nach Authentifizierungsmethode, Projekt und Region und lässt Sie prüfen, welche Modelle verfügbar sind, und diese festlegen. Das Ergebnis wird unter env in Ihren Benutzereinstellungen (~/.claude/settings.json) gespeichert, und Sie können ihn später mit /setup-vertex erneut öffnen.
  2. Mit Umgebungsvariablen einrichtenDas eignet sich für CI und die Einführung im Team. Nachdem Sie die Modelle in Model Garden aktiviert haben, setzen Sie Folgendes.
    export CLAUDE_CODE_USE_VERTEX=1
    export CLOUD_ML_REGION=global
    export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
    
    # Modelle festlegen
    # Hauptmodell: Sonnet hält die Kosten niedrig. Für Opus claude-opus-5-5 verwenden
    export ANTHROPIC_MODEL=claude-sonnet-5-5
    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
    Warum Sie die Modelle festlegen sollten, erklärt der Warnhinweis unten.

In beiden Fällen führen Sie nach der Einrichtung /status aus. Wenn „API provider“ Google Vertex AI anzeigt und Zeilen für GCP-Projekt, Region und Modell erscheinen, hat die Einrichtung funktioniert.

Quellen: „Claude Code on Google Cloud’s Agent Platform“ und „Environment variables“ von Claude Code. Geprüft am 26. Oktober 2026.

Zwei Hinweise, wenn Sie die Modelle nicht festlegen

  • Kosten: Auf der Agent Platform ist das Standard-Hauptmodell ohne Festlegung Opus 5.5. Die Dokumentation von Claude Code warnt, dass ohne Festlegung zu Opus-Preisen abgerechnet wird.
  • Abweichende Aliase: Der Alias sonnet verweist auf Sonnet 4.5 und haiku auf Haiku 4.5, anders als die Aliase in der Claude API. Damit sich das Modell einzelner Nutzer nicht verschiebt, wenn neue Modelle erscheinen, legen Sie die Modelle mit den vier Variablen oben fest, wenn Sie für mehrere Personen ausrollen.

Wie Aliase funktionieren, erklärt auch „Was ist opusplan in Claude Code?“

Ist ein Modell in der location von CLOUD_ML_REGION nicht verfügbar, können Sie die Region nur für dieses Modell überschreiben, etwa mit VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (dieses Beispiel ruft nur Haiku 4.5 in der Region us-east5 auf). CLOUD_ML_REGION akzeptiert global, us oder eu oder einen Regionsnamen wie us-east5. Auch das Claude Agent SDK nutzt die von Google verwaltete Variante mit denselben Umgebungsvariablen (siehe „Was ist das Claude Agent SDK?“).

Automatische Erneuerung der Anmeldedaten, Caching und 1M-Kontext
  • Um ADC beim Ablauf automatisch zu erneuern, fügen Sie Ihren Einstellungen "gcpAuthRefresh": "gcloud auth application-default login" hinzu (die Erneuerung gilt als fehlgeschlagen, wenn der Authentifizierungsbefehl nicht innerhalb von 3 Minuten endet).
  • Prompt-Caching wird automatisch angewendet. Zum Abschalten setzen Sie DISABLE_PROMPT_CACHING=1; für einen 1-Stunden-Cache setzen Sie ENABLE_PROMPT_CACHING_1H=1 (der Schreibpreis ist höher).
  • Modelle wie Sonnet 5 und neuer sowie Opus 4.7 und neuer nutzen standardmäßig einen Kontext von 1M Token. Für 200K setzen Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1.
  • Die Dokumentation von Claude Code empfiehlt, ein eigenes Projekt für Claude Code anzulegen, um dessen Kosten getrennt zu verfolgen.

Unterstützung der Claude-Code-Funktionen auf der Agent Platform

StatusFunktionen
Nicht verfügbarFunktionen, die ein Claude-Abonnement erfordern (Cloud-Sitzungen, Slack, /schedule, Ultrareview, Code Review, Remote Control, die Chrome-Erweiterung, Computer Use, Artifacts, Spracheingabe), Fast Mode, Advisor, Channels, das Analytics-Dashboard, serverseitig verwaltete Einstellungen, /logout
TeilweiseWebsuche (Opus 4, Sonnet 4, Haiku 4.5 und neuer), Auto-Modus (Sonnet 5 und neuer, Opus 4.7 und neuer, Haiku 5.5, Claude Fable), Zero Data Retention (abhängig von Ihrer Vereinbarung mit Google Cloud)
VerfügbarGitHub Actions, GitLab CI/CD, MCP Tool Search (Opus 4.5, Sonnet 4.5, Haiku 4.5 und neuer)

Computer Use in dieser Tabelle ist die Claude-Code-Funktion (die ein Abonnement erfordert), nicht das Computer-Use-Tool der API aus Abschnitt 3. Quelle: „Feature availability“ von Claude Code (/logout und MCP Tool Search stammen aus „Claude Code on Google Cloud’s Agent Platform“). Geprüft am 26. Oktober 2026. Auch claude.ai-Connectors werden nicht geladen (siehe „claude.ai-Connectors sind in Claude Code deaktiviert“).

Häufige Fehler in Claude Code und Lösungen (von Google verwaltet)
  • Could not load the default credentials: Führen Sie gcloud auth application-default login aus oder setzen Sie GOOGLE_APPLICATION_CREDENTIALS auf den Pfad einer Schlüsseldatei.
  • Modell nicht gefunden (404): Prüfen Sie, ob Sie das Modell in Model Garden aktiviert haben und ob es in der gewählten location existiert (neuere Modelle gibt es nur auf global oder einer Multi-Region).
  • 429: Wenn Sie eine Region angegeben haben, prüfen Sie, ob dort sowohl das Hauptmodell als auch das kleine Modell verfügbar sind, und erwägen Sie CLOUD_ML_REGION=global.

9. Kontingente und 429-Fehler

Von Google verwaltet: Kontingente pro Modellfamilie

Modelle, die nach dem 26. Mai 2026 erschienen sind (Opus 5.5, Sonnet 5.5, Haiku 5.5 und weitere), nutzen Kontingente, die innerhalb der Modellfamilie geteilt werden (für ältere Modelle prüfen Sie die Kontingente pro Modell auf derselben Seite von Google Cloud). Gleich welche Opus-Version Sie auf global aufrufen, sie zehrt vom selben Kontingent anthropic-claude-opus, und bei einer neuen Version müssen Sie kein neues Kontingent beantragen. global und jede Multi-Region haben getrennte Kontingente.

Modellglobal (pro Minute)Multi-Region us/eu (jeweils, pro Minute)
Opus 5.52.000 Anfragen / 20 Mio. Eingabe-Token / 2 Mio. Ausgabe-Token1.000 Anfragen / 10 Mio. Eingabe-Token / 1 Mio. Ausgabe-Token
Sonnet 5.52.500 Anfragen / 25 Mio. Eingabe-Token / 2,5 Mio. Ausgabe-Token1.250 Anfragen / 12,5 Mio. Eingabe-Token / 1,25 Mio. Ausgabe-Token
Haiku 5.53.000 Anfragen / 30 Mio. Eingabe-Token / 3 Mio. Ausgabe-Token1.500 Anfragen / 15 Mio. Eingabe-Token / 1,5 Mio. Ausgabe-Token

Quelle: Standardkontingente in „Quotas for Anthropic Claude models“ von Google Cloud (geprüft am 26. Oktober 2026). Eingabe ist die Summe aus nicht gecachten Token und Cache-Schreibvorgängen. Google weist darauf hin, dass die Limits je nach Konto variieren und eingeschränkt sein können.

Kontingente prüfen und Erhöhungen beantragen Sie auf der Seite Quotas & System Limits in der Google Cloud Console. Ein Filter nach base_model (zum Beispiel anthropic-claude-opus) erleichtert die Suche. Die Token-Zahlen auf dieser Seite können wegen der Schätz- und Erstattungslogik ungenau sein; für genaue Zahlen nutzen Sie die Token-Counting-API oder token_count im Metrics Explorer.

Wenn Sie ein Kontingent überschreiten, erhalten Sie einen 429-Fehler mit dieser Meldung:

Resource exhausted, please try again later.

Das ist die Meldung bei nutzungsbasierter Abrechnung (Pay-as-you-go; „Error code 429“ von Google Cloud). Mit Provisioned Throughput lautet sie „Too many requests. Exceeded the Provisioned Throughput.“

  1. global verwenden, wenn der Inferenzort keine Rolle spieltEs hat größere Kontingente als die Multi-Regionen und wird in der Region verarbeitet, die gerade Kapazität hat. In Claude Code setzen Sie CLOUD_ML_REGION=global. Wenn Sie eine Anforderung haben, etwa die Inferenz in der EU zu halten, überspringen Sie diesen Schritt und beantragen Sie zuerst eine Erhöhung (Schritt 3).
  2. Warten und erneut versuchenWiederholen Sie mit exponentiellem Backoff mit Obergrenze und vermeiden Sie plötzliche Lastspitzen.
  3. Kontingenterhöhung beantragenBeantragen Sie sie auf der oben genannten Seite Quotas & System Limits.

Quellen: „Error code 429“ von Google Cloud, Abschnitt zur Fehlerbehebung in „Claude Code on Google Cloud’s Agent Platform“ von Claude Code.

Von Anthropic verwaltet: Limits verwaltet Anthropic

Die Nutzungslimits verwaltet Anthropic, und Standardwerte stehen nicht in der offiziellen Dokumentation. Für Erhöhungen wenden Sie sich an Ihren Ansprechpartner bei Anthropic oder an den Vertrieb. Die Dokumentation von Anthropic empfiehlt, die Limits vor der Umstellung von Produktions-Traffic zu bestätigen. Fehler haben dieselbe Form wie in der Claude API: Das Überschreiten eines Limits liefert 429 rate_limit_error, Überlastung liefert 529 overloaded_error. Fehlen IAM-Berechtigungen, liefert Google Cloud 403.

  1. Warten und erneut versuchenWiederholen Sie mit exponentiellem Backoff und vermeiden Sie plötzliche Lastspitzen (wie bei der von Google verwalteten Variante).
  2. Limits vor dem Produktivbetrieb bestätigenNennen Sie Ihrem Ansprechpartner bei Anthropic vor der Migration das benötigte Volumen und bestätigen Sie Ihre Limits.
  3. Limiterhöhung anfragenWenden Sie sich an Ihren Ansprechpartner bei Anthropic oder an den Vertrieb. Über die Kontingentseite von Google Cloud lassen sich die Limits nicht erhöhen.

Quellen: Abschnitt Rate limits in „Claude Models on Google Cloud (Anthropic managed)“ von Anthropic und „Errors“. Geprüft am 26. Oktober 2026.

Zusammenfassung

  • Claude auf Google Cloud gibt es in zwei Varianten: von Google verwaltet (Agent Platform, früher Vertex AI) und von Anthropic verwaltet. Beide erscheinen auf Ihrer Google-Cloud-Rechnung.
  • Für Claude Code nutzen Sie die von Google verwaltete Variante. Setzen Sie CLAUDE_CODE_USE_VERTEX=1 und die zugehörigen Variablen, und legen Sie die Modelle mit den vier Variablen fest, wenn Sie für mehrere Personen ausrollen.
  • Für Files API, Agent Skills, Managed Agents, Web Fetch, den MCP-Connector und Ähnliches oder für den Fast Mode von Opus 5.5 nutzen Sie die von Anthropic verwaltete Variante.
  • Die von Google verwaltete Variante auf global hat bei Opus 5.5, Sonnet 5.5 und Haiku 5.5 dieselben Preise wie die Claude API. Die Multi-Regionen us/eu kosten 1,1x. Die von Anthropic verwaltete Variante wird in CCU gemessen, und eine Preisliste pro Token steht nicht in der offiziellen Dokumentation.
  • Die Kontingente der von Google verwalteten Variante werden pro Modellfamilie geteilt; bei Überschreitung kommt 429 „Resource exhausted, please try again later.“ Abhilfe: global verwenden, erneut versuchen, Erhöhung beantragen. Die Limits der von Anthropic verwalteten Variante verwaltet Anthropic.
  • Die von Anthropic verwaltete Variante legt pro Projekt eine neue Anthropic-Organisation an, und bestehende Organisationen lassen sich nicht übertragen.
  • Die einzigen Multi-Regionen in der offiziellen Dokumentation beider Varianten sind us und eu; klären Sie Anforderungen an andere Länder vor Vertragsabschluss.

FAQ

Q. Ist Claude auf Vertex AI teurer als die Claude API?

Auf dem global-Endpunkt der von Google verwalteten Variante sind die Preise für Eingabe, Ausgabe und Cache bei Opus 5.5, Sonnet 5.5 und Haiku 5.5 gleich. Die Multi-Regionen us und eu kosten 10 % mehr (Preisseiten von Anthropic und Google Cloud, geprüft am 26. Oktober 2026). Für die von Anthropic verwaltete Variante stehen die Preise pro Token nicht in der offiziellen Dokumentation; prüfen Sie daher den Eintrag im Google Cloud Marketplace.

Q. Kann ich einen Claude-API-Schlüssel verwenden?

Beide Varianten werden mit Google-Cloud-Authentifizierung (ADC oder Dienstkonto) aufgerufen, nicht mit einem in der Claude Console erstellten API-Schlüssel. Die von Anthropic verwaltete Variante kann keine API-Schlüssel erstellen, und ein gesetztes ANTHROPIC_API_KEY wird ignoriert.

Q. Kann ich Claude Code mit der von Anthropic verwalteten Variante nutzen?

Die Dokumentation von Claude Code beschreibt keine Einrichtung für die von Anthropic verwaltete Variante (geprüft am 26. Oktober 2026). Die Google-Cloud-Einstellung von Claude Code (CLAUDE_CODE_USE_VERTEX) gilt für die von Google verwaltete Variante.

Q. Kann ich meine bestehende Anthropic-Organisation auf Google-Cloud-Abrechnung umstellen?

Nein. Die von Anthropic verwaltete Variante legt pro Projekt eine neue Organisation an, und bestehende Organisationen lassen sich nicht umwandeln. API-Schlüssel, Workspaces und Console-Einstellungen werden nicht übernommen; Sie legen sie in der neuen Organisation neu an.