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

   Öffne deine OpenCode-Konfiguration in einem Texteditor. Lege die Datei an, falls sie noch nicht existiert.

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   Melde dich an, um deinen API-Key automatisch einzutragen

2. 2
   Den Dateiinhalt ersetzen

   Füge den UnoRouter-Provider-Block zu deiner Konfiguration hinzu. Füge ihn in die bestehende Datei ein und behalte vorhandene mcp- oder agent-Blöcke bei.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter-live": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         },
         "models": {
           "ling-3.1-flash:free": {},
           "agnes-3.0-flash:free": {},
           "minicpm5-2b:free": {},
           "k2-horizon:free": {},
           "qwen3.8-flash-next:free": {}
         }
       }
     }
   }

   Melde dich an, um deinen API-Key automatisch einzutragen

3. 3
   Laden der Modelle prüfen

   Speichere die Datei und führe im Terminal opencode models aus. Jede aufgeführte ID sollte erscheinen, mit deinem Provider-Schlüssel als Präfix.

   bash

   opencode models

   Melde dich an, um deinen API-Key automatisch einzutragen

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

• !OpenCode besitzt keine Live-Modellerkennung für OpenAI-kompatible Provider. Jedes gewünschte Modell muss mit exakter ID im "models"-Block stehen.
• !Benenne den Provider-Schlüssel nicht einfach "unorouter". Diese ID existiert bereits in der models.dev-Registry, und OpenCode verwendet dann deren Liste statt deiner, wodurch neuere Modelle fehlen. Das Suffix "-live" oben vermeidet die Kollision.
• !Verwende exakte Modell-IDs aus dem UnoRouter-Katalog. Entferne ein beim Kopieren entstandenes Provider-Präfix und behalte das Suffix :free, wo die ID es hat.
• !Ein eigener Provider-Schlüssel ohne "models"-Block lädt null Modelle, wodurch der Provider vollständig aus der Auswahl verschwindet.