> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Konfigurieren Sie Claude Code für die Claude API, die Anthropic über Ihr Google-Cloud-Projekt betreibt, mit Google-Cloud-Anmeldedaten, IAM und Abrechnung über den Marketplace.

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.

> [!NOTE]
>
> 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](https://code.claude.com/docs/de/google-vertex-ai.md). Um herauszufinden, welches Angebot Sie nutzen, lesen Sie [Which offering are you using?](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/overview#which-offering-are-you-using)

Bevor Sie beginnen, [installieren Sie Claude Code](https://code.claude.com/docs/de/setup.md#install-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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) abgeschlossen ist
* Die [IAM-Rolle](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), die mit `wrkspc_` beginnt
* Die [gcloud CLI](https://cloud.google.com/sdk/docs/install), wenn Sie sich mit einem Google-Konto statt mit einer Dienstkonto-Schlüsseldatei anmelden

## Claude Code einrichten

**1. Application Default Credentials erstellen**

> [tab] Google-Konto
>
> 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:
>
> ```bash theme={null}
> 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.

> [tab] Dienstkonto-Schlüsseldatei
>
> Setzen Sie in der Shell oder dem CI-Job, der Claude Code ausführt, `GOOGLE_APPLICATION_CREDENTIALS` auf den Pfad einer [Dienstkonto-Schlüsseldatei](https://docs.cloud.google.com/iam/docs/keys-create-delete). Informationen zu anderen Quellen für Anmeldedaten finden Sie unter [Authentifizierung](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. Variablen zu Ihren Einstellungen hinzufügen**

Fügen Sie drei Variablen zum `env`-Block Ihrer [Benutzer-Einstellungsdatei](https://code.claude.com/docs/de/settings.md) `~/.claude/settings.json` hinzu. Wenn die Datei nicht existiert, erstellen Sie sie mit diesem Inhalt:

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-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.

**3. 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`](https://code.claude.com/docs/de/cli-reference) 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](#troubleshooting).

### Claude Code für ein Team einrichten

Legen Sie den `env`-Block aus Schritt 2 von [Claude Code einrichten](#set-up-claude-code) in einer Datei für [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) 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](https://code.claude.com/docs/de/model-config.md#pin-models-for-third-party-deployments), 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](#set-up-claude-code) enthält:

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/about-claude/models/overview).

## 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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) 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](https://code.claude.com/docs/de/llm-gateway). 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](https://code.claude.com/docs/de/fast-mode.md): Sie können ihn weder mit `/fast` noch mit der Einstellung `fastMode` einschalten
* [Remote Control](https://code.claude.com/docs/de/remote-control.md) und [Cloud-Sitzungen](https://code.claude.com/docs/de/claude-code-on-the-web.md)
* [MCP-Konnektoren von claude.ai](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai)
* [Channels](https://code.claude.com/docs/de/channels.md)
* Die [Befehle `/design-sync` und `/import`](https://code.claude.com/docs/de/commands#all-commands)
* [Serververwaltete Einstellungen](https://code.claude.com/docs/de/server-managed-settings.md). Um Einstellungen für Ihr Team durchzusetzen, verwenden Sie stattdessen [verwaltete Einstellungen](https://code.claude.com/docs/de/managed-settings.md) 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](https://code.claude.com/docs/de/feature-availability.md#summary-by-provider) 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](https://code.claude.com/docs/de/settings.md#find-or-create-your-settings-files)

`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](https://code.claude.com/docs/de/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Setzen Sie `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` auf Ihre [Workspace-ID](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-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](#set-up-claude-code), 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](#set-up-claude-code). 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`](#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`](#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`](#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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls) 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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) oder bitten Sie einen Projekt-Admin, ihn zu aktivieren

## Weitere Ressourcen

* [Claude-Modelle auf Google Cloud (von Anthropic verwaltet)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed): Kontoeinrichtung, IAM-Rollen, Abrechnung, Datenaufbewahrung und Funktionsunterstützung
* [Übersicht zur Unternehmensbereitstellung](https://code.claude.com/docs/de/third-party-integrations.md): die anderen Möglichkeiten, Claude Code bereitzustellen, sowie die Einrichtung von Proxys und Gateways
* [Modellkonfiguration](https://code.claude.com/docs/de/model-config.md): Modellaliase, Festlegen einer Modellversion und Einschränken der Modelle, die Benutzer auswählen können