Claude Platform Docs
MessagesGoogle Cloud

Claude Models on Google Cloud (Google managed)

Richte Claude Models on Google Cloud (Google managed) ein, das Google als Teil von Google Cloud’s Agent Platform betreibt. Rufe dann Claude mit dem Anthropic SDK oder cURL auf.

Claude Models on Google Cloud vergleicht die beiden Google Cloud-Angebote. Dort erfährst du auch, wie du erkennst, welches du verwendest.

Vor API-Aufrufen

Um Claude Models on Google Cloud (Google managed) zu verwenden, benötigst du:

  1. Ein Google Cloud-Projekt, das Agent Platform verwenden kann. Die Einrichtungsschritte findest du auf der Google Cloud-Seite Anthropic Claude-Modelle auf Agent Platform.
  2. Die installierte gcloud CLI für die lokale Entwicklung.
  3. Für die Identität, die die Aufrufe ausführt, eine IAM-Rolle, die die Berechtigung aiplatform.endpoints.predict enthält, zum Beispiel Agent Platform User (roles/aiplatform.user). Details findest du auf der Google Cloud-Seite Agent Platform-Partnermodelle.
  4. Google Cloud-Anmeldedaten für diese Identität. Um das SDK bei Google Cloud zu authentifizieren, musst du möglicherweise gcloud auth application-default login ausführen. Eine cURL-Anfrage an Claude Models on Google Cloud (Google managed) kann ihr Token über gcloud auth print-access-token beziehen. Dieser Befehl verwendet die eigene Anmeldung der gcloud CLI, nicht die Application Default Credentials. Führe deshalb gcloud auth login oder gcloud init aus, bevor du ihn verwendest.

Ein SDK installieren

Das Client-SDK unterstützt Claude Models on Google Cloud (Google managed) über AnthropicVertex. Installiere das Paket, das dies bereitstellt:

pip install -U "anthropic[vertex]"

Die ant CLI unterstützt Claude Models on Google Cloud (Google managed) nicht.

Anfragen stellen

Anfragen an Claude Models on Google Cloud (Google managed) gehen an eine Agent Platform-Endpunkt-URL, die auf :rawPredict endet. „Streaming“-Anfragen (Streaming-Anfragen) verwenden stattdessen :streamRawPredict.

Eine Anfrage ist nahezu identisch mit einer Anfrage an die Messages APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.. Sie unterscheidet sich in zwei wesentlichen Punkten:

  • Modell: Die Endpunkt-URL benennt das Modell. Lass in einer cURL-Anfrage model im Body weg.
  • Version: Übergib in einer cURL-Anfrage anthropic_version im Body und nicht als Header. Setze den Wert auf vertex-2023-10-16 oder auf API-Version 2026-10-21.

Das SDK übernimmt beide Unterschiede für dich. Es verschiebt deinen model-Wert in die URL und setzt anthropic_version auf die API-Version, die es mit der Claude API verwendet. Welche Modell-IDs du übergeben kannst, erfährst du unter API-Modell-IDs.

In den folgenden Beispielen authentifiziert sich der SDK-Client mit Application Default Credentials. Wie du Application Default Credentials einrichtest, erfährst du unter Vor API-Aufrufen.

Die folgenden Beispiele verwenden den globalen Endpunkt. Informationen zu den anderen Endpunkttypen findest du unter Globale, multiregionale und regionale Endpunkte.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

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

API-Modell-IDs

ModellModell-ID der Agent Platform API
Claude Fable 5.2claude-fable-5-2
Claude Mythos 5.2 (eingeschränkt verfügbar)claude-mythos-5-2
Claude Fable 5.1claude-fable-5-1
Claude Mythos 5.1 (eingeschränkt verfügbar)claude-mythos-5-1
Claude Fable 5claude-fable-5
Claude Mythos 5 (eingeschränkt verfügbar)claude-mythos-5
Claude Opus 5.5claude-opus-5-5
Claude Opus 5claude-opus-5
Claude Opus 4.8claude-opus-4-8
Claude Opus 4.7claude-opus-4-7
Claude Opus 4.6claude-opus-4-6
Claude Opus 4.5claude-opus-4-5@20251101
Claude Opus 4.1 (veraltet)claude-opus-4-1@20250805
Claude Opus 4 (veraltet)claude-opus-4@20250514
Claude Sonnet 5.5claude-sonnet-5-5
Claude Sonnet 5claude-sonnet-5
Claude Sonnet 4.6claude-sonnet-4-6
Claude Sonnet 4.5 (veraltet)claude-sonnet-4-5@20250929
Claude Sonnet 4 (veraltet)claude-sonnet-4@20250514
Claude Haiku 5.5claude-haiku-5-5
Claude Haiku 4.5claude-haiku-4-5@20251001

