Home / Guide / Cline, Roo Code e Kilo Code con un'API gratuita

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 | bash

Copia la tua chiave unificata dalla pagina Keys. Tutti e tre gli agenti usano gli stessi valori:

CampoValore
Base URLhttp://localhost:3001/v1
API key<unified-key>
Model IDauto, oppure un ID del catalogo da GET /v1/models
Stato di Roo Code: il README di Roo Code dice che l'estensione è stata chiusa il 15 maggio 2026. Il repository è archiviato e in sola lettura. I passaggi qui sotto valgono ancora per un'installazione esistente, ma i nuovi utenti dovrebbero scegliere Cline o Kilo Code.

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:

  1. Apri il pannello di Cline in VS Code. Clicca sull'icona delle impostazioni (ingranaggio).
  2. Imposta API Provider su OpenAI Compatible.
  3. Imposta Base URL su http://localhost:3001/v1.
  4. Imposta API Key sulla tua chiave unificata.
  5. Imposta Model ID su auto oppure su un modello dalla tabella qui sotto.
  6. 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.

Modelli gratuiti per Cline, Roo Code e Kilo Code: 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 auto per 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:smart per 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

ProblemaCausaSoluzione
"Invalid API Key"La chiave non è la tua chiave unificata di FreeLLMAPICopia di nuovo la chiave unificata dalla pagina Keys
"Model Not Found"L'ID del modello non è nel tuo catalogoUsa auto o un ID da GET /v1/models
L'agente si ferma dopo un passaggio, oppure le chiamate agli strumenti fallisconoIl modello ha un tool calling debole o assenteSeleziona un modello dalla tabella sopra
Errori di finestra di contesto nelle attività lungheL'impostazione del contesto è più grande del contesto reale del modelloImposta 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 limiteAggiungi chiavi di più provider, oppure aspetta la fine dei periodi di attesa
Kilo: Model not found: openai-compatible/autoIl modello predefinito non è nella mappa dei modelli del providerEsegui di nuovo setup-kilo, che mette per primo il modello predefinito
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 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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti