Aider installeren en koppelen aan je API-key

Aider installeer je het snelst met de officieel aanbevolen methode: draai python -m pip install aider-install en daarna aider-install. Die installer zet Aider in een geisoleerde omgeving en kan zo nodig zelf Python 3.12 voor je regelen (aider.chat/docs/install). Daarna koppel je je eigen API-key — bijvoorbeeld via een omgevingsvariabele als ANTHROPIC_API_KEY of OPENAI_API_KEY — en start je met aider --model <model> vanuit je projectmap. Hieronder loop je het hele traject stap voor stap door, inclusief de one-liners voor Mac, Linux en Windows.

Wat is Aider, en wat heb je nodig?

Aider omschrijft zichzelf als "AI pair programming in your terminal": een AI-collega die met je meeprogrammeert vanaf de command line, zowel voor een nieuw project als voor je bestaande codebase (github.com/Aider-AI/aider). Het is gratis en open source onder de Apache-2.0-licentie, telt per juni 2026 zo'n 45,8k sterren op GitHub en werkt met 100+ programmeertalen (github.com/Aider-AI/aider). Een prettig kenmerk voor teams: Aider commit zijn wijzigingen automatisch met zinnige commit-berichten, zodat je elke aanpassing met je vertrouwde git-tools kunt bekijken, beheren of terugdraaien.

Het belangrijkste verschil met tools als Claude Code of Cursor: Aider draait op jouw eigen API-key. Je betaalt niet een vast abonnement aan Aider, maar rechtstreeks per token aan de modelaanbieder die je kiest (aider.chat/docs/llms). Dat geeft je volledige controle over welk taalmodel je gebruikt en wat je uitgeeft, maar het betekent ook dat je voor het installeren al een API-sleutel bij een aanbieder moet hebben. Heb je die nog niet, regel die dan eerst — bij OpenAI, Anthropic, DeepSeek, Google of een aggregator als OpenRouter.

Voor de installatie zelf heb je verder weinig nodig. De aanbevolen installer en de one-liners kunnen Python desnoods zelf meeleveren, dus een kale machine volstaat. Wil je een van de Python-gebaseerde routes (uv of pipx), dan heb je wel een werkende Python-installatie nodig — de exacte versie-eisen staan verderop.

Stap 1: Aider installeren

Er zijn een paar routes. De eerste is de officieel aanbevolen; de andere zijn handig als je Python al gebruikt of een voorkeur hebt voor uv of pipx.

De aanbevolen methode (aider-install)

Dit is de route die Aider zelf aanraadt, omdat hij Aider in een geisoleerde omgeving plaatst en zo nodig zelf Python 3.12 installeert. Hij werkt met Python 3.8-3.13 (aider.chat/docs/install):

python -m pip install aider-install
aider-install

De one-liners (Mac, Linux, Windows)

Wil je helemaal niets met Python doen, gebruik dan de installatiescripts. Voor Mac en Linux:

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

Heb je geen curl, dan kan het ook met wget:

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

Op Windows draai je dit in PowerShell:

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

Een algemeen veiligheidspunt bij dit soort one-liners: je voert hiermee een script uit dat je rechtstreeks van internet binnenhaalt. Dat is bij Aider de officiele installatiemethode, maar het blijft goed gebruik om te weten wat je draait. Wil je eerst kijken, open dan de URL in je browser voordat je hem door sh of PowerShell laat uitvoeren.

Alternatief: via uv of pipx

Werk je al met de Python-toolchain, dan kun je Aider ook met uv of pipx installeren. Via uv (Python 3.8-3.13):

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

Of via pipx (Python 3.9-3.12):

python -m pip install pipx
pipx install aider-chat

Let op het verschil in Python-bereik: de aanbevolen installer en uv ondersteunen Python 3.8-3.13, terwijl pipx en de directe pip-installatie 3.9-3.12 vereisen (aider.chat/docs/install). Twijfel je over je versie, kies dan de aanbevolen installer — die regelt het zelf.

Stap 2: Je API-key koppelen

Aider praat met het taalmodel via jouw API-sleutel. Er zijn drie manieren om die te koppelen; kies er een die bij je werkwijze past (aider.chat/docs/config/api-keys).

1. Omgevingsvariabele. De snelste manier voor een losse sessie. Aider herkent onder meer OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY en DEEPSEEK_API_KEY. Zet er een in je shell, bijvoorbeeld:

