OpenCode

OpenCode è un agente di programmazione open source per il terminale. Basta un comando per collegarlo a Synthorai: OpenCode riceve una propria chiave API e un provider Synthorai con i modelli che quella chiave può chiamare. Nessuna chiave da copiare, nessun file di configurazione da modificare.

Passo 1 - Accedi

opencode auth login https://synthorai.io

OpenCode legge https://synthorai.io/.well-known/opencode ed esegue il comando di accesso indicato lì. Il comando stampa un link e un codice di 8 lettere, per esempio BCDF-GHJK, e apre il browser.

Accedi alla console, controlla che il codice sulla pagina sia uguale a quello nel terminale, scegli la durata della chiave (7, 30 o 90 giorni; il valore predefinito è 90) e fai clic su Consenti. Il terminale stampa Signed in e OpenCode salva la nuova chiave.

Via SSH il comando non apre il browser: apri il link su un altro dispositivo e accedi da lì. Per ottenere lo stesso comportamento anche sulla tua macchina, imposta SYNTHORAI_NO_BROWSER=1.

Passo 2 - Scegli un modello

opencode
# then, inside OpenCode:
/models

Avvia OpenCode e digita /models. Il provider Synthorai elenca i modelli che la tua chiave può chiamare, con limite di contesto e prezzo. OpenCode aggiorna l'elenco a ogni avvio.

Ogni modello viene chiamato con il protocollo adatto, senza nulla da impostare: i modelli Claude usano l'API Messages di Anthropic (il prompt caching resta attivo), i modelli OpenAI l'API Responses e tutti gli altri Chat Completions.

La chiave usata da OpenCode

La chiave compare nella pagina Chiavi API della console come OpenCode · …, seguito dal luogo da cui hai effettuato l'accesso, con l'etichetta Accesso agente. Puoi eliminarla da lì in qualsiasi momento.

Quando la chiave scade, le chiamate falliscono con un messaggio che ti chiede di eseguire di nuovo opencode auth login https://synthorai.io.

Sicurezza

• Approva solo un codice che hai avviato tu. Se la richiesta di accesso arriva da una rete diversa da quella del tuo browser, la pagina di conferma te lo segnala.
• Se nel workspace è attivo Approvazione dei nuovi IP (Impostazioni › Sicurezza), l’indirizzo da cui hai effettuato l’accesso diventa automaticamente un indirizzo attendibile della nuova chiave quando consenti l’accesso dalla stessa rete, e le chiamate da qualsiasi altro indirizzo attendono l’approvazione. Se lo consenti da un’altra rete, l’indirizzo non diventa attendibile: approvalo quando la sua prima chiamata viene trattenuta. Se l’opzione è disattivata, valuta di attivarla.

Vince la configurazione locale

Se il tuo opencode.json locale definisce un provider chiamato synthorai, OpenCode usa quello al posto del provider fornito dal gateway, perché la configurazione locale ha la precedenza su quella remota.

Configurazione manuale (Windows senza sh)

Crea una chiave nella pagina Chiavi API della console, mettila nella variabile d'ambiente SYNTHORAI_API_KEY e aggiungi questo provider a opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "synthorai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Synthorai",
      "options": {
        "baseURL": "https://synthorai.io/v1",
        "apiKey": "{env:SYNTHORAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }
      }
    }
  }
}

Elenca sotto models ogni modello che vuoi poter scegliere in OpenCode. Gli ID sono nella pagina dei modelli.

Risoluzione dei problemi

Failed to load auth provider metadata Controlla l'indirizzo: è https://synthorai.io, senza alcun percorso dopo.

Sign-in did not complete: the login was declined in the console La richiesta è stata rifiutata nella pagina di conferma. Esegui di nuovo il comando per ricominciare.

Il codice è scaduto I codici valgono 10 minuti. Esegui di nuovo opencode auth login https://synthorai.io per riceverne uno nuovo.

Per limiti, scadenza ed eliminazione delle chiavi, vedi API key.