Aider + Ollama: programmare nel terminale con un agente al 100% locale

#Perché usare Aider nel terminale

Mentre Cline e Continue operano in VS Code, Aider sceglie il terminale. Rimani nella tua shell, alla radice del tuo repository git, e dialoghi con il modello come con un collega che abbia accesso al codice. È un flusso di lavoro diverso, più vicino alla riga di comando, che piace a chi vive in tmux e non ama staccare le mani dalla tastiera.

Centrato su git

Ogni modifica accettata diventa un commit pulito, con un messaggio scritto da Aider. La tua cronologia rimane leggibile e puoi annullare qualsiasi cambiamento con un semplice git revert.

Mappatura automatica del repository

Aider costruisce una mappa del tuo repository (firme delle funzioni, classi, struttura) che invia al modello oltre ai file aperti. Il modello comprende il contesto senza che tu debba caricare l'intero progetto.

Indipendente dall'editor

Aider modifica i file su disco. Continui a usare il tuo editor abituale in parallelo: Aider vede le tue modifiche, tu vedi le sue.

100 % locale con Ollama

Collegato a Ollama, il modello gira sulla tua GPU. Il tuo codice e i tuoi prompt non lasciano mai il computer, il che cambia tutto per il codice proprietario o coperto da un NDA.

#Prerequisiti e installazione

Tre componenti: Python per Aider, Ollama in esecuzione con un modello di programmazione caricato e un repository git. Aider richiede un repository git per funzionare pienamente — è Aider a gestire i commit.

1. 01
   Verifica Ollama

   Ollama deve essere in ascolto sulla sua porta predefinita. Esegui ollama list per confermare che risponde e vedere i modelli già installati.
2. 02
   Installa Aider

   Il metodo consigliato prevede l'uso di pipx o dello script di installazione ufficiale, che isola Aider in un ambiente dedicato per evitare conflitti tra dipendenze Python.
3. 03
   Posizionati in un repository git

   Apri un terminale alla radice di un progetto sotto controllo di versione. Se il progetto non è ancora sotto git, esegui prima git init: Aider ne ha bisogno per creare i commit delle sue modifiche.

# Via pipx (isole Aider, n'encombre pas votre Python système)
python -m pip install --user pipx
pipx install aider-chat

# Vérifier l'installation
aider --version

#Configurare Aider per Ollama

Aider comunica con Ollama tramite il suo endpoint compatibile con OpenAI. Ci sono due cose da configurare: l’URL di base di Ollama (variabile d’ambiente) e il modello da usare. La soluzione più pulita è creare un file .aider.conf.yml nella directory principale del progetto (o nella tua cartella personale per una configurazione globale), per non dover reinserire le opzioni a ogni avvio.

# Indique à Aider où trouver l'API Ollama
export OLLAMA_API_BASE=http://127.0.0.1:11434

# Lancer Aider avec un modèle Ollama (préfixe ollama/)
aider --model ollama/qwen3.5:9b

Per non dover digitare di nuovo nulla, inserisci queste impostazioni in un file di configurazione. Aider legge automaticamente un file .aider.conf.yml trovato nella directory principale del repository o nella tua cartella personale.

# Modèle principal servi par Ollama (préfixe ollama/ obligatoire)
model: ollama/devstral:24b

# Modèle léger pour les tâches annexes (messages de commit, résumés)
weak-model: ollama/qwen3.5:9b

# Auto-commit des modifications acceptées (comportement par défaut)
auto-commits: true

# Ne pas committer automatiquement les fichiers que VOUS modifiez
dirty-commits: false

- name: ollama/devstral:24b
  extra_params:
    num_ctx: 8192

#Quale modello in base alla VRAM

Aider invia una grande quantità di contesto (file aggiunti + repo-map) e si aspetta una patch ben formata in risposta. Un modello troppo piccolo produce diff non validi che Aider non riesce ad applicare. Punta al modello per la programmazione più grande che la tua scheda riesce a caricare senza difficoltà, lasciando un margine per il contesto.

