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 | bashApri 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>
opencodeIl comando fa tre cose:
- Aggiunge un provider
freellmapia~/.config/opencode/opencode.json. Il provider elenca i modelli del tuo catalogo attivo con i loro limiti di contesto. - Imposta
freellmapi/autocome 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
modeldi primo livello usa il formatoprovider/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 daGET /v1/models.
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.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 richieste/min 1 req/min per model | Sì | No |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 richieste/min 50 richieste/giorno Shared rate limit | Sì | No |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sì | 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_switchnel.envdi 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
| Problema | Causa | Soluzione |
|---|---|---|
| "Invalid API key" con una chiave valida | Un apiKey vuoto nella configurazione sostituisce la chiave di /connect | Rimuovi apiKey da options, oppure esegui di nuovo setup-opencode |
| OpenCode non usa il nuovo provider | Il model di primo livello non è impostato | Imposta "model": "freellmapi/auto" |
| Modello non trovato | L'ID del modello non è nella mappa models del provider | Aggiungi l'ID alla mappa, oppure esegui di nuovo setup-opencode |
La chiave {env:VAR} è vuota | OpenCode sostituisce una variabile non impostata con una stringa vuota | Esporta la variabile nella stessa shell, oppure salva la chiave con /connect |
| Le chiamate agli strumenti falliscono | Il modello ha un tool calling debole | Seleziona un modello dalla tabella sopra |
| «Tutti i modelli hanno raggiunto il limite dopo N tentativi» | Tutte le chiavi hanno raggiunto il limite | Aggiungi chiavi di più provider, oppure aspetta la fine dei periodi di attesa |
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
- Usi Aider con un'API LLM gratuita
- Usare Codex CLI con modelli gratuiti
- Come usare Claude Code gratis
- Migliori API gratuite per modelli di codice
- Base URL di API gratuite compatibili con OpenAI
Fonti
- OpenCode docs: providers (V1 config) (verificato il 20 November 2026)
- OpenCode docs: config (verificato il 20 November 2026)
- OpenCode docs: migrate from V1 (verificato il 20 November 2026)
- FreeLLMAPI CLI generators (verificato il 20 November 2026)
- FreeLLMAPI docs: context handoff (verificato il 20 November 2026)