# OpenCode mit OpenCheese

> OpenCheese in OpenCode: Auto-Sync per persönlichem Link, die generierte opencode.json, manuelle Einrichtung, Modellvarianten, OpenCode 2 und Fehlerbehebung.
>
> Webseite: https://opencheese.dev/de/docs/opencode/ · Alle Seiten der Doku: https://opencheese.dev/de/docs.md

OpenCode bindet OpenCheese als OpenAI-kompatiblen Anbieter unter `https://api.opencheese.dev/v1`
an. OpenCode 1.x und 2.x lesen dieselbe Konfiguration.

## Empfohlen: Auto-Sync

Mit Auto-Sync lädt OpenCode seine OpenCheese-Einstellungen selbst herunter: Modelle, die du auf der
Seite **Preise** ein- oder ausschaltest, und neue Modelle kommen an, ohne dass du eine Datei
kopieren musst.

1. Melde dich an, öffne **Konfiguration**, wähle den Tab **OpenCode** und geh zu den
   Auto-Sync-Schritten.
2. Wähle den API-Schlüssel, den OpenCode verwenden soll, gib das Passwort dieses Schlüssels ein und
   erstelle deinen persönlichen Link.
3. Führe den einen Befehl, den die Seite anzeigt, einmal in einem Terminal aus:

```bash
opencode auth login https://opencheese.dev/c/YOUR_PERSONAL_LINK
```

OpenCode speichert den Schlüssel und lädt seine Konfiguration ab dann von OpenCheese. Die Anmeldung
führt einen kleinen Node.js-Befehl aus, deshalb muss Node.js 18 oder neuer in deinem `PATH` liegen
(das ist der Fall, wenn du OpenCode mit npm installiert hast).

- **Aktualisierungen:** OpenCode 2 übernimmt Änderungen innerhalb von 10 Minuten oder sofort mit
  `opencode reload` (am besten im Leerlauf). OpenCode 1 übernimmt sie beim Start und kann nur
  starten, solange OpenCheese erreichbar ist.
- **Deine eigenen Einstellungen:** Behalte eine kleine `opencode.json`, die nur deine eigenen
  Einstellungen enthält, etwa einen Abschnitt `mcp`. Führe darin keine Modelle auf: Dort
  aufgeführte Modelle bleiben sichtbar, auch nachdem du sie ausgeschaltet hast. Lösche oder kürze
  eine `opencode.json`, die du früher kopiert hast.
- **Der Link ist ein Passwort:** Wer ihn hat, kann den Schlüssel verwenden. Er wird nur einmal
  angezeigt. Widerrufe ihn unter **Deine persönlichen Links**; ein bereits angemeldetes OpenCode
  behält den Schlüssel, deaktiviere oder lösche also den API-Schlüssel, um es zu stoppen. Hast du
  das Passwort des Schlüssels geändert, führe die Anmeldung erneut aus.

## Oder die generierte Datei kopieren

Melde dich an, öffne **Konfiguration**, wähle den Tab **OpenCode**, such dir einen API-Schlüssel aus
und bestätige dein Passwort. Führe dann die generierte Datei mit deiner Benutzerkonfiguration
zusammen:

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

Die generierte Datei enthält jedes Textmodell, das dein Schlüssel nutzen kann, mit Anzeigenamen,
Kontext- und Ausgabelimits, Kosten pro Token (OpenCode zeigt die Kosten jeder Nachricht),
Reasoning-Varianten und dem passenden AI-SDK-Paket für jedes Modell. Zieh sie einer selbst
geschriebenen vor und kopiere sie erneut, wenn sich dein Tarif oder deine Modellliste ändert.

## Manuelle Einrichtung mit einem Modell

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "opencheese": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenCheese",
      "options": {
        "baseURL": "https://api.opencheese.dev/v1",
        "apiKey": "{env:OPENCHEESE_API_KEY}"
      },
      "models": {
        "MODEL_ID": { "name": "Model name", "variants": {} }
      }
    }
  },
  "model": "opencheese/MODEL_ID"
}
```

- `baseURL` muss auf `/v1` enden.
- `{env:OPENCHEESE_API_KEY}` liest den Schlüssel aus deiner Umgebung; die generierte Datei enthält
  den Schlüssel selbst.
- Behalte `"variants": {}` bei jedem Modell, das du von Hand hinzufügst. Ohne das bietet OpenCode
  2.x eigene Reasoning-Varianten low, medium und high an, die ein Modell womöglich nicht unterstützt.
- Die Modell-IDs liefert `GET /v1/models` mit deinem Schlüssel (siehe [Modelle](https://opencheese.dev/de/docs/models.md)).

## OpenCode 2

OpenCode 2 ist die empfohlene Version. Schritt 2 im Tab **OpenCode** schaltet zwischen OpenCode 2
(Standard) und OpenCode 1 um, das veraltet ist und bis zum 1. November unterstützt wird; beide
lesen dieselben Einstellungen. Kommst du von OpenCode 1: OpenCode 2 ist ein anderes Paket und
überträgt beim ersten Start deinen Sitzungsverlauf, sichere diesen Verlauf also vorher. Der Tab
zeigt die genauen Befehle, einschließlich des Wegs zurück zu OpenCode 1.

## 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“**: Prüfe den Schlüssel auf der Seite **API-Schlüssel**
  und ob `OPENCHEESE_API_KEY` dort gesetzt ist, wo OpenCode startet. Nutzt du Auto-Sync, führe die
  Anmeldung erneut aus.
- **Ein Modell fehlt**: Welche Modelle du siehst, hängt von deinem Tarif und den Einschränkungen des
  Schlüssels ab. Nutzt du Auto-Sync, starte OpenCode 1 neu oder führe in OpenCode 2
  `opencode reload` aus; nutzt du eine kopierte Datei, kopiere sie erneut.
- **Ein ausgeschaltetes Modell wird noch angezeigt**: Ein Modell, das in deiner lokalen
  `opencode.json` steht, bleibt sichtbar; entferne es dort.
- **„Not included in your current plan“**: Wähle ein anderes Modell oder lass auf der Seite
  **Übersicht** die Option **Guthaben-Modelle nutzen** eingeschaltet, um es aus deinem Guthaben zu
  bezahlen.