Zum Hauptinhalt springen

Claude Code mit OpenCheese

/ API-Doku

← API-SchnellstartAls Markdown anzeigen

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).
  • 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.

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.

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.
Der Käse hat Löcher. Deine Infrastruktur sollte keine haben.