Installazione di Aider e configurazione di OmniProxy

Aider è uno strumento che aiuta a modificare il codice dal terminale. Crea una mappa dell’intero repository per aiutare il modello a comprendere i progetti più grandi; Git è invece uno strumento di controllo delle versioni che registra le modifiche al codice e permette di esaminare le differenze e ripristinare le modifiche. Quando assegni un’attività ad Aider, lo strumento la esegue un passaggio alla volta e scrive un messaggio di commit. Se le modifiche non ti soddisfano, puoi annullarle con /undo.

Preparazione all’installazione

Esistono due metodi di installazione comuni:

Se sul computer è già presente Python da 3.8 a 3.13, installa prima aider-install. Python è l’ambiente di esecuzione richiesto da Aider.
Se non è disponibile una versione adatta di Python, usa il comando di installazione in una riga, che installerà anche Python 3.12 quando necessario.

Mac e Linux

install.sh

Esegui con sh dopo curl
Installa Python quando necessario
Se manca curl, usa wget

Windows

install.ps1

Esegui con PowerShell
Riapri il terminale dopo l'installazione
Per le variabili d'ambiente usa setx

Python già installato

aider-install

Installa prima questo pacchetto con pip
Poi esegui aider-install
Creerà un ambiente autonomamente

L'installazione in una riga predisporrà Python 3.12 quando necessario. Installare direttamente aider-chat con pip è meno affidabile.

Assicurati che OmniProxy sia in esecuzione. Al termine dell’installazione, entra nella directory del progetto che intendi modificare e avvia Aider.

Installazione e primo avvio

Se è già disponibile Python da 3.8 a 3.13

Esegui nell’ordine:

python -m pip install aider-install
aider-install

aider-install installa Aider in un ambiente Python separato, evitando interferenze con gli altri progetti Python presenti sul computer. Quando necessario, installa anche Python 3.12 per Aider.

Installazione in una riga

Su Mac e Linux esegui:

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

Se curl non è installato sul computer, puoi usare:

wget -qO- https://aider.chat/install.sh | sh

In Windows PowerShell esegui:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Questi comandi di una sola riga si basano su uv, un programma per installare e gestire strumenti e ambienti Python. Puoi anche usare il comando seguente:

uv tool install --force --python python3.12 --with pip aider-chat@latest

In alternativa, puoi usare pipx. Installando direttamente con python -m pip install aider-chat, le versioni di Python supportate vanno dalla 3.9 alla 3.12, ma questo è considerato un metodo di installazione alternativo: usa preferibilmente i metodi indicati sopra. Le versioni di Aider fornite dai gestori di pacchetti di sistema potrebbero avere dipendenze non corrispondenti, quindi non usarle come prima scelta.

Il 2026-10-09, il comando di installazione in una riga ha installato Aider v0.86.2. Se durante l’installazione compare un avviso che indica che la cache e la destinazione si trovano su dischi diversi e che i file verranno copiati, l’installazione verrà comunque completata.

Al termine dell’installazione, entra nella directory del progetto. Un’interfaccia compatibile è un’interfaccia che comunica con altri servizi di modelli usando il formato OpenAI. Il comando di avvio ha questa forma:

aider --model openai/<model-name>

Sostituisci <model-name> con l’ID completo del modello copiato da OmniProxy nella sezione successiva. L’ID del modello è il nome usato per identificare con precisione il modello.

Recuperare i parametri di connessione da OmniProxy

Devi impostare le due variabili d’ambiente seguenti. Le variabili d’ambiente possono essere considerate un insieme di impostazioni di connessione lette dai programmi eseguiti nel terminale:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE è l’indirizzo dell’interfaccia e deve includere /v1. OPENAI_API_KEY è la chiave utilizzata per accedere all’interfaccia.

In Windows, usa setx per salvare le variabili. Dopo l’esecuzione devi riaprire il terminale:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Copia per intero il nome del modello dall’elenco corrente di OmniProxy, conservando anche le barre presenti nell’ID. Quando avvii Aider, aggiungi openai/ prima dell’ID completo.

Al 2026-10-09, i due ID di riferimento presenti nella documentazione dei fornitori erano gemini-3.8-flash e grok-4.7. Se questi nomi non sono presenti nell’elenco corrente, non copiarli direttamente: usa un ID completo effettivamente presente nell’elenco.

Indirizzo

OPENAI_API_BASE

Punta a OmniProxy
Scrivilo fino a /v1
Non inserirlo nel repository

Chiave

OPENAI_API_KEY

Usa quella fornita dal gateway
Su Windows riapri il terminale dopo la modifica
La chiave del provider resta nel gateway

Avvio

openai/modello

Esegui cd nella directory del progetto
Aggiungi openai/ al nome del modello
Fai riferimento all'elenco del gateway

