Cline, Roo Code e Kilo Code con un'API gratuita
Cline, Roo Code e Kilo Code sono agenti di programmazione per VS Code. Ognuno può usare un'API compatibile con OpenAI. Questa guida li collega a modelli gratuiti tramite FreeLLMAPI. Mostra anche quali modelli gratuiti gestiscono i prompt lunghi e ricchi di strumenti che questi agenti inviano.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Prima di iniziare
FreeLLMAPI è un gateway open source che gira sul tuo computer. Raggruppa i piani gratuiti di 45 provider dietro una sola chiave. Installalo in Docker, poi aggiungi almeno due chiavi di provider gratuiti nella pagina Keys.
Installa su macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopia la tua chiave unificata dalla pagina Keys. Tutti e tre gli agenti usano gli stessi valori:
| Campo | Valore |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto, oppure un ID del catalogo da GET /v1/models |
Cline
Il metodo più rapido è il comando di configurazione. Legge il tuo catalogo attivo, crea una copia di backup delle impostazioni Cline esistenti e aggiunge un provider OpenAI Compatible.
Un comando
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>La prima riga mostra le differenze e non scrive nulla. La seconda riga scrive la modifica. Per configurare Cline a mano, segui questi passaggi:
- Apri il pannello di Cline in VS Code. Clicca sull'icona delle impostazioni (ingranaggio).
- Imposta API Provider su OpenAI Compatible.
- Imposta Base URL su
http://localhost:3001/v1. - Imposta API Key sulla tua chiave unificata.
- Imposta Model ID su
autooppure su un modello dalla tabella qui sotto. - Apri Model Configuration. Imposta Context Window sul contesto del tuo modello. Attiva Image Support solo per un modello con visione.
Cline mostra questa nota per i provider OpenAI Compatible: «Cline usa prompt complessi, quindi il comportamento può variare tra i modelli». Per i modelli più piccoli, la documentazione di Cline consiglia di attivare Use Compact Prompt in Cline Settings, Features.
Kilo Code
Esegui il comando di configurazione. Scrive una configurazione globale di Kilo con un provider openai-compatible e lo imposta come modello predefinito.
Un comando
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"La configurazione fa riferimento alla chiave come {env:FREELLMAPI_API_KEY}, quindi esporta la variabile prima di avviare Kilo. Kilo espande {env:...} solo nelle configurazioni attendibili, per esempio nella cartella globale ~/.config/kilo. In una configurazione di progetto, Kilo la ignora e registra un avviso. La configurazione generata ha questa struttura:
Configurazione globale di Kilo (struttura)
{
"$schema": "https://app.kilo.ai/config.json",
"model": "openai-compatible/auto",
"provider": {
"openai-compatible": {
"options": {
"apiKey": "{env:FREELLMAPI_API_KEY}",
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"tool_call": true,
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Nell'estensione per VS Code puoi anche aggiungere il provider a mano. Apri Settings, poi la scheda Providers, e clicca su Custom provider. Imposta Provider API su OpenAI Compatible. Inserisci la base URL e la chiave, poi clicca su Fetch models per leggere l'elenco dei modelli.
Roo Code (installazioni esistenti)
Il comando di configurazione scrive un file di importazione per l'estensione VS Code. Scrive anche un profilo per la CLI di Roo.
Un comando
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>Poi indica a Roo Code di caricare il file di importazione. Aggiungi questa riga al tuo settings.json di VS Code e ricarica la finestra. Il profilo freellmapi diventa il profilo attivo.
settings.json di VS Code
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"Per configurarlo a mano, apri le impostazioni di Roo Code e imposta API Provider su OpenAI Compatible. Inserisci la base URL, la chiave e il modello. Roo Code usa solo il tool calling nativo. La sua documentazione dice che un modello senza tool calling nativo non può essere usato con Roo Code.
Scegli i modelli per il lavoro con gli agenti
Questi agenti inviano in ogni richiesta un grande prompt di sistema, le definizioni degli strumenti e il contenuto dei file. Usa modelli con tool calling e una finestra di contesto ampia. La tabella mostra oggi i modelli gratuiti con tool calling e almeno 128K di contesto, in ordine di intelligenza.
| 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
autoper lasciare che il router scelga un modello per ogni richiesta. Quando un provider invia un errore 429, il router prova il modello successivo. - Usa
auto:smartper la pianificazione e per i bug difficili. - Imposta la finestra di contesto nell'agente sul contesto reale del modello. Se il valore è troppo alto, l'agente invia prompt che il modello rifiuta.
- Avvia una nuova attività quando il contesto diventa grande. Un contesto più piccolo usa meno token per richiesta.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| "Invalid API Key" | La chiave non è la tua chiave unificata di FreeLLMAPI | Copia di nuovo la chiave unificata dalla pagina Keys |
| "Model Not Found" | L'ID del modello non è nel tuo catalogo | Usa auto o un ID da GET /v1/models |
| L'agente si ferma dopo un passaggio, oppure le chiamate agli strumenti falliscono | Il modello ha un tool calling debole o assente | Seleziona un modello dalla tabella sopra |
| Errori di finestra di contesto nelle attività lunghe | L'impostazione del contesto è più grande del contesto reale del modello | Imposta la finestra di contesto corretta, oppure avvia una nuova attività |
| «Tutti i modelli hanno raggiunto il limite dopo N tentativi» | Ogni chiave della catena ha raggiunto il limite | Aggiungi chiavi di più provider, oppure aspetta la fine dei periodi di attesa |
Kilo: Model not found: openai-compatible/auto | Il modello predefinito non è nella mappa dei modelli del provider | Esegui di nuovo setup-kilo, che mette per primo il modello predefinito |
Domande frequenti
Posso usare Cline gratuitamente?
Sì. Cline è gratuito e open source. Imposta il suo API provider su OpenAI Compatible e indicagli FreeLLMAPI. Il gateway invia ogni richiesta ai piani gratuiti dei provider, quindi l'inferenza costa 0 dollari.
Qual è il modello gratuito migliore per Cline?
Usa un modello con tool calling e almeno 128K di contesto. Cline invia prompt complessi con definizioni di strumenti. La tabella di questa pagina mostra oggi i modelli gratuiti più forti che rispettano entrambe le regole.
Roo Code è ancora mantenuto?
No. Il README di Roo Code dice che l'estensione è stata chiusa il 15 maggio 2026, e il repository è archiviato. Le installazioni esistenti funzionano ancora con un provider OpenAI Compatible.
Come uso Kilo Code con un'API personalizzata compatibile con OpenAI?
Aggiungi un provider openai-compatible con un baseURL e un apiKey nella configurazione globale di Kilo, oppure esegui npx freellmapi setup-kilo. Nell'estensione per VS Code, usa Settings, Providers, Custom provider.
Perché Cline fallisce con i modelli gratuiti?
La maggior parte dei problemi deriva da modelli con tool calling debole o da una finestra di contesto piccola. Seleziona un modello con tool calling e 128K di contesto, e attiva Use Compact Prompt per i modelli più piccoli.
Guide correlate
- AI gratuite in VS Code
- Continue con un'API LLM gratuita
- Migliori API gratuite per modelli di codice
- API LLM gratuita con function calling
- Come usare Claude Code gratis
Fonti
- Cline docs: OpenAI Compatible provider (verificato il 20 November 2026)
- Cline docs: running models locally (verificato il 20 November 2026)
- Kilo docs: custom models (verificato il 20 November 2026)
- Kilo docs: OpenAI Compatible provider (verificato il 20 November 2026)
- Roo Code repository (archived) (verificato il 20 November 2026)
- Roo Code docs: settings management (verificato il 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (verificato il 20 November 2026)