Instal·lació d'Aider i configuració d'OmniProxy

Aider és una eina que ajuda a modificar codi des del terminal. Crea un mapa de tot el codi font per ajudar el model a entendre projectes més grans. Git és una eina de control de versions que registra els canvis en el codi, permetent-te inspeccionar les diferències i restaurar versions anteriors. Després de donar una tasca a Aider, la processa pas a pas i escriu missatges de commit. Si no t’agraden els canvis, els pots desfer amb /undo.

Abans de començar

Hi ha dues opcions d’instal·lació habituals:

Si el teu ordinador ja té Python 3.8 a 3.13, instal·la aider-install primer. Python és l’entorn d’execució necessari per a Aider.

Mac i Linux

install.sh

Executa amb sh després de curl
Instal·la Python si cal
Utilitza wget si curl no està disponible

Windows

install.ps1

Executa a PowerShell
Torna a obrir el terminal després de la instal·lació
Defineix variables d'entorn amb setx

Python ja instal·lat

aider-install

Primer instal·la aquest paquet amb pip
Després executa aider-install
Crea el seu propi entorn

L'instal·lador d'una sola línia configura Python 3.12 quan és necessari. Instal·lar aider-chat directament amb pip és menys fiable.

Assegura’t que OmniProxy estigui en marxa. Després de la instal·lació, entra al directori del projecte que vols modificar abans d’iniciar Aider.

Instal·lació i primer llançament

Si ja tens Python 3.8 a 3.13

Executa aquestes ordres en ordre:

python -m pip install aider-install
aider-install

aider-install instal·la Aider en un entorn Python separat perquè no interfereixi amb altres projectes Python del teu ordinador. Quan és necessari, també instal·la Python 3.12 perquè l’utilitzi Aider.

Instal·lació d’una sola línia

En Mac i Linux, executa:

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

Si curl no està instal·lat, utilitza:

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

En Windows PowerShell, executa:

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

Aquestes ordres d’una sola línia es basen en uv, un programa per instal·lar i gestionar eines i entorns Python. També pots utilitzar l’ordre següent:

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

També pots utilitzar pipx. Quan instal·lis directament amb python -m pip install aider-chat, les versions de Python compatibles són de la 3.9 a la 3.12. Tanmateix, aquest és un mètode d’instal·lació alternatiu, així que prefereix els mètodes descrits anteriorment. Els paquets d’Aider dels gestors de paquets del sistema poden tenir desajustos de dependències, per la qual cosa no haurien de ser la teva primera opció.

El 09-10-2026, l’ordre d’instal·lació d’una sola línia va instal·lar Aider v0.86.2. Durant la instal·lació, és possible que vegis un missatge dient que la memòria cau i la destinació es troben en discs diferents i que els fitxers es copiaran. La instal·lació es completarà igualment.

Després de la instal·lació, entra al directori del projecte. Una API compatible és una interfície que es comunica amb altres serveis de models utilitzant el format d’OpenAI. Inicia Aider utilitzant aquest patró:

aider --model openai/<model-name>

Substitueix <model-name> per l’ID complet del model copiat d’OmniProxy a la secció següent. Un ID de model és el nom utilitzat per identificar un model amb precisió.

Obtenir la configuració de connexió d’OmniProxy

Has de configurar les dues variables d’entorn següents. Les variables d’entorn es poden entendre com un conjunt de paràmetres de connexió que llegeixen els programes del terminal:

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

OPENAI_API_BASE és el punt final (endpoint) de l’API i ha d’incloure /v1. OPENAI_API_KEY és la clau utilitzada per accedir a l’API.

En Windows, utilitza setx per desar les variables. Has de tornar a obrir el terminal després:

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

Copia el nom complet del model de la llista actual d’OmniProxy, incloent-hi qualsevol barra a l’ID del model. Quan iniciïs Aider, afegeix openai/ abans de l’ID complet.

A data de 09-10-2026, els dos IDs de referència a la documentació del proveïdor són gemini-3.8-flash i grok-4.7. Si aquests noms no estan a la llista actual, no els copiïs directament. Utilitza un ID complet que aparegui realment a la llista.

Adreça

OPENAI_API_BASE

Apunta-ho a OmniProxy
Inclou /v1
No ho posis al repositori

Clau

OPENAI_API_KEY

Utilitza la proporcionada per la passarel·la
Torna a obrir els terminals de Windows després de canviar-ho
Mantén les claus del proveïdor a la passarel·la

Llançament

openai/model