Le due variabili d'ambiente e il nome del modello con il prefisso openai/ costituiscono il formato previsto per l'interfaccia compatibile.

Inserire la configurazione dello strumento

Non è necessario creare un altro file di configurazione. Entra prima nella directory del progetto, quindi avvia Aider sostituendo l’ID del modello con un nome effettivamente presente nell’elenco corrente di OmniProxy:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Per usare l’altro modello di esempio, esegui:

aider --model openai/grok-4.7

Quando Aider incontra un modello che non riconosce, mostra un avviso nell’interfaccia. Questo avviso non significa necessariamente che l’indirizzo sia errato: controlla nei registri delle chiamate di OmniProxy se la richiesta è stata ricevuta.

Aider inserisce nel contesto soltanto i file già tracciati da Git. Il contesto è l’insieme del codice e delle informazioni che il modello può leggere per l’attività corrente. Se la directory corrente non è ancora un repository Git, Aider ne crea uno automaticamente, ma i file non tracciati da Git rimangono illeggibili. Aggiungi prima i file con git add, crea un commit e poi avvia Aider.

Aider può comunque modificare i file. --no-auto-commits disattiva soltanto i commit automatici e non impedisce la modifica dei file. Al primo utilizzo è consigliabile scegliere un repository non importante ed eseguire git diff al termine dell’attività per esaminare le modifiche effettive.

Non inserire chiavi reali nei file del progetto o in pagine pubbliche. Le chiavi dei fornitori devono essere conservate soltanto in OmniProxy. Se il gateway non verifica la chiave, per OPENAI_API_KEY puoi usare una stringa segnaposto utilizzata soltanto sul computer locale.

Verificare un’attività reale

Assicurati prima che il file da leggere sia stato aggiunto a un commit Git, quindi esegui il comando seguente nella directory del progetto. Sostituisci l’ID del modello con l’ID completo presente nell’elenco corrente di OmniProxy:

aider --model openai/gemini-3.8-flash --message "Qual è la prima riga di questo file? Non modificare il file." --no-auto-commits

--message serve ad assegnare direttamente un’attività ad Aider, mentre --no-auto-commits indica di non creare automaticamente un commit Git durante questa esecuzione.

Il 2026-10-09 è stato verificato con Aider v0.86.2 che lo strumento riesce a leggere la prima riga di un file tracciato. Se il file non è ancora tracciato da Git, Aider risponderà che non può vederne il contenuto; ciò non significa che l’indirizzo dell’interfaccia sia errato. Dopo aver completato la richiesta, controlla nei registri delle chiamate di OmniProxy l’origine della richiesta e l’ID del modello.

Avvio

aider si avvia

Il comando viene trovato
Le variabili d'ambiente sono attive
Resta nella directory del progetto

Attività

Ha letto i file

Chiedi di un file specifico
Leggi la sua descrizione
I modelli non familiari mostrano un avviso

Registri

Visibile dal gateway

La fonte è Aider
L'ID del modello corrisponde
La chiave non entra nella pagina

Verifica che le variabili d'ambiente siano attive e che il comando sia disponibile, quindi completa una richiesta reale.

Errori comuni

aider non viene trovato: riapri prima il terminale. Se hai eseguito un’installazione diretta tramite pip, puoi provare python -m aider.
Dopo aver modificato le variabili, Windows continua a collegarsi al vecchio indirizzo: dopo aver eseguito setx devi riaprire il terminale; soltanto la nuova finestra leggerà le variabili aggiornate.
Il nome del modello non contiene openai/: l’interfaccia compatibile richiede il formato openai/<model-name>.
Compare un avviso relativo a un modello sconosciuto: è un normale avviso e non indica necessariamente un errore di connessione. Controlla quindi se OmniProxy ha ricevuto la richiesta.
L’ID del modello non è valido: copia nuovamente l’ID completo dall’elenco corrente di OmniProxy, conservando il prefisso openai/ e tutte le barre già presenti nell’ID.
Aider afferma di non avere accesso al contenuto del file: verifica che il file sia già tracciato da Git. I repository vuoti e i file non tracciati non vengono inclusi nel contesto.

Riferimenti ufficiali

Per i passaggi di installazione, consulta Aider installation. Per le variabili d’ambiente e il prefisso del modello, consulta OpenAI compatible APIs. Gli ID dei modelli usati negli esempi sono consultabili nell’elenco dei modelli Gemini e nella pagina dei modelli xAI.

Sostituisci ogni segnaposto con valori dalla tua configurazione OmniProxy personale. Non pubblicare mai una chiave reale.

Un risultato salvato o HTTP 200 da soli non provano la piena compatibilità con l'Agente. Controlla l'origine e il modello nel registro delle chiamate di OmniProxy.

Fonti ufficiali · Aider ↗