So verbindest du OpenCode mit CheapTokens (opencode.json)

Um OpenCode mit CheapTokens zu verbinden, füge einen benutzerdefinierten OpenAI-kompatiblen Provider hinzu: Speichere deinen API-Schlüssel mit /connect (Provider-ID cheaptokens) und beschreibe dann den Provider in opencode.json mit der Basis-URL https://api.cheaptokens.dev/v1. Danach erscheinen deine CheapTokens-Modelle in /models.

Diese Anleitung folgt der OpenCode-Provider-Dokumentation (Seite aktualisiert am 20. Oktober 2026; geprüft am 22. Oktober 2026). Derselbe Ansatz funktioniert für die anderen Tools in dieser Reihe: Cline, Aider und Kilo Code.

Was du brauchst#

• OpenCode installiert (siehe dessen Dokumentation für deine Plattform).
• Einen CheapTokens-API-Schlüssel. Erstelle einen in deinem Konto und lade das Guthaben auf; ein Guthaben deckt alle Modelle ab. Die Grundlagen stehen in der CheapTokens-Dokumentation.
• Die API-Fakten:
  • Basis-URL: https://api.cheaptokens.dev/v1
  • Kompatibilität: OpenAI Chat Completions und Anthropic Messages
  • unten verwendete Modell-ID: deepseek-ai/DeepSeek-V4-Flash-0731 (380K Kontext, bis zu 32.768 Ausgabe-Token). Modell-IDs sind in der CheapTokens-Dokumentation aufgeführt: Die Namen unterscheiden sich zwischen den Providern, also kopiere die ID von dort.

Schritt 1. Den Schlüssel mit /connect speichern#

1. Starte OpenCode in deinem Projekt und führe /connect aus.
2. Scrolle zu Other.
3. Gib eine eindeutige Provider-ID ein: cheaptokens.
4. Füge deinen CheapTokens-API-Schlüssel ein.

Dieser Schritt speichert nur die Anmeldedaten. OpenCode kennt noch nicht die Adresse oder die Modelle des Providers: dafür ist opencode.json da.

Schritt 2. Den Provider in opencode.json beschreiben#

Erstelle oder bearbeite opencode.json und füge den Provider hinzu. Die Provider-ID in provider muss mit der übereinstimmen, die du in /connect eingegeben hast.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Was die einzelnen Teile bewirken:

• npm — @ai-sdk/openai-compatible ist das Paket für Endpunkte, die /v1/chat/completions verwenden, was CheapTokens bereitstellt. (OpenCode verwendet @ai-sdk/openai für Endpunkte, die auf /v1/responses basieren.)
• name — die in der OpenCode-Oberfläche angezeigte Bezeichnung.
• options.baseURL — die CheapTokens-API-Adresse.
• models — nach Modell-ID verschlüsselt; das name darin ist ein Anzeigename.
• limit.context / limit.output — optional; sie teilen OpenCode das Kontextfenster und die maximale Antwortlänge des Modells mit.

Den Schlüssel stattdessen in einer Umgebungsvariable speichern (optional)#

Wenn du den Schlüssel nicht im Anmeldedatenspeicher von OpenCode behalten möchtest, füge apiKey zu options mit der {env:VARIABLE}-Syntax hinzu, die die Dokumentation empfiehlt:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Exportiere dann CHEAPTOKENS_API_KEY in deiner Shell. Committe keinen echten Schlüssel ins Repository. Wenn du neu bei Schlüsseln bist, lies was ein API-Schlüssel ist und wie man ihn sicher speichert.

Schritt 3. Prüfen, ob es funktioniert#

Führe /models aus und wähle DeepSeek-V4-Flash unter dem CheapTokens-Provider. Sende dann einen kurzen Prompt, zum Beispiel: "Fasse in drei Sätzen zusammen, was dieses Repository macht." Eine normale Antwort bedeutet, dass Basis-URL, Schlüssel und Modell-ID alle korrekt sind.

Welches CheapTokens-Modell du wählen solltest#

Füge so viele Einträge zu models hinzu, wie du möchtest — jeder ist ein Block wie der obige, mit seiner eigenen ID.

Für eine OpenCode-Sitzung, die viele Anfragen in einer Schleife sendet, ist DeepSeek-V4-Flash eine gute Standardwahl: Die Ausgabe ist günstiger als der OpenRouter-Referenzpreis, Antworten können 32.768 Token erreichen, und der Preis hat keine Spitzenzeiten. MiniMax-M2.7 ist ebenfalls günstiger als die OpenRouter-Referenzpreise bei Input und Output. Auch die Ausgabe von GLM-5.3-Flash ist günstiger als der OpenRouter-Referenzpreis. Aktuelle Preise (live geprüft, keine Zahlen, die veralten):

Um eine Arbeitssitzung zu schätzen, zum Beispiel 20 Anfragen mit jeweils 100.000 Input- und 5.000 Output-Token:

Siehe alle Preise und die DeepSeek-Seite für mehr.

Wenn es nicht funktioniert#

• Der Provider oder die Modelle fehlen in /models. Prüfe, ob opencode.json gültiges JSON ist (keine nachgestellten Kommas) und ob der Schlüssel unter provider genau die ID ist, die du in /connect eingegeben hast. Wenn beides korrekt ist, starte OpenCode neu.
• 401 / Authentifizierungsfehler. Führe /connect erneut aus und füge den Schlüssel erneut ein, oder prüfe die Variable CHEAPTOKENS_API_KEY in der Shell, in der OpenCode startet.
• 404 oder "model not found". Die Modell-ID in models muss Zeichen für Zeichen mit der CheapTokens-ID übereinstimmen, einschließlich des Anbieter-Präfixes (deepseek-ai/…).
• Verbindungsfehler. Die Basis-URL muss mit /v1 enden und darf keinen zusätzlichen Pfad enthalten. Siehe häufige Verbindungsfehler.
• "Not enough tokens". Lade das Guthaben auf; siehe was der Fehler bedeutet.

Nächste Schritte#

Du hast jetzt OpenCode mit CheapTokens am Laufen, mit einem Guthaben für alle Modelle. Hol dir einen Schlüssel und tätige deinen ersten Aufruf über die CheapTokens-Dokumentation.