Claude auf Google Cloud

Die API für den Zugriff auf Claude auf Google Cloud's Agent Platform ist nahezu identisch mit der Messages API, mit zwei wesentlichen Unterschieden im Anfrageformat:

• Auf Agent Platform wird model nicht im Request-Body übergeben. Stattdessen wird es in der Google Cloud-Endpunkt-URL angegeben.
• Auf Agent Platform wird anthropic_version im Request-Body übergeben (statt als Header) und muss auf den Wert vertex-2023-10-16 gesetzt werden.

Agent Platform wird auch von den offiziellen Client-SDKs von Anthropic unterstützt. Dieser Leitfaden führt dich durch das Senden einer Anfrage an Claude auf Agent Platform mit einem der Client-SDKs von Anthropic.

Beachte, dass dieser Leitfaden davon ausgeht, dass du bereits ein Google Cloud-Projekt hast, das Agent Platform nutzen kann. Siehe Anthropic Claude-Modelle auf Agent Platform für weitere Informationen zur erforderlichen Einrichtung sowie eine vollständige Schritt-für-Schritt-Anleitung.

Ein SDK für den Zugriff auf Agent Platform installieren

Installiere zunächst das Client-SDK von Anthropic für die Sprache deiner Wahl.

pip install -U "anthropic[vertex]"

Zugriff auf Agent Platform

Modellverfügbarkeit

Beachte, dass die Verfügbarkeit der Anthropic-Modelle je nach Region variiert. Suche im Model Garden nach „Claude“ oder gehe zu Anthropic Claude-Modelle, um die neuesten Informationen zu erhalten.

API-Modell-IDs

Die Lebenszyklusbegriffe („Deprecated“ (abgekündigt), „Retired“ (eingestellt)) sind in Modellabkündigungen definiert. Lebenszyklusdaten auf von Partnern betriebenen Plattformen werden vom Partner festgelegt und können vom Zeitplan der Claude API abweichen. Das aktuelle Einstellungsdatum eines beliebigen Modells auf Agent Platform findest du in der Google Cloud-Dokumentation für Claude-Modelle auf Agent Platform.

Anfragen senden

Bevor du Anfragen ausführst, musst du möglicherweise gcloud auth application-default login ausführen, um dich bei Google Cloud zu authentifizieren.

Die folgenden Beispiele zeigen, wie du mit Claude auf Agent Platform Text generierst:

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)

Weitere Details findest du in den Client-SDKs und in der offiziellen Agent Platform-Dokumentation.

Claude ist auch über Amazon Bedrock, Claude Platform on AWS und Microsoft Foundry verfügbar.

Datenaufbewahrung

Die Datenverarbeitung für dieses Angebot unterliegt Google Cloud. Details findest du unter Agent Platform und Zero Data Retention.

Aktivitätsprotokollierung

Agent Platform bietet einen Request-Response-Logging-Dienst, mit dem du die mit deiner Nutzung verbundenen Prompts und Completions protokollieren kannst.

Anthropic empfiehlt, deine Aktivität mindestens auf rollierender 30-Tage-Basis zu protokollieren, um deine Aktivität nachzuvollziehen und möglichen Missbrauch zu untersuchen.

Funktionsunterstützung

Die vollständige Funktionsliste mit Verfügbarkeit auf Google Cloud findest du in der Funktionsübersicht.

Highlights der unterstützten Funktionen

• Messages API
• Prompt-Caching
• Nachdenken
• Tool-Nutzung, einschließlich des Bash-Tools, des Browser-Use-Tools, des Computer-Use-Tools, des Memory-Tools und des Texteditor-Tools
• Websuche-Tool
• Zitate
• Strukturierte Ausgaben

Nicht unterstützte Funktionen