Claude Models on Google Cloud (Google managed) bietet in verschiedenen Regionen unterschiedliche Claude-Modelle an. Um zu prüfen, welche Modelle eine Region anbietet, suche in Model Garden nach „Claude“ oder sieh dir die Google Cloud-Seite Anthropic Claude-Modelle auf Agent Platform an.

Google legt die Lebenszyklusdaten für die Modelle fest, die Claude Models on Google Cloud (Google managed) bereitstellt. Diese Daten können vom Zeitplan der Claude API abweichen. Das aktuelle Einstellungsdatum eines Modells findest du auf der Google Cloud-Seite Anthropic Claude-Modelle auf Agent Platform. Was „Abgekündigt“ und „Eingestellt“ bedeuten, erfährst du unter Modellabkündigungen.

Claude Code

Lass Claude Code deinen Code auf ein neueres Modell migrieren

/claude-api migrate dieses Projekt auf das neueste Claude Opus-Modell

Globale, multiregionale und regionale Endpunkte

Claude Models on Google Cloud (Google managed) bietet drei Endpunkttypen an. Du wählst einen über den Regionswert aus, den du beim Erstellen des Clients übergibst. In einer cURL-Anfrage legt der Endpunkttyp den Host und das locations-Segment der URL fest.

EndpunkttypRegionswertHost
Global (empfohlen)"global"aiplatform.googleapis.com
Multiregional"us" oder "eu"aiplatform.us.rep.googleapis.com
aiplatform.eu.rep.googleapis.com
RegionalEine Region, zum Beispiel "us-east5"{region}-aiplatform.googleapis.com

Die Endpunkttypen unterscheiden sich darin, wohin sie Anfragen senden:

  • Global: Anfragen gehen an eine beliebige Region mit verfügbarer Kapazität. Verwende diesen Typ, wenn du maximale Verfügbarkeit möchtest und die Datenresidenz flexibel ist.
  • Multiregional: Anfragen gehen an eine beliebige Region in den Vereinigten Staaten ("us") oder der Europäischen Union ("eu"). Verwende diesen Typ, wenn du Datenresidenz innerhalb eines größeren geografischen Raums und eine höhere Verfügbarkeit als bei einer einzelnen Region benötigst.
  • Regional: Anfragen gehen nur an die von dir angegebene Region, zum Beispiel "us-east5" oder "europe-west1". Verwende diesen Typ, wenn du Datenresidenz in einer einzelnen Region benötigst oder strenge Compliance-Vorgaben erfüllen musst.

Multiregionale und regionale Endpunkte kosten 10 Prozent mehr als globale Endpunkte. Alle drei Endpunkttypen nehmen Pay-as-you-go-Traffic an, und Provisioned Throughput erfordert einen regionalen Endpunkt.

Regionale Endpunkte stellen nur Claude Sonnet 4.6 und frühere Modelle bereit. Verwende für neuere Modelle einen globalen oder multiregionalen Endpunkt.

Die folgenden Beispiele verwenden den multiregionalen Endpunkt us. Die hervorgehobenen Zeilen legen die Region fest. Eine vollständige Anfrage an den globalen Endpunkt findest du unter Anfragen stellen.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

Unterstützte Funktionen

Zu den Funktionen, die auf Claude Models on Google Cloud (Google managed) unterstützt werden, gehören:

Die Funktionsübersicht listet jede Funktion auf. Die Seite der jeweiligen Funktion zeigt, ob Claude Models on Google Cloud (Google managed) sie unterstützt.

Nicht unterstützte Funktionen

Claude Models on Google Cloud (Google managed) unterstützt Folgendes nicht:

  • Eingabequellen: URL-Quellen für Bilder und Dokumente sowie die Files API
  • Serverseitige Tools: Codeausführung, Web Fetch und Advisor
  • Agent-Infrastruktur: Agent Skills, MCP-Connector und programmatischer Tool-Aufruf
  • API-Endpunkte: Message Batches API, Models API, Admin API, Compliance API sowie Usage and Cost API
  • Claude Managed Agents
  • Serverseitiger Fallback: Der fallbacks-Parameter

Verwende anstelle des serverseitigen Fallbacks das clientseitige Fallback-Muster.

Kontextfenster

Claude Models on Google Cloud (Google managed) bietet für diese Modelle ein „context window“ (Kontextfenster) mit 1M Token:

  • Claude Fable 5.2
  • Claude Mythos 5.2
  • Claude Fable 5.1
  • Claude Mythos 5.1
  • Claude Fable 5
  • Claude Mythos 5
  • Claude Opus 5.5
  • Claude Opus 5
  • Claude Opus 4.8
  • Claude Opus 4.7
  • Claude Opus 4.6
  • Claude Sonnet 5.5
  • Claude Sonnet 5
  • Claude Sonnet 4.6
  • Claude Haiku 5.5

