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.



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

Lebenszyklusbegriffe (Deprecated, Retired) sind unter Modell-Deprecations definiert. Lebenszyklusdaten 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-4-8",
    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 unterliegt Google Cloud. Details findest du unter Agent Platform und Zero Data Retention.



Aktivitätsprotokollierung

Agent Platform bietet einen Request-Response-Logging-Service, mit dem Kunden die Prompts und Completions protokollieren können, die mit ihrer Nutzung verbunden sind.

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



Feature-Unterstützung

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



Unterstützte Feature-Highlights

• Messages API
• Prompt-Caching
• Erweitertes Denken
• Tool-Nutzung, einschließlich Bash-Tool, Computer-Use-Tool, Memory-Tool und Text-Editor-Tool
• 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 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. Beim Senden großer Dokumente oder vieler Bilder kannst du dieses Limit vor dem Token-Limit erreichen.



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 verwenden

Globale Endpunkte (empfohlen):

• Bieten maximale Verfügbarkeit und Uptime
• 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 größeren Geografie benötigst, aber 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

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

Multi-Region-Endpunkte verwenden:

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

Regionale Endpunkte verwenden:

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

from anthropic import AnthropicVertex

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

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

message = client.messages.create(
    model="claude-opus-4-8",
    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