Usi Aider con un'API LLM gratuita
Aider è un programmatore in coppia open source per il terminale. Modifica i file nel Suo repository git e crea i commit. Questa guida collega Aider a modelli gratuiti tramite FreeLLMAPI. Mostra anche le impostazioni di Aider importanti per i modelli gratuiti: formato di modifica, modello debole e dimensione della repo map.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Passo 1: installi FreeLLMAPI
FreeLLMAPI è un gateway open source. Funziona sul Suo computer in Docker. Raccoglie i livelli gratuiti di 45 provider dietro una sola chiave compatibile con OpenAI.
Installazione su macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashApra http://localhost:3001. Aggiunga almeno due chiavi gratuite di provider nella pagina Keys. Copi la Sua chiave unificata dalla stessa pagina.
Passo 2: colleghi Aider
Il comando di configurazione scrive ~/.aider.conf.yml. Prima crea una copia di backup del file esistente.
Un solo comando
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderIl file scritto dal comando ha questo aspetto:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Il prefisso openai/ è obbligatorio. Dice ad Aider di inviare il nome del modello a un'API compatibile con OpenAI. Per usare le variabili d'ambiente e nessun file, proceda così:
Solo variabili d'ambiente
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider cerca .aider.conf.yml nella Sua cartella personale, poi nella radice del repository git e poi nella cartella corrente. Il file caricato per ultimo ha la precedenza. Un file di progetto può quindi cambiare il modello per un solo repository.
Passo 3: scelga i modelli
Aider invia i Suoi file e una repo map in ogni richiesta. Per il ciclo di modifica principale non richiede chiamate di strumenti, perché legge le modifiche dal testo del modello. Sono più importanti una grande finestra di contesto e una buona aderenza alle istruzioni. La tabella mostra oggi i modelli gratuiti con almeno 128K di contesto.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sì | No |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 altri | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Deepseek V4.1 Flash | APINex | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | No | No |
| 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 |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | No | No |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 altri | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
Mostrati 12 di 184 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.
Usi openai/auto per lasciare che il router scelga un modello. Usi openai/auto:smart per preferire i modelli con l'intelligenza più alta. Per fissare un modello, usi openai/ e un ID del catalogo da GET /v1/models.
Può impostare anche i modelli per una sessione dalla riga di comando. Questo esempio usa i modelli più forti per le modifiche. Usa modelli veloci per i messaggi di commit e i riassunti della cronologia della chat:
Modelli per una sessione
aider --model openai/auto:smart --weak-model openai/auto:fastPer un profilo pianificato, crei una catena di fallback nella dashboard di FreeLLMAPI, per esempio una catena chiamata coding. Poi usi --model openai/auto:coding. Un nome di profilo sconosciuto restituisce un errore 400, quindi la richiesta non va a una catena diversa senza preavviso.
Impostazioni di Aider per i modelli gratuiti
Aider conosce le impostazioni dei modelli noti. Un modello gateway come auto non è noto, quindi questi valori li imposta Lei.
| Impostazione | Che cosa fa | Valore consigliato per i modelli gratuiti |
|---|---|---|
edit-format | Il formato che il modello usa per inviare le modifiche: whole, diff, diff-fenced oppure udiff | diff per i modelli forti. whole per i modelli deboli, perché è più semplice ma invia più token. |
weak-model | Il modello per i messaggi di commit e i riassunti della cronologia della chat | openai/auto:fast, così i compiti piccoli non usano la quota del Suo modello forte |
map-tokens | Il numero di token per la repo map. 0 la disattiva. | 1024 o meno sui piccoli livelli gratuiti |
architect | Un modello pianifica la modifica e un modello editor scrive le modifiche | Facoltativo. Raddoppia il numero di richieste. |
~/.aider.conf.yml con impostazioni per i modelli gratuiti
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Per dare ad Aider la finestra di contesto di un modello gateway, aggiunga un file .aider.model.metadata.json. La chiave è il nome completo del modello. Aider cerca questo file negli stessi percorsi del file di configurazione.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Limiti di frequenza e failover
I livelli gratuiti hanno limiti al minuto e al giorno. FreeLLMAPI conta l'uso di ogni chiave. Quando un provider invia un errore 429, il router invia la richiesta al modello successivo della Sua catena. Aider non vede l'errore e continua.
- Aggiunga chiavi di quattro o più provider. Più provider danno più richieste al giorno.
- Aggiunga solo i file che vuole modificare con
/add. Ogni file è presente in ogni richiesta. - Usi
/cleartra un compito e l'altro per inviare una cronologia della chat più breve. Una cronologia breve abbassa anche i token al minuto. - Usi
/dropper rimuovere i file che non servono più.
Risoluzione dei problemi
| Problema | Causa | Soluzione |
|---|---|---|
| "Model openai/auto: Unknown context window size and costs, using sane defaults." (avviso in inglese di Aider) | Aider non conosce il modello gateway | Questo avviso di solito è innocuo. Per eliminarlo, aggiunga .aider.model.metadata.json. |
| La modifica non è stata applicata | Il modello non ha seguito il formato di modifica | Usi --edit-format whole, oppure un modello più forte |
401 "Invalid API key" (messaggio in inglese: chiave API non valida) | Aider invia una chiave diversa, per esempio da un altro file di configurazione | Controlli i file di configurazione nella cartella personale, nella radice git e nella cartella corrente |
| Aider chiama api.openai.com | Viene usato il prefisso openai/, ma il base URL non è impostato | Imposti openai-api-base oppure OPENAI_API_BASE |
| "All models rate-limited after N attempts" (messaggio in inglese: tutti i modelli hanno raggiunto il limite dopo N tentativi) | Tutte le chiavi sono al limite | Aggiunga chiavi di più provider, oppure riduca map-tokens |
Domande frequenti
Posso usare Aider gratuitamente?
Sì. Aider è open source. Lo indirizzi verso FreeLLMAPI con openai-api-base e il prefisso di modello openai/. Il gateway usa i livelli gratuiti dei provider, quindi l'inferenza costa 0 $.
Come uso Aider con un'API compatibile con OpenAI?
Imposti OPENAI_API_BASE e OPENAI_API_KEY, poi esegua aider --model openai/
Quale formato di modifica devo usare con i modelli gratuiti?
Usi diff per i modelli forti, perché invia meno token. Se le modifiche non si applicano, usi whole. È più semplice per i modelli deboli, ma invia ogni volta l'intero file.
Che cosa significa 'Unknown context window size and costs, using sane defaults'?
Aider non conosce il nome del modello, quindi usa valori predefiniti. L'avviso di solito è innocuo. Per eliminarlo, aggiunga .aider.model.metadata.json con la finestra di contesto.
Qual è il modello gratuito migliore per Aider?
Usi un modello con una grande finestra di contesto e una buona aderenza alle istruzioni. La tabella di questa pagina mostra oggi i modelli gratuiti più forti con 128K o più di contesto.
Guide correlate
- Usa OpenCode con un'API LLM gratuita
- Usare Codex CLI con modelli gratuiti
- Migliori API gratuite per modelli di codice
- Base URL di API gratuite compatibili con OpenAI
- API LLM gratuita con contesto da 1 milione di token
Fonti
- Aider docs: OpenAI-compatible APIs (verificato il 20 November 2026)
- Aider docs: YAML config file (verificato il 20 November 2026)
- Aider docs: options reference (verificato il 20 November 2026)
- Aider docs: edit formats (verificato il 20 November 2026)
- Aider docs: model warnings (verificato il 20 November 2026)
- Aider docs: advanced model settings (verificato il 20 November 2026)
- FreeLLMAPI CLI generators (verificato il 20 November 2026)