Aiutare installare e utilizzare
Aider è uno strumento di pair programming AI per il terminale. AI-School consiglia Aider per la programmazione con gli studenti, poiché lo strumento è esplicito nel funzionamento e meno agentico rispetto a molti altri agenti di coding.
Lo studente ottiene aiuto nella programmazione, ma resta ben consapevole dei file che vengono modificati.
Per ulteriori informazioni consulta il sito di Aider e la documentazione ufficiale di Aider.
Installazione
Per Aider è necessario prima Python. Installa Python 3 tramite python.org o tramite un gestore di pacchetti come Homebrew.
Verifica poi che Python sia disponibile.
macOS e Linux
python3 --version
Su macOS e molte installazioni Linux, il comando Python 3 si chiama python3 invece di python. Per questo motivo nella guida usa sempre python3.
Windows
py --version
Su Windows Python di solito si avvia con py.
Installazione di Aider
L’installazione consigliata secondo la documentazione di installazione di Aider è tramite aider-install.
macOS e Linux
python3 -m pip install aider-install
aider-install
Su macOS e Linux Aider può essere installato anche tramite uno script di installazione:
curl -LsSf https://aider.chat/install.sh | sh
Su Windows è possibile farlo tramite PowerShell:
py -m pip install aider-install
aider-install
Oppure con lo script di installazione:
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
Aider funziona al meglio in una cartella che è un repository git. Installa quindi anche git e fai in modo che gli studenti lavorino preferibilmente in una cartella di progetto con controllo di versione.
Collegamento con Coderen
Aider può lavorare con API compatibili OpenAI. Usa perciò l’endpoint Coderen e la chiave API da AI-School.
macOS e Linux
export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="la-tua-chiave-api"
Windows
setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "la-tua-chiave-api"
Chiudi poi il terminale e riapri una nuova finestra, in modo che Windows usi le nuove variabili.
Avvio di Aider
Vai nella cartella del tuo progetto:
cd percorso/del/tuo/progetto
Avvia Aider con un modello consentito. Per gli studenti consigliamo gpt-5.6-luna.
aider --model openai/gpt-5.6-luna
Per utenti avanzati può essere scelto un modello più potente:
aider --model openai/gpt-5.6-terra
Lavorare con i file
In Aider puoi aggiungere file al contesto:
/add src/main.py
Successivamente chiedi aiuto, ad esempio:
puoi spiegare perché questa funzione non funziona?
Oppure:
Rendi il messaggio di errore più chiaro per l’utente.
Comandi utili
| Comando | Significato |
|---|---|
/add file | Aggiungi un file alla chat |
/ask | Fai domande senza modificare direttamente il codice |
/code | Chiedi ad Aider di modificare il codice |
/diff | Visualizza le modifiche |
/undo | Ripristina l’ultima modifica AI |
/exit | Chiudi Aider |
Consigli per la classe
Lascia che gli studenti usino Aider come aiuto alla programmazione, non come una macchina automatica per risolvere tutto.
Buoni compiti includono, ad esempio:
- “Spiega cosa significa questo messaggio di errore.”
- “Quale passaggio dovrei esaminare ora?”
- “Aiutami a rendere questa funzione più piccola.”
- “Verifica se la mia soluzione è logica.”
Meno adatti per i principianti:
- “Fai l’intero compito per me.”
- “Costruisci l’intera applicazione.”
- “Risolvi tutto automaticamente.”