export ANTHROPIC_API_KEY=<jouw-sleutel>

2. Een .env-bestand. Handiger als je niet elke keer een variabele wilt exporteren. Zet je sleutels in een .env-bestand:

OPENAI_API_KEY=<key>
ANTHROPIC_API_KEY=<key>
GEMINI_API_KEY=foo
OPENROUTER_API_KEY=bar
DEEPSEEK_API_KEY=baz

3. Het configbestand .aider.conf.yml. Voor een vaste projectconfiguratie. Voor OpenAI en Anthropic gebruik je aparte sleutels:

openai-api-key: <key>
anthropic-api-key: <key>

Voor andere aanbieders gebruik je de generieke api-key-lijst:

api-key:
- gemini=foo
- openrouter=bar
- deepseek=baz

Wil je de sleutel liever bij het starten meegeven, dan kan dat ook via een switch. Voor OpenAI en Anthropic bestaan de aparte vlaggen --openai-api-key en --anthropic-api-key. Voor elke andere aanbieder gebruik je het generieke formaat --api-key provider=<key>, wat hetzelfde effect heeft als het zetten van de bijbehorende omgevingsvariabele. Zo zet --api-key gemini=xxx onder water GEMINI_API_KEY=xxx (aider.chat/docs/config/api-keys).

Behandel die sleutels als wachtwoorden: zet een .env-bestand nooit in je versiebeheer en deel je config niet ongefilterd. Voeg .env toe aan je .gitignore voordat je commit.

Stap 3: Je eerste sessie starten

Met Aider geinstalleerd en je sleutel gekoppeld start je per project. Ga naar de map van het project waar Aider moet meewerken en start hem met het model van je keuze:

cd ~/pad/naar/jouw-project
aider --model sonnet --api-key anthropic=<key>

Het --model-argument bepaalt welk taalmodel Aider gebruikt. Aider werkt met vrijwel elke aanbieder — onder meer OpenAI, Anthropic, DeepSeek, Gemini, OpenRouter en Ollama — en presteert volgens de documentatie het best met modellen die sterk zijn in het bewerken van code (aider.chat/docs/llms). De docs waarschuwen erbij dat zwakkere modellen (zwakker dan GPT-3.5) moeite kunnen hebben om goed met Aider samen te werken, dus kies bij voorkeur een capabel model.

Een paar voorbeelden van een complete startregel, met sleutel ineens meegegeven (aider.chat/docs/install):

aider --model deepseek --api-key deepseek=<key>
aider --model sonnet --api-key anthropic=<key>
aider --model o3-mini --api-key openai=<key>

Daarna ben je binnen. Je beschrijft in gewone taal wat je wilt, Aider leest de relevante bestanden, doet de aanpassing en commit die voor je via git. Wil je een wijziging terug, dan gebruik je gewoon je vertrouwde git-tools — precies waar de automatische commits voor bedoeld zijn.

Veelgemaakte struikelblokken

Een paar dingen waar nieuwe gebruikers tegenaan lopen. Krijg je na installatie "command not found" bij het draaien van aider, dan staat de installatiemap waarschijnlijk niet in je PATH; herstart je terminal of volg de aanwijzing die de installer toonde. Werkt het model niet zoals verwacht, controleer dan of je de juiste API-sleutel bij het juiste model hebt gekoppeld — een Anthropic-sleutel werkt niet voor een OpenAI-model. En loopt de installatie vast op een Python-versie, kies dan de aanbevolen aider-install, die de Python-kwestie zelf oplost in plaats van die bij jou neer te leggen.

Goede prompts maken bovendien een groot verschil in wat Aider oplevert; hoe je dat aanpakt, lees je in onze uitleg over prompt-engineering. En omdat Aider een volwaardige AI-agent is die zelfstandig bestanden wijzigt, loont het om bewust om te gaan met wat je hem laat doen in een repo met echte, ongecommitte wijzigingen.

Hoe nu verder?

Je hebt Aider geinstalleerd, je API-key gekoppeld en je eerste sessie gestart. De volgende stap is bepalen of Aider ook de juiste keuze is naast alternatieven als Claude Code, Codex CLI en Gemini CLI, en wanneer je welke inzet. Dat overzicht — inclusief het verschil tussen betalen per token en een abonnement — vind je in onze AI-CLI's kennisbank. Daar staat ook het bredere beslisframework dat je helpt kiezen welke terminal-agent het best bij jouw team en stack past.