Guida alla configurazione di OpenCode

Panoramica

OpenCode legge i provider da una configurazione JSON. Aggiungi UnoRouter con l'adattatore compatibile con OpenAI per usare qualsiasi modello UnoRouter.

Configurazione rapida

Incolla questi valori nel client. La chiave si compila da sola quando hai effettuato l'accesso.

URL di base: https://api.unorouter.com/v1
Chiave API: YOUR_API_KEY

Compatibilità

Configurazione passo passo

1. 1
   Aprire il file di configurazione di OpenCode

   Apri la configurazione di OpenCode in un editor di testo. Crea il file se non esiste ancora.

   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

   Accedi per compilare automaticamente la tua chiave API

2. 2
   Sostituire il contenuto del file

   Aggiungi il blocco provider di UnoRouter alla configurazione. Uniscilo al file esistente mantenendo eventuali blocchi mcp o agent.

   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": {}
         }
       }
     }
   }

   Accedi per compilare automaticamente la tua chiave API

3. 3
   Verificare il caricamento dei modelli

   Salva il file ed esegui opencode models in un terminale. Ogni id elencato deve comparire, preceduto dalla tua chiave provider.

   bash

   opencode models

   Accedi per compilare automaticamente la tua chiave API

4. 4
   Scegliere un modello

   Apri il selettore dei modelli e passa al nuovo modello. L'adattatore gestisce lo streaming e le chiamate agli strumenti.

Modelli consigliati

Modelli gratuiti che funzionano qui. Incolla un qualsiasi id di modello nel client.

Cose da sapere

• !OpenCode non dispone di rilevamento dinamico dei modelli per i provider compatibili con OpenAI. Ogni modello desiderato va indicato nel blocco "models" con l'id esatto.
• !Non chiamare la chiave del provider semplicemente "unorouter". Quell'id esiste già nel registro models.dev e OpenCode userà quell'elenco invece del tuo, facendo mancare i modelli più recenti. Il suffisso "-live" sopra evita il conflitto.
• !Usa gli id esatti del catalogo UnoRouter. Rimuovi eventuali prefissi provider aggiunti da un copia e incolla e mantieni il suffisso :free dove l'id lo prevede.
• !Una chiave provider personalizzata senza blocco "models" carica zero modelli, quindi il provider sparisce del tutto dal selettore.