#Il workflow dall'inizio alla fine

Ecco il ciclo tipico di una modifica, dal lancio di Aider al commit. Una volta stabilito questo ritmo, continui a fare cambiamenti senza mai lasciare il terminale.

1. 01
   Avvia Aider alla radice del repository

   Aider si avvia, legge la configurazione, costruisce il repo-map e mostra un prompt. Indica il modello attivo e il numero di file rilevati.
2. 02
   Aggiungi i file interessati con /add

   Aggiungi solo i file che il compito richiede di modificare. Meno file ci sono nel contesto, più il modello rimane preciso. Il repo-map fornisce già al modello una visione del resto del progetto.
3. 03
   Descrivi la modifica in francese

   Inserisci la tua richiesta in linguaggio naturale: «aggiungi la validazione dell'email nel modulo di iscrizione». Aider riflette, poi propone una patch.
4. 04
   Rileggi il diff proposto

   Aider mostra il diff prima di applicarlo. Controllalo. Se qualcosa non va, rispondi per correggere: «no, usa una regex più rigorosa».
5. 05
   Lascia che Aider crei i commit

   Una volta applicata la patch, Aider crea automaticamente un commit con un messaggio descrittivo. La tua cronologia git rimane pulita e ogni cambiamento è tracciabile.
6. 06
   Itera o annulla

   Prosegui con la modifica successiva. Se un commit di Aider non ti soddisfa, /undo annulla l'ultimo commit che ha creato, senza toccare il resto.

$ aider
Aider v0.x — model: ollama/devstral:24b
Repo-map: 42 fichiers

> /add src/auth/register.py
Added src/auth/register.py to the chat

> Ajoute la validation de l'email dans le formulaire d'inscription

[Aider propose un diff, l'applique, puis :]
Commit a1b2c3d  feat: valider le format de l'email à l'inscription

#Comandi chiave per l'uso quotidiano

Aider si controlla tramite comandi slash nel suo prompt. Ne bastano pochi per coprire il 90% degli usi.

/add fichier

Aggiunge uno o più file al contesto di modifica. È su questi file che Aider scriverà. Limitati allo stretto necessario.

/drop fichier

Rimuove un file dal contesto. Utile quando cambi attività per ripartire da un contesto pulito.

/architect

Attiva la modalità «prima pianifica, poi scrivi il codice»: il modello ragiona prima sull'approccio, poi genera il diff. Ideale per modifiche non banali.

/diff

Mostra le modifiche apportate dall'ultimo commit, per rileggere ciò che Aider ha cambiato prima di continuare.

/undo

Annulla l'ultimo commit creato da Aider. Una rete di sicurezza immediata se una modifica va storta.

/run commande

Esegue un comando shell (test, linter) e reinserisce l'output nella chat. Aider può quindi apportare correzioni basandosi sugli errori reali.

/ask question

Poni una domanda sul codice SENZA attivare modifiche né commit. Per capire prima di agire.

#Limiti dell'esecuzione in locale rispetto al cloud

Siamo onesti: un modello locale con 8–16 GB non eguaglia un modello cloud di punta. Conoscere i limiti evita la frustrazione e aiuta a scegliere lo strumento giusto in base al compito.

Diff a volte malformati

I modelli piccoli producono talvolta una patch che Aider non riesce ad applicare (formato non valido). Passare a un modello più grande o aumentare num_ctx riduce nettamente questo problema.

Contesto più breve

Un modello cloud gestisce decine di file. In locale, mantieni il contesto limitato: pochi file con /add alla volta, e affidati al repo-map invece di caricare tutto.

Ragionamento multi-file

I refactoring che coinvolgono molti file contemporaneamente restano il punto debole dei modelli locali. Suddividi il lavoro in più piccole attività, oppure passa a /architect per strutturarlo.

Velocità legata alla GPU

La latenza dipende dalla tua scheda. Un 32B su una scheda modesta sarà lento. Se la reattività ha la priorità, un 7B o 14B ben configurato è più piacevole nell'uso quotidiano.

#Domande frequenti