Andere Claude-Modelle haben ein Kontextfenster mit 200k Token. Dazu gehören Claude Sonnet 4.5 (abgekündigt) und Claude Sonnet 4 (abgekündigt).

Agent Platform begrenzt Anfrage-Payloads auf 30 MB. Wenn du große Dokumente oder viele Bilder sendest, erreichst du dieses Limit möglicherweise vor dem Token-Limit.

Abrechnung, Ratenlimits und Protokollierung

Ratenlimits

Google Cloud verwaltet „rate limits“ (Ratenlimits) und Kontingente für Claude Models on Google Cloud (Google managed). Details, einschließlich der Beantragung einer Kontingenterhöhung, findest du auf der Google Cloud-Seite Kontingente für Anthropic Claude-Modelle.

Abrechnung

Google Cloud stellt dir Claude Models on Google Cloud (Google managed) in Rechnung. Preise findest du auf der Google Cloud-Seite Preise für generative KI. Die Preise hängen auch vom Endpunkttyp ab. Siehe Globale, multiregionale und regionale Endpunkte.

Datenaufbewahrung

Google Cloud regelt den Umgang mit Daten für Claude Models on Google Cloud (Google managed). Details findest du unter Agent Platform und Zero Data Retention.

Überwachung und Protokollierung

Um Prompts und Completions für Claude Models on Google Cloud (Google managed) zu protokollieren, verwende den Request-Response-Logging-Dienst von Agent Platform.

Anthropic empfiehlt, mindestens die Protokolle der letzten 30 Tage aufzubewahren. Die Protokolle helfen dir, deine Aktivität nachzuvollziehen und möglichen Missbrauch zu untersuchen.

Migration von Claude Models on Google Cloud (Anthropic managed)

Was sich beim Wechsel ändert, erfährst du unter Wie sich die beiden Google Cloud-Angebote unterscheiden. Um zu Claude Models on Google Cloud (Google managed) zu wechseln, führe diese Schritte aus:

  1. Zugriff einrichten

    Prüfe, ob dein Projekt und die Identität, die die Aufrufe ausführt, die Anforderungen unter Vor API-Aufrufen erfüllen.

  2. Das SDK-Paket installieren

    Installiere das Paket, das den Client für Claude Models on Google Cloud (Google managed) bereitstellt. Siehe Ein SDK installieren.

  3. Import und Client ersetzen

    Ändere den Code, der deinen Client importiert und erstellt. Verwende AnthropicVertex anstelle von AnthropicGoogleCloud. Eine cURL-Anfrage benötigt eine neue URL, neue Header und einen neuen Body. Der folgende Code erstellt den Client für Claude Models on Google Cloud (Anthropic managed), den du heute verwendest:

    from anthropic import AnthropicGoogleCloud
    
    client = AnthropicGoogleCloud()

    Der folgende Code erstellt den Client für Claude Models on Google Cloud (Google managed). Er verwendet den globalen Endpunkt. Informationen zu den anderen Endpunkttypen findest du unter Globale, multiregionale und regionale Endpunkte.

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

    Dieser Code übergibt beim Erstellen des Clients deine Projekt-ID und eine Region. Ersetze MY_PROJECT_ID durch deine Projekt-ID. Die Messages API-Aufrufe, die du mit dem Client ausführst, bleiben unverändert. Ausnahmen sind die Modell-IDs und Funktionen im nächsten Schritt.

  4. Modell-IDs und Funktionen prüfen

    • Modell-IDs: Wenn du ein Modell vor Claude 4.6 verwendest, ersetze den Bindestrich vor dem Snapshot-Datum in seiner ID durch @. Zum Beispiel wird claude-haiku-4-5-20251001 zu claude-haiku-4-5@20251001. Die Modelle und ihre IDs findest du unter API-Modell-IDs.
    • Funktionen: Prüfe, dass die Funktionen, die dein Code verwendet, nicht unter Nicht unterstützte Funktionen aufgeführt sind.
  5. Eine Testanfrage ausführen

    Führe die Anfrage unter Anfragen stellen aus, um zu prüfen, ob deine Einrichtung funktioniert. Führe dann deinen eigenen Code aus. Bevor du Produktions-Traffic umstellst, lies die Informationen zu Ratenlimits für Claude Models on Google Cloud (Google managed).

Nächste Schritte

Entdecke die Funktionen von Claude.

Prüfe, welche Claude-Modelle jede Region anbietet, und ihre Einstellungsdaten.

Lies die Dokumentation zu Google Cloud’s Agent Platform.

Lies den Blogbeitrag von Google Cloud über den globalen Endpunkt für Claude-Modelle.

War diese Seite hilfreich?