Home / Guide / Usi Aider con un'API LLM gratuita

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

Apra 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>
aider

Il 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/auto

Aider 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.

Modelli gratuiti per Aider: contesto 128K+, per intelligenza
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3APINex, UnoRouter1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SìNo
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 altri1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashAPINex, Google AI Studio1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SìSì
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Deepseek V4.1 FlashAPINex1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NoNo
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
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetNoNo
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 altri262K30 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:fast

Per 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.

ImpostazioneChe cosa faValore consigliato per i modelli gratuiti
edit-formatIl formato che il modello usa per inviare le modifiche: whole, diff, diff-fenced oppure udiffdiff per i modelli forti. whole per i modelli deboli, perché è più semplice ma invia più token.
weak-modelIl modello per i messaggi di commit e i riassunti della cronologia della chatopenai/auto:fast, così i compiti piccoli non usano la quota del Suo modello forte
map-tokensIl numero di token per la repo map. 0 la disattiva.1024 o meno sui piccoli livelli gratuiti
architectUn modello pianifica la modifica e un modello editor scrive le modificheFacoltativo. 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: 1024

Per 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 /clear tra un compito e l'altro per inviare una cronologia della chat più breve. Una cronologia breve abbassa anche i token al minuto.
  • Usi /drop per rimuovere i file che non servono più.

Risoluzione dei problemi

ProblemaCausaSoluzione
"Model openai/auto: Unknown context window size and costs, using sane defaults." (avviso in inglese di Aider)Aider non conosce il modello gatewayQuesto avviso di solito è innocuo. Per eliminarlo, aggiunga .aider.model.metadata.json.
La modifica non è stata applicataIl modello non ha seguito il formato di modificaUsi --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 configurazioneControlli i file di configurazione nella cartella personale, nella radice git e nella cartella corrente
Aider chiama api.openai.comViene usato il prefisso openai/, ma il base URL non è impostatoImposti 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 limiteAggiunga chiavi di più provider, oppure riduca map-tokens
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 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/. Il prefisso openai/ è obbligatorio. Può inserire gli stessi valori in .aider.conf.yml.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti