Claude Code mit Claude-Modellen auf Google Cloud (von Anthropic verwaltet)

Claude-Modelle auf Google Cloud (von Anthropic verwaltet) ist die Claude API, die von Anthropic betrieben und über Ihr Google-Cloud-Projekt erreicht wird. Um sie mit Claude Code zu nutzen, melden Sie sich bei Google Cloud an und setzen drei Umgebungsvariablen.

Google Cloud bietet Claude außerdem über die Agent Platform von Google Cloud an, früher Vertex AI, die von Google verwaltet wird. Wenn Sie die Agent Platform verwenden, folgen Sie stattdessen Claude Code auf der Agent Platform von Google Cloud. Um herauszufinden, welches Angebot Sie nutzen, lesen Sie Which offering are you using?

Bevor Sie beginnen, installieren Sie Claude Code in Version 2.1.307 oder höher. Um Ihre Version zu prüfen, führen Sie claude --version in Ihrer Shell aus. Zum Aktualisieren führen Sie claude update aus.

Voraussetzungen

Ein Google-Cloud-Projekt, in dem die Kontoeinrichtung abgeschlossen ist
Die IAM-Rolle roles/claude.user für dieses Projekt, für jedes Google-Konto oder Dienstkonto, das Claude Code ausführt
Ihre Projekt-ID und Ihre Workspace-ID, die mit wrkspc_ beginnt
Die gcloud CLI, wenn Sie sich mit einem Google-Konto statt mit einer Dienstkonto-Schlüsseldatei anmelden

Claude Code einrichten

Application Default Credentials erstellen

Google-Konto
Dienstkonto-Schlüsseldatei

Führen Sie diesen Befehl in Ihrer Shell aus und melden Sie sich mit dem Google-Konto an, das die Rolle roles/claude.user hat:

gcloud auth application-default login

Führen Sie ihn auch dann aus, wenn Sie bereits gcloud auth login ausgeführt haben.Wenn GOOGLE_APPLICATION_CREDENTIALS gesetzt ist, entfernen Sie die Variable. Solange diese Variable gesetzt ist, verwendet Claude Code die darin angegebene Datei und ignoriert die Anmeldedaten, die der Befehl speichert.

Setzen Sie in der Shell oder dem CI-Job, der Claude Code ausführt, GOOGLE_APPLICATION_CREDENTIALS auf den Pfad einer Dienstkonto-Schlüsseldatei. Informationen zu anderen Quellen für Anmeldedaten finden Sie unter Authentifizierung.

Variablen zu Ihren Einstellungen hinzufügen

Fügen Sie drei Variablen zum env-Block Ihrer Benutzer-Einstellungsdatei ~/.claude/settings.json hinzu. Wenn die Datei nicht existiert, erstellen Sie sie mit diesem Inhalt:

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

Verwenden Sie Ihre eigene Projekt-ID und Workspace-ID anstelle von my-project-id und dem wrkspc_-Wert. Um stattdessen eine einzelne Shell oder einen CI-Job zu konfigurieren, setzen Sie dieselben drei Variablen in dieser Umgebung.Sie müssen sich weder bei einem Anthropic-Konto anmelden noch von einem abmelden.

Claude Code starten und den Anbieter prüfen

Führen Sie claude in Ihrer Shell aus und anschließend /status in der Eingabeaufforderung von Claude Code. Die Zeile API provider enthält on Google Cloud, und die Zeilen danach zeigen Ihre Workspace ID, GCP project und GCP location. Um dieselben Zeilen aus Ihrer Shell oder einem CI-Job auszugeben, führen Sie claude auth status --text aus.Wenn Sie on Google Cloud sehen, senden Sie einen Prompt oder führen Sie in einem CI-Job claude -p "hello" aus. Eine Antwort bestätigt, dass Ihre Anmeldedaten und Ihre IAM-Rolle funktionieren. Wenn Sie es nicht sehen oder Claude Code einen Fehler anzeigt, beheben Sie Fehler in der Anbietereinrichtung.

Claude Code für ein Team einrichten

Legen Sie den env-Block aus Schritt 2 von Claude Code einrichten in einer Datei für verwaltete Einstellungen auf dem Rechner jedes Entwicklers ab. Weisen Sie jedem Entwickler die Rolle roles/claude.user für das Projekt zu und lassen Sie jeden auf seinem eigenen Rechner gcloud auth application-default login ausführen.

Modellversionen festlegen

Wenn Sie Claude Code für ein Team bereitstellen, legen Sie die Modell-IDs fest, damit ein Update von Claude Code nicht alle gleichzeitig auf ein neueres Modell umstellt. Fügen Sie diese Variablen zu dem env-Block hinzu, der die drei Variablen aus Claude Code einrichten enthält:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Verwenden Sie anstelle der Beispielwerte die gewünschten Modell-IDs der Claude API aus der Modellübersicht.

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`	Ja	Auf `1` setzen, um Modellanfragen an Claude-Modelle auf Google Cloud (von Anthropic verwaltet) zu senden
`ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`	Ja, sofern Sie nicht `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` setzen	Ihre Workspace-ID
`ANTHROPIC_GOOGLE_CLOUD_PROJECT`	Empfohlen	Ihre Google-Cloud-Projekt-ID. Ohne sie verwendet Claude Code `GOOGLE_CLOUD_PROJECT`
`ANTHROPIC_GOOGLE_CLOUD_LOCATION`	Nein	Der Standort in der Anfrage-URL. Standardwert ist `global`
`ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	Nein	Ersetzt die Basis-URL, die Claude Code aus Projekt, Standort und Workspace-ID erstellt, zum Beispiel durch die Adresse eines LLM-Gateways. Claude Code hängt den API-Pfad an, etwa `/v1/messages`
`CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH`	Nein	Auf `1` setzen, wenn ein Gateway die Google-Anmeldedaten selbst anhängt, sodass Claude Code kein Google-Zugriffstoken sendet

Nicht verfügbare Funktionen von Claude Code

Mit Claude Models on Google Cloud (Anthropic managed) können Sie unter anderem die folgenden Funktionen nicht nutzen:

Fast-Modus: Sie können ihn weder mit /fast noch mit der Einstellung fastMode einschalten
Remote Control und Cloud-Sitzungen
MCP-Konnektoren von claude.ai
Channels
Die Befehle /design-sync und /import
Serververwaltete Einstellungen. Um Einstellungen für Ihr Team durchzusetzen, verwenden Sie stattdessen verwaltete Einstellungen auf jedem Rechner

Um weitere Funktionen zu sehen, die nicht verfügbar sind oder nur teilweise unterstützt werden, wählen Sie in der Übersicht zur Funktionsverfügbarkeit den Tab Google Cloud (Anthropic managed) aus.

Fehlerbehebung

Wenn Claude Code Sie zur Anmeldung auffordert oder die Zeile API provider in /status nicht on Google Cloud enthält:

Stellen Sie sicher, dass CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD auf 1 gesetzt ist
Stellen Sie sicher, dass claude --version 2.1.307 oder höher ausgibt
Entfernen Sie CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY und CLAUDE_CODE_USE_ANTHROPIC_AWS aus Ihrer Shell und Ihren Einstellungsdateien

CLAUDE_CODE_USE_VERTEX kann gesetzt bleiben. Nachdem Sie eine Variable geändert haben, starten Sie Claude Code neu. Wenn /status die Änderung nicht anzeigt, lesen Sie Ein von Ihnen gesetzter Wert wird ignoriert.

`No workspace ID found`

Setzen Sie ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID auf Ihre Workspace-ID und starten Sie Claude Code anschließend neu. Ignorieren Sie die in der Meldung erwähnte Konstruktoroption workspaceId: Sie ist für Personen gedacht, die das SDK von Anthropic aus ihrem eigenen Code aufrufen.

`No project was given`

Setzen Sie ANTHROPIC_GOOGLE_CLOUD_PROJECT auf Ihre Google-Cloud-Projekt-ID und starten Sie Claude Code anschließend neu.

`Could not load Google Cloud credentials`

Wiederholen Sie Schritt 1 von Claude Code einrichten, mit einem neuen Schlüssel, wenn Sie eine Dienstkonto-Schlüsseldatei verwenden.

`Google Cloud credentials expired or invalid`

Wenn die Meldung Sie auffordert, Ihre Google-Cloud-Anmeldedaten zu aktualisieren, wiederholen Sie Schritt 1 von Claude Code einrichten. Verwenden Sie bei einer Dienstkonto-Schlüsseldatei einen neuen Schlüssel.

`Google Cloud authentication failed`

Folgen Sie den Schritten für Google Cloud credentials expired or invalid. Wenn der Fehler dadurch nicht behoben wird:

Projekt: Stellen Sie in /status sicher, dass die Zeile GCP project Ihr Projekt nennt. Wenn sie ein anderes Projekt nennt oder es keine solche Zeile gibt, folgen Sie No project was given
Workspace: Stellen Sie in /status sicher, dass die Zeile Workspace ID Ihre Workspace-ID anzeigt. Wenn sie eine andere anzeigt, folgen Sie No workspace ID found
IAM-Rolle: Stellen Sie sicher, dass das Google-Konto oder Dienstkonto, das Claude Code ausführt, die Rolle roles/claude.user oder roles/claude.admin für das Projekt in der Zeile GCP project hat. Um die Rolle zuzuweisen, verwenden Sie den Befehl zur Rollenzuweisung des Dienstes oder bitten Sie einen Projekt-Admin, sie zuzuweisen
Dienst: Stellen Sie sicher, dass der Dienst claude.googleapis.com für das Projekt in der Zeile GCP project aktiviert ist. Um ihn zu aktivieren, folgen Sie den Schritten zur Kontoeinrichtung des Dienstes oder bitten Sie einen Projekt-Admin, ihn zu aktivieren

Claude-Modelle auf Google Cloud (von Anthropic verwaltet): Kontoeinrichtung, IAM-Rollen, Abrechnung, Datenaufbewahrung und Funktionsunterstützung
Übersicht zur Unternehmensbereitstellung: die anderen Möglichkeiten, Claude Code bereitzustellen, sowie die Einrichtung von Proxys und Gateways
Modellkonfiguration: Modellaliase, Festlegen einer Modellversion und Einschränken der Modelle, die Benutzer auswählen können

Einrichtung und Zugriff

Bereitstellung

Gateways

Nutzung und Kosten

Sicherheit und Daten

Einführung

Claude Code mit Claude-Modellen auf Google Cloud (von Anthropic verwaltet)

Voraussetzungen

Claude Code einrichten

Claude Code für ein Team einrichten

Modellversionen festlegen

Umgebungsvariablen

Nicht verfügbare Funktionen von Claude Code

Fehlerbehebung

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`

Voraussetzungen

Claude Code einrichten

Claude Code für ein Team einrichten

Modellversionen festlegen

Umgebungsvariablen

Nicht verfügbare Funktionen von Claude Code

Fehlerbehebung

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Weitere Ressourcen

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`