OpenCode mit OpenCheese

← API-SchnellstartAls Markdown anzeigen

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:

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:

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

{
  "$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).

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.