Aider installatie en OmniProxy-configuratie

Aider is een tool die helpt bij het aanpassen van code vanuit de terminal. Het bouwt een kaart van de gehele codebase om het model te helpen grotere projecten te begrijpen. Git is een versiebeheertool die codewijzigingen vastlegt, waardoor je verschillen kunt inspecteren en eerdere versies kunt herstellen. Nadat je Aider een taak hebt gegeven, verwerkt het de taak stap voor stap en schrijft het commit-berichten. Als de wijzigingen je niet bevallen, kun je ze ongedaan maken met /undo.

Voordat je begint

Er zijn twee gebruikelijke installatieopties:

Als je computer al Python 3.8 tot en met 3.13 heeft, installeer dan aider-install eerst. Python is de runtime-omgeving die Aider vereist.

Mac en Linux

install.sh

Uitvoeren met sh na curl
Installeert Python indien nodig
Gebruik wget als curl niet beschikbaar is

Windows

install.ps1

Uitvoeren in PowerShell
Heropen de terminal na installatie
Omgevingsvariabelen instellen met setx

Python al geïnstalleerd

aider-install

Installeer eerst dit pakket met pip
Voer daarna aider-install uit
Het maakt zijn eigen omgeving aan

Het one-line installatieprogramma stelt Python 3.12 in wanneer dat nodig is. Het direct installeren van aider-chat met pip is minder betrouwbaar.

Zorg ervoor dat OmniProxy actief is. Ga na de installatie naar de projectmap die je wilt aanpassen voordat je Aider start.

Installeren en voor de eerste keer opstarten

Als je al Python 3.8 tot en met 3.13 hebt

Voer deze opdrachten achter elkaar uit:

python -m pip install aider-install
aider-install

aider-install installeert Aider in een aparte Python-omgeving zodat het andere Python-projecten op je computer niet verstoort. Indien nodig installeert het ook Python 3.12 voor Aider.

One-line installatie

Voer op Mac en Linux het volgende uit:

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

Als curl niet is geïnstalleerd, gebruik dan:

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

Voer in Windows PowerShell het volgende uit:

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

Deze one-line opdrachten zijn gebaseerd op uv, een programma voor het installeren en beheren van Python-tools en -omgevingen. Je kunt ook de volgende opdracht gebruiken:

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

Je kunt ook pipx gebruiken. Bij directe installatie met python -m pip install aider-chatzijn de ondersteunde Python-versies 3.9 tot en met 3.12. Dit is echter een alternatieve installatiemethode, dus geef de voorkeur aan de hierboven beschreven methoden. Aider-pakketten van systeem-pakketbeheerders kunnen afhankelijkheidsconflicten hebben en zouden daarom niet je eerste keuze moeten zijn.

Op 09-10-2026 installeerde de one-line installatieopdracht Aider v0.86.2. Tijdens de installatie zie je mogelijk een melding dat de cache en de doelmap zich op verschillende schijven bevinden en dat bestanden worden gekopieerd. De installatie wordt desondanks voltooid.

Ga na de installatie naar de projectmap. Een compatibele API is een interface die communiceert met andere modeldiensten via het OpenAI-formaat. Start Aider met dit patroon:

aider --model openai/<model-name>

Vervang <model-name> door het volledige model-ID dat je in de volgende sectie uit OmniProxy hebt gekopieerd. Een model-ID is de naam die wordt gebruikt om een model nauwkeurig te identificeren.

Verbindingsinstellingen ophalen uit OmniProxy

Je moet de volgende twee omgevingsvariabelen instellen. Omgevingsvariabelen kunnen worden gezien als een set verbindingsinstellingen die door terminalprogramma’s worden gelezen:

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

OPENAI_API_BASE is het API-eindpunt en moet /v1 bevatten. OPENAI_API_KEY is de sleutel die wordt gebruikt om toegang te krijgen tot de API.

Gebruik op Windows setx om de variabelen op te slaan. Je moet de terminal daarna heropenen:

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

Kopieer de volledige modelnaam uit de huidige OmniProxy-lijst, inclusief eventuele slashes in het model-ID. Voeg bij het starten van Aider openai/ toe voor het volledige ID.

Op 09-10-2026 waren de twee referentie-ID’s in de documentatie van de provider gemini-3.8-flash en grok-4.7. Als deze namen niet in de huidige lijst staan, kopieer ze dan niet direct. Gebruik een volledig ID dat daadwerkelijk in de lijst voorkomt.

Adres

OPENAI_API_BASE

Wijs dit naar OmniProxy
Voeg /v1 toe
Zet dit niet in de repository

Sleutel

OPENAI_API_KEY

Gebruik de sleutel van de gateway
Heropen Windows-terminals na wijziging
Bewaar providersleutels in de gateway

Starten

openai/model

cd naar de projectmap
Zet openai/ voor de modelnaam
Gebruik de naam uit de gateway-lijst