• Eingabequellen (URL-Quellen für Bilder und Dokumente, Files API)
• Serverseitige Tools (Codeausführung, Web Fetch, Advisor)
• Agenten-Infrastruktur (Agent Skills, MCP-Connector, programmatische Tool-Aufrufe)
• API-Endpunkte (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Serverseitiges Fallback (der fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster)

Kontextfenster

Claude Fable 5.1, Claude Fable 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 und Claude Sonnet 4.6 verfügen auf Agent Platform über ein „context window" (Kontextfenster) von 1M Token. Andere Claude-Modelle, darunter Sonnet 4.5 und Sonnet 4 (abgekündigt), haben ein Kontextfenster von 200k Token.

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

Globale, multiregionale und regionale Endpunkte

Agent Platform bietet drei Endpunkttypen:

• Globale Endpunkte: Dynamisches Routing für maximale Verfügbarkeit
• Multiregionale Endpunkte: Dynamisches Routing innerhalb eines geografischen Gebiets (zum Beispiel der Vereinigten Staaten oder der Europäischen Union) für Datenresidenz bei hoher Verfügbarkeit
• Regionale Endpunkte: Garantiertes Datenrouting über bestimmte geografische Regionen

Regionale und multiregionale Endpunkte beinhalten einen Preisaufschlag von 10 % gegenüber globalen Endpunkten.

Wann welche Option verwendet werden sollte

Globale Endpunkte (empfohlen):

• Bieten maximale Verfügbarkeit und Betriebszeit
• Leiten Anfragen dynamisch an Regionen mit verfügbarer Kapazität weiter
• Kein Preisaufschlag
• Am besten für Anwendungen, bei denen die Datenresidenz flexibel ist
• Unterstützen nur Pay-as-you-go-Traffic (Provisioned Throughput erfordert regionale Endpunkte)

Multiregionale Endpunkte:

• Leiten Anfragen dynamisch über Regionen innerhalb eines geografischen Gebiets weiter (derzeit us und eu)
• Nützlich, wenn du Datenresidenz innerhalb einer größeren Geografie benötigst, aber eine höhere Verfügbarkeit als bei einer einzelnen Region wünschst
• Preisaufschlag von 10 % gegenüber globalen Endpunkten
• Unterstützen nur Pay-as-you-go-Traffic (Provisioned Throughput erfordert regionale Endpunkte)

Regionale Endpunkte:

• Leiten Traffic über bestimmte geografische Regionen
• Erforderlich für Datenresidenz in einer einzelnen Region, strenge Compliance-Vorgaben oder Provisioned Throughput
• Unterstützen sowohl Pay-as-you-go als auch Provisioned Throughput
• Der Preisaufschlag von 10 % spiegelt die Infrastrukturkosten für dedizierte regionale Kapazität wider

Implementierung

Verwendung globaler Endpunkte (empfohlen):

Setze beim Initialisieren des Clients den Parameter region auf "global":

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)

Verwendung multiregionaler Endpunkte:

Setze den Parameter region auf eine multiregionale Kennung: "us" für die Vereinigten Staaten oder "eu" für die Europäische Union. Das SDK leitet Anfragen an den entsprechenden multiregionalen Endpunkt weiter (https://aiplatform.us.rep.googleapis.com oder https://aiplatform.eu.rep.googleapis.com), der den Traffic dynamisch über die Regionen innerhalb dieses geografischen Gebiets verteilt.

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)

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

Verwendung regionaler Endpunkte:

Gib eine bestimmte Region wie "us-east5" oder "europe-west1" an:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

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

message = client.messages.create(
    # Bestimmte regionale Endpunkte unterstützen Claude Sonnet 4.6 und früher; neuere Modelle nutzen die globalen oder multiregionalen Endpunkte
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Zusätzliche Ressourcen

• Agent Platform-Preise: Preise für generative KI auf cloud.google.com
• Dokumentation der Claude-Modelle: Claude auf Agent Platform
• Google-Blogbeitrag: Globaler Endpunkt für Claude-Modelle
• Anthropic-Preisdetails: Cloud-Plattform-Preise