# Claude Code mit OpenCheese

> Claude Code mit dem KI-Gateway OpenCheese: ANTHROPIC_BASE_URL, API-Schlüssel, Modell-Aliase opus, sonnet, haiku und fable, settings.json und Fehlerbehebung.
>
> Webseite: https://opencheese.dev/de/docs/claude-code/ · Alle Seiten der Doku: https://opencheese.dev/de/docs.md

Claude Code spricht die Anthropic-Messages-API, die OpenCheese unter
`https://api.opencheese.dev` bereitstellt. Richte es mit einem OpenCheese-API-Schlüssel darauf
aus, und es läuft mit den Modellen, die für dein Konto freigeschaltet sind.

## Der schnellste Weg: die generierte Datei

Melde dich an, öffne **Konfiguration**, wähle den Tab **Claude Code** mit ausgewähltem
**Claude Code (CLI)**, such dir einen API-Schlüssel aus und bestätige dein Passwort. Kopiere die
generierte `settings.json` und übernimm ihren `env`-Block in deine Benutzereinstellungen:

| System | Datei |
| --- | --- |
| macOS und Linux | `~/.claude/settings.json` |
| Windows | `%USERPROFILE%\.claude\settings.json` |

Die generierte Datei bindet die neuesten Claude-Modelle deines Tarifs an die Modell-Aliase von
Claude Code (`opus`, `sonnet`, `haiku` und `fable`), sodass `/model opus` und die anderen auf
Modelle zeigen, die du nutzen kannst. Eine Modellfamilie, die dein Tarif nicht enthält, fehlt in
der Datei.

## Manuelle Einrichtung

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.opencheese.dev",
    "ANTHROPIC_API_KEY": "YOUR_OPENCHEESE_API_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "OPUS_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "SONNET_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "HAIKU_MODEL_ID",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "FABLE_MODEL_ID"
  }
}
```

- `ANTHROPIC_BASE_URL` darf nicht auf `/v1` enden: Claude Code hängt `/v1/messages` selbst an.
- Die Modell-IDs liefert `GET /v1/models` mit deinem Schlüssel (siehe [Modelle](https://opencheese.dev/de/docs/models.md)).
- Führe die Schlüssel mit deiner bestehenden Datei zusammen, damit deine Berechtigungen, Hooks
  und MCP-Einstellungen erhalten bleiben.
- Trage das in deine Benutzereinstellungen ein. Eine `.claude/settings.json`, die in ein Repository
  committet wird, macht deinen API-Schlüssel für alle sichtbar, die Zugriff auf das Repository
  haben.

## Modell wechseln

Nutze in Claude Code `/model` mit einem Alias wie `opus`, `sonnet`, `haiku` oder `fable`; jeder
zeigt auf das Modell, das in deinen Einstellungen festgelegt ist. Claude Code lädt die
`settings.json` im laufenden Betrieb neu, liest die Alias-Zuordnung aber nur beim Start. Starte
es also neu, nachdem du einen Alias geändert hast.

Die Reasoning-Stufe, die du in Claude Code wählst, wird mit jeder Anfrage gesendet. Eine Stufe, die
das Modell nicht anbietet, wird mit einer Meldung abgelehnt, die die verfügbaren Stufen nennt.

## In VS Code, Cursor und JetBrains-IDEs

Die Claude-Code-Erweiterung für VS Code und Cursor sowie das JetBrains-Plugin nutzen dieselbe
`~/.claude/settings.json`, die Einrichtung oben gilt also auch für sie. Siehe
[VS Code und JetBrains](https://opencheese.dev/de/docs/ide.md).

## Claude Desktop

Im selben Tab **Claude Code** gibt es einen Schalter **Claude Desktop**. Claude Desktop erwartet
eine Datei, die du herunterlädst und in der App importierst; siehe
[Claude Desktop](https://opencheese.dev/de/docs/claude-desktop.md).

## Verbrauch und Kosten

Jede Anfrage erscheint im Dashboard unter **Transaktionen**, gruppiert als eine Sitzung pro
Unterhaltung, mit ihrem Tokenverbrauch und ihren Kosten.

## Fehlerbehebung

- **„Invalid or disabled OpenCheese API key“**: Der Schlüssel wurde widerrufen, deaktiviert oder
  unvollständig kopiert. Prüfe ihn auf der Seite **API-Schlüssel** und generiere die
  Konfiguration neu.
- **Statt der API antwortet die Website**: Die Basis-URL muss `https://api.opencheese.dev`
  lauten, nicht `https://opencheese.dev`.
- **Anfragen scheitern mit doppeltem Pfad**: Mit einer Basis-URL, die auf `/v1` endet, ruft
  Claude Code `/v1/v1/messages` auf. Entferne das `/v1`.
- **„Not included in your current plan“**: Das Modell gehört nicht zu deinem Tarif. Wähle ein
  anderes Modell oder lass auf der Seite **Übersicht** die Option **Guthaben-Modelle nutzen**
  eingeschaltet, um es aus deinem Guthaben zu bezahlen.