De twee omgevingsvariabelen vormen, samen met een modelnaam voorzien van het voorvoegsel openai/, de compatibele API-syntaxis.

De toolconfiguratie invoeren

Je hoeft geen apart configuratiebestand aan te maken. Ga naar de projectmap, start Aider en vervang het model-ID door een naam die daadwerkelijk in de huidige OmniProxy-lijst staat:

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

Voer het volgende uit om het andere voorbeeldmodel te gebruiken:

aider --model openai/grok-4.7

Wanneer Aider een onbekend model tegenkomt, wordt er een waarschuwing weergegeven. Deze waarschuwing betekent op zichzelf niet dat het eindpunt onjuist is. Controleer de verzoeklogboeken van OmniProxy om te bevestigen of het verzoek is aangekomen.

Aider voegt alleen bestanden toe aan de context die al door Git worden gevolgd. De context is de code en informatie die het model tijdens de huidige taak kan lezen. Als de huidige map nog geen Git-repository is, maakt Aider er een aan, maar bestanden die niet door Git worden gevolgd, kunnen nog steeds niet worden gelezen. Gebruik git add om de bestanden toe te voegen en te committen voordat je Aider start.

Aider kan nog steeds bestanden wijzigen. --no-auto-commits schakelt alleen automatische commits uit; het voorkomt niet dat bestanden worden gewijzigd. Kies bij het eerste gebruik van Aider een onbelangrijke repository en voer git diff uit na de taak om de werkelijke wijzigingen te controleren.

Zet geen echte sleutels in projectbestanden of op openbare pagina’s. Sla providersleutels alleen op in OmniProxy. Als de gateway geen sleutels valideert, kun je OPENAI_API_KEY instellen op een tijdelijke aanduiding (placeholder) die alleen op je lokale computer wordt gebruikt.

Verifiëren met een echte taak

Zorg er eerst voor dat het bestand dat je door Aider wilt laten lezen, is gecommit in Git. Voer vervolgens de volgende opdracht uit vanuit de projectmap. Vervang het model-ID door een volledig ID uit de huidige OmniProxy-lijst:

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 stuurt een taak direct naar Aider, terwijl --no-auto-commits Aider vertelt om tijdens deze sessie niet automatisch Git-commits aan te maken.

Op 09-10-2026 kon Aider v0.86.2 de eerste regel van een gevolgd bestand succesvol lezen. Als het bestand niet door Git wordt gevolgd, zal Aider aangeven dat het de inhoud niet kan zien. Dit betekent niet dat het API-eindpunt onjuist is. Controleer na het voltooien van de query de verzoeklogboeken van OmniProxy om de bron van het verzoek en het model-ID te verifiëren.

Starten

Aider start

Opdracht is beschikbaar
Omgevingsvariabelen zijn actief
In de projectmap

Taak

Het heeft het bestand geïnspecteerd

Vraag over een specifiek bestand
Bekijk de uitleg
Onbekende modellen kunnen een waarschuwing triggeren

Logboeken

Zichtbaar in de gateway

Bron is Aider
Model-ID komt overeen
De sleutel is niet op de pagina ingevoerd

Bevestig dat de omgevingsvariabelen actief zijn en de opdracht beschikbaar is, en voltooi daarna één echte query.

Veelvoorkomende fouten

aider kan niet worden gevonden: Heropen eerst de terminal. Als je het direct met pip hebt geïnstalleerd, probeer dan python -m aider.
Windows maakt na het wijzigen van de variabelen nog steeds verbinding met het oude eindpunt: Je moet de terminal heropenen na het uitvoeren van setx. Alleen een nieuw venster leest de bijgewerkte variabelen.
De modelnaam begint niet met openai/: De compatibele API vereist het formaat openai/<model-name>.
Er verschijnt een waarschuwing voor een onbekend model: Dit is een normale waarschuwing en betekent niet dat de verbinding is mislukt. Controleer of OmniProxy het verzoek heeft ontvangen.
Het model-ID is ongeldig: Kopieer het volledige ID opnieuw uit de huidige OmniProxy-lijst. Behoud het openai/ voorvoegsel en eventuele slashes die al in het ID staan.
Aider zegt dat er geen bestandsinhoud is: Zorg ervoor dat het bestand door Git wordt gevolgd. Bestanden in een lege repository of niet-gevolgde bestanden worden niet aan de context toegevoegd.

Officiële referenties

Zie Aider installatie voor installatiestappen. Zie OpenAI compatibele API’s voor omgevingsvariabelen en het model-voorvoegsel. De voorbeeldmodel-ID’s zijn te vinden in de Gemini modellijst en op de xAI modellenpagina.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst geen volledige Agent-compatibiliteit. Controleer de bron en het model in het oproeprecord van OmniProxy.

Officiële bronnen · Aider ↗