OpenCode Einrichtungsleitfaden

Uberblick

OpenCode liest Provider aus einer JSON-Konfiguration. UnoRouter mit dem OpenAI-kompatiblen Adapter eintragen, um jedes Modell von UnoRouter zu nutzen.

Schnellkonfiguration

Diese Werte in den Client einfügen. Der Schlüssel wird bei angemeldeter Sitzung automatisch ausgefüllt.

Basis-URL: https://api.unorouter.com/v1
API-Schlüssel: YOUR_API_KEY

Kompatibilitat

Schritt-fur-Schritt-Einrichtung

1. 1
   Die OpenCode-Konfigurationsdatei öffnen

   In OpenCode Strg + O drücken und den Pfad einfügen. Unter Windows YOUR_USER durch den eigenen Benutzernamen ersetzen.

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

   Melde dich an, um deinen API-Key automatisch einzutragen

2. 2
   Den Dateiinhalt ersetzen

   Die Datei leeren und den Provider-Block von UnoRouter einfügen. Den eigenen API-Schlüssel ergänzen und ein Modell aus dem Katalog wählen.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

   Melde dich an, um deinen API-Key automatisch einzutragen

3. 3
   Speichern und neu laden

   Strg + S drücken, dann Strg + Umschalt + P und Developer: Reload Window ausführen.

4. 4
   Ein Modell wählen

   Die Modellauswahl öffnen und auf das neue Modell wechseln. Der Adapter übernimmt Streaming und Werkzeugaufrufe.

Empfohlene Modelle

Kostenlose Modelle, die hier funktionieren. Beliebige Modell-ID in den Client einfügen.

Stolperfallen

• !Mit "discoverModels": true lädt OpenCode beim Start den vollständigen Katalog von UnoRouter über /v1/models, sodass jedes Modell in der Auswahl erscheint, ohne es von Hand einzutragen.
• !Zeigt Developer: Reload Window den Provider nicht an, prüfen, ob das JSON ohne nachgestellte Kommas gespeichert wurde.
• !Exakte Modell-IDs aus dem Katalog von UnoRouter nutzen. Ein durch Kopieren entstandenes vorangestelltes Provider-Präfix entfernen.
• !Ohne automatische Erkennung braucht älteres OpenCode einen "models"-Block mit exakten IDs (z. B. {"gemini-3.1-flash-lite": {}}) und einen Neustart.