Skip to main content

​
Voraussetzungen

Bevor Sie Claude Code mit Google Cloud’s Agent Platform, ehemals Vertex AI, konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:
  • Ein Google Cloud Platform (GCP)-Konto mit aktivierter Abrechnung
  • Ein GCP-Projekt mit aktivierter Google Cloud’s Agent Platform API
  • Zugriff auf gewünschte Claude-Modelle (z. B. Claude Sonnet 4.6)
  • Google Cloud SDK (gcloud) installiert und konfiguriert
  • Kontingent im gewünschten GCP-Bereich zugewiesen
Um sich mit Ihren eigenen Google Cloud’s Agent Platform-Anmeldedaten anzumelden, folgen Sie Anmelden mit Google Cloud’s Agent Platform unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum manuellen Setup und fixieren Sie Ihre Modellversionen, bevor Sie ausrollen.

​
Anmelden mit Agent Platform

Wenn Sie Google Cloud-Anmeldedaten haben und Claude Code über Google Cloud’s Agent Platform verwenden möchten, führt Sie der Anmeldeasistent durch den Prozess. Sie führen die GCP-seitigen Voraussetzungen einmal pro Projekt durch; der Assistent kümmert sich um die Claude Code-Seite.
1

Aktivieren Sie Claude-Modelle in Ihrem GCP-Projekt

Aktivieren Sie Google Cloud’s Agent Platform API für Ihr Projekt, und fordern Sie dann Zugriff auf die Claude-Modelle an, die Sie im Google Cloud’s Agent Platform Model Garden möchten. Siehe IAM-Konfiguration für die Berechtigungen, die Ihr Konto benötigt.
2

Starten Sie Claude Code und wählen Sie Google Cloud's Agent Platform

Führen Sie claude aus. Wählen Sie bei der Anmeldeeingabeaufforderung 3rd-party platform und dann Google Vertex AI, das Label, das die Anmeldeeingabeaufforderung immer noch für Google Cloud’s Agent Platform verwendet.
3

Folgen Sie den Eingabeaufforderungen des Assistenten

Wählen Sie, wie Sie sich bei Google Cloud authentifizieren: Application Default Credentials von gcloud, eine Service-Account-Schlüsseldatei oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihr Projekt und Ihre Region, überprüft, welche Claude-Modelle Ihr Projekt aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im env-Block Ihrer Benutzereinstellungsdatei gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.
Nachdem Sie sich angemeldet haben, führen Sie /setup-vertex jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Ihr Projekt, Ihre Region oder Ihre Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in ~/.claude/settings.json oder in $CLAUDE_CONFIG_DIR/settings.json, wenn CLAUDE_CONFIG_DIR gesetzt ist.

​
Regionskonfiguration

Claude Code unterstützt Google Cloud’s Agent Platform globale, Multi-Region- und regionale Endpunkte. Legen Sie CLOUD_ML_REGION auf global, einen Multi-Region-Standort wie eu oder us oder eine bestimmte Region wie us-east5 fest. Claude Code wählt den korrekten Google Cloud’s Agent Platform-Hostnamen für jedes Formular aus, einschließlich der Hosts aiplatform.eu.rep.googleapis.com und aiplatform.us.rep.googleapis.com für Multi-Region-Standorte.
Google Cloud’s Agent Platform unterstützt möglicherweise die Claude Code-Standardmodelle nicht auf jedem Endpunkttyp. Die Modellverfügbarkeit variiert je nach spezifischen Regionen, Multi-Region-Standorten und globalen Endpunkten. Möglicherweise müssen Sie zu einem unterstützten Standort wechseln oder ein unterstütztes Modell angeben.

​
Manuelles Setup

Um Google Cloud’s Agent Platform über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.

​
  1. Aktivieren Sie die Agent Platform API

Aktivieren Sie die Agent Platform API von Google Cloud in Ihrem GCP-Projekt:

​
  1. Fordern Sie Modellzugriff an

Fordern Sie Zugriff auf Claude-Modelle in Google Cloud’s Agent Platform an:
  1. Navigieren Sie zum Google Cloud’s Agent Platform Model Garden
  2. Suchen Sie nach ‘Claude”-Modellen
  3. Fordern Sie Zugriff auf gewünschte Claude-Modelle an (z. B. Claude Sonnet 4.6)
  4. Warten Sie auf Genehmigung (kann 24–48 Stunden dauern)

​
  1. Konfigurieren Sie GCP-Anmeldedaten

Claude Code verwendet die standardmäßige Google Cloud-Authentifizierung. Weitere Informationen finden Sie in der Google Cloud-Authentifizierungsdokumentation. Claude Code v2.1.121 oder später unterstützt X.509-zertifikatbasierte Workload Identity Federation über die gleiche Application Default Credentials-Kette. Legen Sie GOOGLE_APPLICATION_CREDENTIALS auf den Pfad Ihrer Anmeldedaten-Konfigurationsdatei fest.
Claude Code verwendet ANTHROPIC_VERTEX_PROJECT_ID als die Projekt-ID für Google Cloud’s Agent Platform-Anfragen. Die Umgebungsvariablen GCLOUD_PROJECT und GOOGLE_CLOUD_PROJECT sowie die Anmeldedatei, auf die GOOGLE_APPLICATION_CREDENTIALS verweist, haben Vorrang vor ihr. Wenn keine dieser Optionen gesetzt sind, wird die Projekt-ID aus Ihrer gcloud-Konfiguration oder dem angehängten Service-Konto aufgelöst.

​
Erweiterte Anmeldedaten-Konfiguration

Claude Code unterstützt die automatische Aktualisierung von Anmeldedaten für GCP über die Einstellung gcpAuthRefresh. Wenn Claude Code erkennt, dass Ihre GCP-Anmeldedaten abgelaufen sind oder