Home / Guide / Usa OpenCode con un'API LLM gratuita

Usa OpenCode con un'API LLM gratuita

OpenCode è un agente di programmazione open source per il terminale e per il desktop. Accetta qualsiasi provider compatibile con OpenAI. Questa guida collega OpenCode a modelli gratuiti tramite FreeLLMAPI. Un comando scrive la configurazione e salva la chiave.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

Passo 1: Installa FreeLLMAPI

FreeLLMAPI è un gateway open source. Gira sul tuo computer in Docker e raggruppa i piani gratuiti di 45 provider dietro una sola chiave.

Installa su macOS o Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Apri http://localhost:3001. Aggiungi almeno due chiavi di provider gratuiti nella pagina Keys. Google AI Studio e Groq offrono ciascuno una chiave gratuita in pochi minuti. Copia la tua chiave unificata dalla stessa pagina.

Passo 2: Collega OpenCode con un comando

Un comando

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

Il comando fa tre cose:

  • Aggiunge un provider freellmapi a ~/.config/opencode/opencode.json. Il provider elenca i modelli del tuo catalogo attivo con i loro limiti di contesto.
  • Imposta freellmapi/auto come modello predefinito.
  • Salva la chiave nel file delle credenziali di OpenCode, ~/.local/share/opencode/auth.json. Non serve una variabile d'ambiente, né nella CLI né nell'app desktop.

Il comando crea una copia di backup prima di scrivere. Unisce il nuovo provider, quindi gli altri provider restano. Se sono impostate XDG_CONFIG_HOME o XDG_DATA_HOME, il comando usa quelle cartelle.

Prima di avviare un'attività lunga, verifica che il gateway possa servire una richiesta adesso. Questa chiamata elenca solo i modelli che hanno una chiave utilizzabile in questo momento:

Verifica quali modelli sono pronti

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Un modello con lo stato exhausted ha delle chiavi, ma tutte hanno raggiunto un limite in questo momento. Questo stato scompare quando finiscono i periodi di attesa. Esegui npx freellmapi doctor per verificare che le richieste di un client raggiungano il gateway. Il log delle richieste della dashboard mostra ogni chiamata di OpenCode. L'header di risposta X-Routed-Via indica il provider e il modello che hanno risposto a ogni richiesta. Se una richiesta è passata a un altro modello, l'header X-Fallback-Trail indica ogni passaggio fallito e il motivo.

Configurazione manuale: il blocco provider di opencode.json

Per configurarlo a mano, aggiungi questo blocco a ~/.config/opencode/opencode.json, oppure a opencode.json nel tuo progetto. OpenCode usa @ai-sdk/openai-compatible per gli endpoint /v1/chat/completions.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Poi aggiungi la chiave. Avvia OpenCode, esegui /connect, seleziona il provider freellmapi e incolla la tua chiave unificata. L'ID del provider in /connect deve corrispondere all'ID nella configurazione. Esegui /models per selezionare un modello.

  • limit.context è il numero massimo di token di input del modello. limit.output è il numero massimo di token che può generare.
  • Il model di primo livello usa il formato provider/model. Senza di esso, OpenCode mantiene il modello usato in precedenza.
  • Ogni ID di modello che vuoi usare deve essere nella mappa models. Aggiungi altri ID da GET /v1/models.
Nota sulle versioni della configurazione: la documentazione di OpenCode ora descrive un formato di configurazione V2 con una chiave providers. La documentazione dice che il formato V1 qui sopra resta supportato. Il comando di configurazione di FreeLLMAPI scrive il formato V1.

Scegli i modelli per OpenCode

OpenCode è un agente. Legge i file, li modifica ed esegue comandi tramite chiamate agli strumenti. Ogni richiesta contiene un prompt di sistema, le definizioni degli strumenti e il contenuto dei file. Usa modelli con tool calling e una finestra di contesto ampia.

Modelli gratuiti per OpenCode: tool calling e contesto da 128K o più
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySìSì

Mostrati 12 di 109 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Usa freellmapi/auto per lasciare che il router scelga un modello per ogni richiesta. Aggiungi auto:smart o auto:fast alla mappa models per orientare le richieste verso intelligenza o velocità. Puoi anche aggiungere un profilo con nome, per esempio auto:coding, dopo averlo creato nella dashboard.

Limiti di frequenza e sessioni lunghe

Una sola attività dell'agente può inviare decine di richieste. Un singolo piano gratuito si esaurisce in fretta in un'attività lunga. FreeLLMAPI conta le richieste e i token di ogni chiave. Quando un provider invia un errore 429, il router invia la richiesta al modello successivo della catena, e la sessione continua.

  • Aggiungi chiavi di quattro o più provider. Più provider danno più richieste al giorno.
  • Attiva il passaggio di contesto con FREELLMAPI_CONTEXT_HANDOFF=on_model_switch nel .env di FreeLLMAPI. Quando il modello cambia, il modello successivo riceve una breve nota che lo informa di continuare un'attività.
  • Le sessioni persistenti mantengono una conversazione su un solo modello per 30 minuti. Così l'agente resta coerente.
  • Avvia una nuova sessione per ogni attività. Un contesto più piccolo usa meno token per richiesta.

Risoluzione dei problemi

ProblemaCausaSoluzione
"Invalid API key" con una chiave validaUn apiKey vuoto nella configurazione sostituisce la chiave di /connectRimuovi apiKey da options, oppure esegui di nuovo setup-opencode
OpenCode non usa il nuovo providerIl model di primo livello non è impostatoImposta "model": "freellmapi/auto"
Modello non trovatoL'ID del modello non è nella mappa models del providerAggiungi l'ID alla mappa, oppure esegui di nuovo setup-opencode
La chiave {env:VAR} è vuotaOpenCode sostituisce una variabile non impostata con una stringa vuotaEsporta la variabile nella stessa shell, oppure salva la chiave con /connect
Le chiamate agli strumenti fallisconoIl modello ha un tool calling deboleSeleziona un modello dalla tabella sopra
«Tutti i modelli hanno raggiunto il limite dopo N tentativi»Tutte le chiavi hanno raggiunto il limiteAggiungi chiavi di più provider, oppure aspetta la fine dei periodi di attesa
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Posso usare OpenCode gratuitamente?

Sì. OpenCode è open source. Collegalo a FreeLLMAPI come provider compatibile con OpenAI. Il gateway invia ogni richiesta ai piani gratuiti dei provider, quindi l'inferenza costa 0 dollari.

Come aggiungo a OpenCode un provider personalizzato compatibile con OpenAI?

Aggiungi a opencode.json un provider con npm impostato su @ai-sdk/openai-compatible, options.baseURL e una mappa models. Poi esegui /connect per salvare la chiave e /models per selezionare un modello.

Qual è il modello gratuito migliore per OpenCode?

Usa un modello con tool calling e almeno 128K di contesto. La tabella di questa pagina mostra oggi i modelli gratuiti più forti che rispettano entrambe le regole. Usa freellmapi/auto per lasciare che il router ne scelga uno.

Dove salva OpenCode le chiavi API?

Le chiavi aggiunte con /connect vanno in ~/.local/share/opencode/auth.json. Il comando di configurazione di FreeLLMAPI scrive la chiave lì, così la CLI e l'app desktop la trovano entrambe.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti