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:
- Ein Google Cloud-Projekt, das Agent Platform verwenden kann. Die Einrichtungsschritte findest du auf der Google Cloud-Seite Anthropic Claude-Modelle auf Agent Platform.
- Die installierte gcloud CLI für die lokale Entwicklung.
- Für die Identität, die die Aufrufe ausführt, eine IAM-Rolle, die die Berechtigung
aiplatform.endpoints.predictenthält, zum Beispiel Agent Platform User (roles/aiplatform.user). Details findest du auf der Google Cloud-Seite Agent Platform-Partnermodelle. - Google Cloud-Anmeldedaten für diese Identität. Um das SDK bei Google Cloud zu authentifizieren, musst du möglicherweise
gcloud auth application-default loginausführen. Eine cURL-Anfrage an Claude Models on Google Cloud (Google managed) kann ihr Token übergcloud auth print-access-tokenbeziehen. Dieser Befehl verwendet die eigene Anmeldung der gcloud CLI, nicht die Application Default Credentials. Führe deshalbgcloud auth loginodergcloud initaus, 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
modelim Body weg. - Version: Übergib in einer cURL-Anfrage
anthropic_versionim Body und nicht als Header. Setze den Wert aufvertex-2023-10-16oder auf API-Version2026-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
| Modell | Modell-ID der Agent Platform API |
|---|---|
| Claude Fable 5.2 | claude-fable-5-2 |
| Claude Mythos 5.2 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5-2 |
| Claude Fable 5.1 | claude-fable-5-1 |
| Claude Mythos 5.1 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5-1 |
| Claude Fable 5 | claude-fable-5 |
| Claude Mythos 5 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5 |
| Claude Opus 5.5 | claude-opus-5-5 |
| Claude Opus 5 | claude-opus-5 |
| Claude Opus 4.8 | claude-opus-4-8 |
| Claude Opus 4.7 | claude-opus-4-7 |
| Claude Opus 4.6 | claude-opus-4-6 |
| Claude Opus 4.5 | claude-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.5 | claude-sonnet-5-5 |
| Claude Sonnet 5 | claude-sonnet-5 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Sonnet 4.5 (veraltet) | claude-sonnet-4-5@20250929 |
| Claude Sonnet 4 (veraltet) | claude-sonnet-4@20250514 |
| Claude Haiku 5.5 | claude-haiku-5-5 |
| Claude Haiku 4.5 | claude-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-ModellGlobale, 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.
| Endpunkttyp | Regionswert | Host |
|---|---|---|
| Global (empfohlen) | "global" | aiplatform.googleapis.com |
| Multiregional | "us" oder "eu" | aiplatform.us.rep.googleapis.comaiplatform.eu.rep.googleapis.com |
| Regional | Eine 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:
- Messages APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.
- „Prompt caching“ (Prompt-Caching)
- „Thinking“ (Nachdenken)
- „Tool use“ (Tool-Nutzung), einschließlich dieser Tools:
- Zitate
- Strukturierte Ausgaben
- „Fast mode“ (schneller Modus) auf unterstützten Modellen
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:
Zugriff einrichten
Prüfe, ob dein Projekt und die Identität, die die Aufrufe ausführt, die Anforderungen unter Vor API-Aufrufen erfüllen.
Das SDK-Paket installieren
Installiere das Paket, das den Client für Claude Models on Google Cloud (Google managed) bereitstellt. Siehe Ein SDK installieren.
Import und Client ersetzen
Ändere den Code, der deinen Client importiert und erstellt. Verwende
AnthropicVertexanstelle vonAnthropicGoogleCloud. 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:Pythonfrom 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.
Pythonfrom 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_IDdurch 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.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 wirdclaude-haiku-4-5-20251001zuclaude-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.
- Modell-IDs: Wenn du ein Modell vor Claude 4.6 verwendest, ersetze den Bindestrich vor dem Snapshot-Datum in seiner ID durch
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?