cd al directori del projecte
Prefixa el nom del model amb openai/
Utilitza el nom de la llista de la passarel·la

Les dues variables d'entorn, juntament amb un nom de model prefixat per openai/, formen la sintaxi de l'API compatible.

Entrar la configuració de l’eina

No cal crear un fitxer de configuració separat. Entra al directori del projecte, inicia Aider i substitueix l’ID del model per un nom que existeixi realment a la llista actual d’OmniProxy:

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

Per utilitzar l’altre model d’exemple, executa:

aider --model openai/grok-4.7

Quan Aider troba un model desconegut, mostra un avís. Aquest avís no significa per si mateix que el punt final sigui incorrecte. Comprova els registres de sol·licituds d’OmniProxy per confirmar si la sol·licitud ha aparegut.

Aider només afegeix al context els fitxers que ja estan seguits per Git. El context és el codi i la informació que el model pot llegir durant la tasca actual. Si el directori actual encara no és un repositori Git, Aider en crea un, però els fitxers que Git no segueix encara no es poden llegir. Utilitza git add per afegir els fitxers i fer-ne el commit abans d’iniciar Aider.

Aider encara pot modificar fitxers. --no-auto-commits només desactiva els commits automàtics; no impedeix les modificacions de fitxers. Quan utilitzis Aider per primera vegada, tria un repositori sense importància i executa git diff després de la tasca per revisar els canvis reals.

No posis claus reals en fitxers de projecte o pàgines públiques. Emmagatzema les claus del proveïdor només a OmniProxy. Si la passarel·la no valida les claus, pots configurar OPENAI_API_KEY com una cadena de text de marcatge utilitzada només al teu ordinador local.

Verificar amb una tasca real

Primer, assegura’t que el fitxer que vols que Aider llegeixi s’hagi fet commit a Git. Després, executa l’ordre següent des del directori del projecte. Substitueix l’ID del model per un ID complet de la llista actual d’OmniProxy:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message envia una tasca directament a Aider, mentre que --no-auto-commits diu a Aider que no creï commits de Git automàticament durant aquesta execució.

El 09-10-2026, Aider v0.86.2 va llegir correctament la primera línia d’un fitxer seguit. Si el fitxer no està seguit per Git, Aider dirà que no pot veure el contingut. Això no significa que el punt final de l’API sigui incorrecte. Després de completar la consulta, comprova els registres de sol·licituds d’OmniProxy per verificar la font de la sol·licitud i l’ID del model.

Llançament

Aider s'inicia

L'ordre està disponible
Les variables d'entorn estan actives
Al directori del projecte

Tasca

Ha inspeccionat el fitxer

Pregunta sobre un fitxer específic
Revisa la seva explicació
Els models desconeguts poden activar un avís

Registres

Visible a la passarel·la

La font és Aider
L'ID del model coincideix
La clau no s'ha introduït a la pàgina

Confirma que les variables d'entorn estan actives i l'ordre està disponible, després completa una consulta real.

Errors comuns

aider no es pot trobar: Torna a obrir el terminal primer. Si l’has instal·lat directament amb pip, prova python -m aider.
Windows encara es connecta a l’antic punt final després de canviar les variables: Has de tornar a obrir el terminal després d’executar setx. Només una finestra nova llegirà les variables actualitzades.
El nom del model no comença amb openai/: L’API compatible requereix el format openai/<model-name>.
Apareix un avís de model desconegut: Aquest és un avís normal i no significa que la connexió hagi fallat. Comprova si OmniProxy ha rebut la sol·licitud.
L’ID del model no és vàlid: Copia l’ID complet de nou de la llista actual d’OmniProxy. Mantén el prefix openai/ i qualsevol barra que ja estigui present a l’ID.
Aider diu que no hi ha contingut de fitxer: Assegura’t que el fitxer estigui seguit per Git. Els fitxers en un repositori buit o els fitxers no seguits no s’afegeixen al context.

Referències oficials

Per als passos d’instal·lació, vegeu Instal·lació d’Aider. Per a les variables d’entorn i el prefix del model, vegeu APIs compatibles amb OpenAI. Els IDs de models d’exemple es poden trobar a la llista de models de Gemini i a la pàgina de models de xAI.

Substitueix cada marcador de posició amb valors de la teva pròpia configuració d'OmniProxy. No publiquis mai una clau real.

Un resultat guardat o HTTP 200 sols no demostra compatibilitat completa de l'Agent. Comprova la font i el model al registre de crides d'OmniProxy.

Fonts oficials · Aider ↗