Claude auf Google Cloud

Die API für den Zugriff auf Claude über 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. Diese Anleitung führt dich durch das Senden einer Anfrage an Claude auf Agent Platform mit einem der Client-SDKs von Anthropic.

Beachte, dass diese Anleitung 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 und eine vollständige 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 von Anthropic-Modellen je nach Region variiert. Suche nach „Claude" im Model Garden oder gehe zu Anthropic Claude-Modelle für die neuesten Informationen.



API-Modell-IDs

Lebenszyklus-Begriffe (Deprecated, Retired) sind unter Modell-Deprecations definiert. Lebenszyklus-Daten auf partnerbetriebenen Plattformen werden vom Partner festgelegt und können vom Zeitplan der Claude API abweichen. Das aktuelle Abschaltdatum eines 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 Text von Claude auf Agent Platform 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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Siehe die Client-SDKs und die offizielle Agent Platform-Dokumentation für weitere Details.

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



Datenaufbewahrung

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



Aktivitätsprotokollierung

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

Anthropic empfiehlt, deine Aktivitäten mindestens auf rollierender 30-Tage-Basis zu protokollieren, um deine Aktivitäten nachzuvollziehen und potenziellen Missbrauch zu untersuchen.



Feature-Unterstützung

Die vollständige Feature-Liste mit Google Cloud-Verfügbarkeit findest du unter Features-Übersicht.



Highlights der unterstützten Features

• Messages API
• Prompt-Caching
• Thinking
• Tool-Nutzung, einschließlich des Bash-Tools, Computer-Use-Tools, Memory-Tools und Text-Editor-Tools
• Web-Search-Tool
• Zitate
• Strukturierte Ausgaben



Nicht unterstützte Features

• Eingabequellen (URL-Quellen für Bilder und Dokumente, Files API)
• Serverseitige Tools (Code-Ausfü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
• Serverseitiger Fallback (der fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster)



Kontextfenster

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 und Claude Sonnet 4.6 haben ein 1M-Token-Kontextfenster auf Agent Platform. Andere Claude-Modelle, einschließlich Sonnet 4.5 und Sonnet 4 (deprecated), haben ein 200k-Token-Kontextfenster.

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



Globale, Multi-Region- und regionale Endpunkte

Agent Platform bietet drei Endpunkttypen:

• Globale Endpunkte: Dynamisches Routing für maximale Verfügbarkeit
• Multi-Region-Endpunkte: Dynamisches Routing innerhalb eines geografischen Gebiets (zum Beispiel die Vereinigten Staaten oder die Europäische Union) für Datenresidenz mit hoher Verfügbarkeit
• Regionale Endpunkte: Garantiertes Daten-Routing durch bestimmte geografische Regionen

Regionale und Multi-Region-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ützt nur Pay-as-you-go-Traffic (Provisioned Throughput erfordert regionale Endpunkte)

Multi-Region-Endpunkte:

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

Regionale Endpunkte:

• Leiten Traffic durch 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 den region-Parameter auf "global", wenn du den Client initialisierst:

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Verwendung von Multi-Region-Endpunkten:

Setze den region-Parameter auf einen Multi-Region-Identifier: "us" für die Vereinigten Staaten oder "eu" für die Europäische Union. Das SDK leitet Anfragen an den entsprechenden Multi-Region-Endpunkt weiter (https://aiplatform.us.rep.googleapis.com oder https://aiplatform.eu.rep.googleapis.com), der den Traffic dynamisch über Regionen innerhalb dieser Geografie 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",
    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(
    # Spezifische regionale Endpunkte unterstützen Claude Sonnet 4.6 und früher; neuere Modelle verwenden die globalen oder Multi-Region-Endpunkte
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)



Zusätzliche Ressourcen

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