Aiutare installare e utilizzare

Aider è uno strumento di pair-programming AI per il terminale. AI-School consiglia Aider per programmare con gli studenti, poiché lo strumento è esplicito nel funzionamento e meno agentico rispetto a molte altre coding agent.

Lo studente riceve aiuto nella programmazione, ma continua a vedere chiaramente quali file vengono modificati.

Per ulteriori informazioni consulta il sito di Aider all'indirizzo Aider-website 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 quindi che Python sia disponibile.

macOS e Linux

python3 --version

Su macOS e molte installazioni Linux il comando Python 3 si chiama python3 invece che python. Perciò usa sempre python3 nella guida.

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 con uno script di installazione:

curl -LsSf https://aider.chat/install.sh | sh

Su Windows questo è possibile 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"

Installa Git

Aider funziona meglio in una cartella che sia un repository git. Perciò installa anche git e fai in modo che gli studenti lavorino preferibilmente in una cartella di progetto con controllo di versione.

Collegare con Coderenza

Aider può lavorare con API compatibili con OpenAI. Usa per questo l'endpoint Coderen en la chiave API di AI-School.

macOS e Linux

export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="tua-chiave-api"

Windows

setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "tua-chiave-api"

Chiudi quindi il terminale e aprine uno nuovo, in modo che Windows usi le nuove variabili.

Avviare Aider

Vai nella cartella del tuo progetto:

cd percorso/del/tuo/progetto

Avvia Aider con un modello consentito. Per gli studenti consigliamo gpt-5.4-mini.

aider --model openai/gpt-5.4-mini

Per utenti avanzati è possibile scegliere un modello più forte:

aider --model openai/gpt-5.4

Lavorare con i file

In Aider puoi aggiungere file al contesto:

/add src/main.py

Poi chiedi assistenza, ad esempio:

Puoi spiegare perché questa funzione non funziona?

Oppure:

Rendi l’errore più chiaro per l’utente.

Comandi utili

Comando	Significato
/add file	Aggiungi un file alla chat
/ask	Poni domande senza modificare direttamente il codice
/code	Chiedi ad Aider di modificare il codice
/diff	Visualizza le modifiche
/undo	Annulla l'ultima modifica dell'IA
/exit	Chiudi Aider

Consigli per la classe

Fare uso di Aider come assistente di programmazione, non come strumento automatico di risoluzione.

Buone attività includono, ad esempio:

• “Spiega cosa significa questo messaggio di errore.”
• “Quale passaggio dovrei esaminare ora?”
• “Aiutami a ridurre la dimensione di questa funzione.”
• “Controlla se la mia soluzione è logica.”

Meno adatto per i principianti:

• “Esegui l’intero compito per me.”
• “Costruisci l’intera applicazione.”
• “Risolvi tutto automaticamente.”