Zum Hauptinhalt springen

Aider

Worum geht's?

Dies ist ein praxisnaher Entwickler-Guide zu Aider, dem quelloffenen Terminal-Tool fĂĽr Pair-Programming von Aider-AI/aider. Er richtet sich an Entwickler, die verstehen wollen, wie Aider funktioniert, wie man es installiert und konfiguriert und wo es im Vergleich zu anderen Coding-Agents passt.

Gegen Primärquellen geprüft

Dieser Guide basiert auf Aiders offizieller Dokumentation und dem offiziellen GitHub-Repository, geprĂĽft am 24. Juni 2026.

1. Was Aider ist​

Aider ist eine KI-Pair-Programming-CLI, die in deinem Terminal arbeitet und Dateien in deinem lokalen Repository bearbeitet. Das Kernmodell lautet:

  • du startest aider in einem Git-Repository
  • du fĂĽgst nur die fĂĽr die Aufgabe relevanten Dateien hinzu
  • du bittest im Chat um Ă„nderungen
  • Aider bearbeitet Dateien, zeigt Diffs und committet seine Ă„nderungen in Git

Das offizielle Projekt positioniert es als „KI-Pair-Programming in deinem Terminal".

Was Aider auszeichnet, ist nicht nur, dass es mit vielen LLMs sprechen kann, sondern dass es bei drei Dingen sehr klare Prinzipien verfolgt:

  • Git-first-Sicherheit
  • Arbeiten aus dem Terminal heraus
  • enge Kontrolle ĂĽber den Datei-Kontext

2. Warum Entwickler es nutzen​

Laut offizieller Doku und Repo sind Aiders stärkste Eigenschaften:

FähigkeitWarum es wichtig ist
Funktioniert mit vielen LLMsDu bist nicht an einen Anbieter gebunden.
Git-IntegrationJede KI-Änderung lässt sich leicht prüfen, vergleichen, rückgängig machen und verzweigen.
Repository-MapAider schickt dem Modell eine kompakte Karte der größeren Codebasis.
Datei-bezogenes EditingDu wählst, welche Dateien in der Sitzung bearbeitbar sind.
Lint-/Test-IntegrationEs kann nach Ă„nderungen Linter und Tests ausfĂĽhren und versuchen, Fehler zu beheben.
Terminal-first-WorkflowGut geeignet fĂĽr Entwickler, die ohnehin in Shell, tmux, neovim oder Remote-Umgebungen leben.
YAML-KonfigurationTeam-Defaults lassen sich einfach in .aider.conf.yml standardisieren.

Das macht Aider besonders attraktiv fĂĽr:

  • bestehende Repositories mit Git-Disziplin
  • Entwickler, die das Terminal einer vollwertigen Agent-IDE vorziehen
  • modell-agnostische Workflows
  • kostenbewusste Setups, bei denen du Anbieter frei wechseln willst

3. Installation und erster Start​

Die offizielle Doku empfiehlt aider-install als schnellsten Weg, weil es Aider in seine eigene Python-Umgebung installiert und bei Bedarf auch Python 3.12 bereitstellen kann.

Schnellste Installation​

python -m pip install aider-install
aider-install

Alternative Installationsmethoden​

Die offizielle Doku dokumentiert auĂźerdem:

  • uv
  • pipx
  • pip
  • plattformspezifische One-Liner fĂĽr macOS, Linux und Windows

Minimale erste Sitzung​

cd /path/to/your/project
aider app.py

Oder mit explizitem Modell:

# DeepSeek
aider --model deepseek --api-key deepseek=<key>

# Anthropic Sonnet
aider --model sonnet --api-key anthropic=<key>

# OpenAI
aider --model o3-mini --api-key openai=<key>

Bitte am aider >-Prompt um die gewünschte Änderung und prüfe die Diffs, bevor du fortfährst.

4. Kern-Workflow​

Der offizielle Nutzungsleitfaden dreht sich um eine zentrale Idee: fĂĽge nur die Dateien hinzu, die du wirklich brauchst.

Mit bestimmten Dateien starten​

aider src/api/users.py src/tests/test_users.py

Diese Dateien werden der Chat-Sitzung hinzugefügt und können direkt bearbeitet werden.

Dateien während der Sitzung hinzufügen oder entfernen​

Verwende In-Chat-Befehle:

  • /add zum HinzufĂĽgen von Dateien
  • /drop zum Entfernen von Dateien
  • /read-only um Referenzdateien einzubeziehen, ohne Ă„nderungen zu erlauben

Warum das wichtig ist​

Aider warnt ausdrücklich davor, dass zu viele Dateien Folgendes bewirken können:

  • das Modell ĂĽberfordern
  • die Token-Kosten erhöhen
  • Ă„nderungen weniger präzise machen

Das ist eine von Aiders stärksten Gewohnheiten und zugleich eine seiner Best Practices.

5. Die Repository-Map​

Eine von Aiders wichtigsten Funktionen ist die Repo-Map.

Anstatt das gesamte Repository in den Kontext zu schicken, baut Aider eine kompakte Karte der Codebasis, die Folgendes enthält:

  • wichtige Dateien
  • zentrale Klassen und Funktionen
  • Signaturen und Symboldefinitionen
  • Abhängigkeitsbeziehungen ĂĽber Dateien hinweg

Die offizielle Doku beschreibt dies als eine Möglichkeit, dem Modell zu helfen, den Rest der Codebasis zu verstehen, selbst wenn du nur eine kleine Anzahl von Dateien direkt hinzufügst.

Warum die Repo-Map wichtig ist​

Sie verschafft Aider zwei groĂźe Vorteile:

  1. Das Modell sieht genug Struktur, um abzuleiten, wo verwandter Code wahrscheinlich liegt.
  2. Das Modell kann gezielt nach weiteren Dateien fragen, nur wenn sie tatsächlich benötigt werden.

Token-Budget​

Die Repo-Map wird ĂĽber Einstellungen wie diese gesteuert:

  • --map-tokens
  • --map-refresh

Standardmäßig versucht Aider, innerhalb eines bescheidenen Token-Budgets zu bleiben, und erweitert es nur bei Bedarf.

6. Git-first-Verhalten​

Aider funktioniert am besten, wenn dein Code in einem Git-Repository liegt.

Laut offizieller Doku tut Aider Folgendes:

  • es bietet an, ein Git-Repo zu erstellen, falls keines existiert
  • es committet seine eigenen Ă„nderungen automatisch
  • es behandelt geänderte Dateien sorgfältig vor dem Editieren
  • es unterstĂĽtzt das RĂĽckgängigmachen ĂĽber die Git-Historie

Besonders nützliche Befehle​

  • /diff zeigt Ă„nderungen seit der letzten Nachricht
  • /undo macht die letzte Aider-Ă„nderung rĂĽckgängig
  • /commit committet ausstehende Ă„nderungen
  • /git fĂĽhrt rohe Git-Befehle auĂźerhalb des Chat-Kontexts aus

Warum das ein echter Vorteil ist​

Das lässt Aider kontrollierter wirken als viele „Black-Box"-Agents:

  • Ă„nderungen sind nachvollziehbar
  • die Historie bleibt verständlich
  • das RĂĽckgängigmachen von Fehlern ist gĂĽnstig

Für Teams, denen Prüfbarkeit und Branch-Hygiene wichtig sind, ist das eines von Aiders stärksten Unterscheidungsmerkmalen.

7. Arbeiten mit Modellen​

Aider ist ausdrĂĽcklich modell-agnostisch.

Der offizielle LLM-Guide besagt, dass es sich mit den meisten groĂźen Anbietern und auch mit lokalen Modellen verbinden kann. Zum Zeitpunkt der geprĂĽften Doku hebt es diese als besonders gut geeignet hervor:

  • Gemini 2.5 Pro
  • DeepSeek R1 und V3
  • Claude 3.7 Sonnet
  • OpenAI o3, o4-mini und GPT-4.1

AuĂźerdem unterstĂĽtzt es:

  • OpenRouter
  • Ollama
  • OpenAI-kompatible APIs
  • lokale Modell-Server

Praktische Konsequenz​

Aider passt gut, wenn du Folgendes willst:

  • einen Workflow ĂĽber mehrere Anbieter hinweg
  • Modelle bei derselben Coding-Aufgabe vergleichen
  • lokale oder gĂĽnstigere APIs nutzen, ohne dein gesamtes Tool zu wechseln

Praktische Warnung​

Die offizielle Doku warnt außerdem, dass schwächere Modelle Änderungen möglicherweise nicht in einer Form zurückgeben, die Aider zuverlässig anwenden kann. Mit anderen Worten:

  • nur weil ein Modell Fragen beantworten kann
  • bedeutet das nicht, dass es stark genug fĂĽr strukturiertes Code-Editing ist

Deshalb veröffentlicht Aider eigene Leaderboards und verweist darauf.

8. Die wichtigsten In-Chat-Befehle​

Aider hat eine große Befehlsoberfläche, aber einige Befehle sind für die tägliche Arbeit deutlich wichtiger als der Rest:

BefehlWofĂĽr du ihn verwendest
/addDateien zum bearbeitbaren Kontext hinzufĂĽgen
/dropDateien entfernen und Kontext freigeben
/askFragen stellen, ohne zu editieren
/codeZurĂĽck in den Editiermodus wechseln
/architectArchitect-/Editor-Modus mit getrennten Modellen verwenden
/modelDas Hauptmodell wechseln
/weak-modelDas schwächere Hilfsmodell wechseln
/mapDie aktuelle Repo-Map ausgeben
/lintLinting auf Chat-Dateien oder geänderten Dateien ausführen
/testEinen Test-Befehl ausfĂĽhren und Fehler zurĂĽckspeisen
/runShell-Befehle ausfĂĽhren und optional die Ausgabe teilen
/undoDen letzten Aider-Commit rückgängig machen

Gutes mentales Modell​

Stell dir Aider als chatgesteuerte Coding-Schleife mit vier wiederkehrenden Aktionen vor:

  1. die richtigen Dateien hinzufĂĽgen
  2. um die Ă„nderung bitten
  3. den Diff prĂĽfen
  4. nach Bedarf linten/testen/rückgängig machen

9. Linting und Testing​

Aider kann Code automatisch linten und testen, nachdem es Dateien bearbeitet hat.

Linting​

Die offizielle Doku besagt, dass Aider eingebaute Linter für viele gängige Sprachen enthält. Du kannst auch deinen eigenen Lint-Befehl festlegen:

aider --lint-cmd "eslint"

Oder konfiguriere sprachspezifische Linter mit --lint.

Testing​

Du kannst Tests manuell ausfĂĽhren:

/test pytest -q

Oder konfiguriere Aider so, dass es sie nach Ă„nderungen automatisch ausfĂĽhrt:

  • --test-cmd
  • --auto-test

Warum das wichtig ist​

Das ist eine der Funktionen, die Aider eher wie ein Entwickler-Workflow-Tool wirken lassen und weniger wie einen reinen Chat-Wrapper.

10. Konfiguration mit .aider.conf.yml​

Aider unterstĂĽtzt eine YAML-Konfigurationsdatei namens .aider.conf.yml.

Die Doku besagt, dass Aider an folgenden Orten nach der Konfiguration sucht:

  • deinem Home-Verzeichnis
  • dem Repo-Root
  • dem aktuellen Verzeichnis

Später geladene Dateien haben Vorrang.

Nützliche Einstellungen für Entwickler​

Dies sind einige der praktischsten Optionen aus der offiziellen Konfigurationsreferenz:

  • model
  • weak-model
  • editor-model
  • api-key
  • map-tokens
  • auto-commits
  • auto-lint
  • test-cmd
  • auto-test
  • read
  • vim
  • chat-language
  • notifications

Beispiel​

model: sonnet
api-key:
  - anthropic=YOUR_KEY
read:
  - CONVENTIONS.md
  - ARCHITECTURE.md
auto-commits: true
auto-lint: true
test-cmd: pytest -q
auto-test: true
map-tokens: 2048

Hier wird Aider teamtauglich: Du kannst Konventionen, Test-Befehle und Workflow-Defaults im Repo verankern.

11. Best Practices​

Basierend auf der offiziellen Doku sind dies die aussagekräftigsten Gewohnheiten:

1. Füge nur die für die Aufgabe nötigen Dateien hinzu​

Das ist wahrscheinlich die wichtigste Aider-Gewohnheit überhaupt. Sie hält den Kontext sauber und Änderungen präziser.

2. Lass Git die Sicherheitsarbeit machen​

Setze auf Aiders Commit-basierten Workflow:

  • prĂĽfe Diffs häufig
  • nutze /undo beherzt
  • halte Aufgaben klein genug, damit einzelne Commits verständlich bleiben

3. Gib ihm die Projektkonventionen von Anfang an​

Verwende read: in .aider.conf.yml oder fĂĽge schreibgeschĂĽtzte Dateien hinzu wie:

  • CONTRIBUTING.md
  • CONVENTIONS.md
  • Architektur-Notizen
  • Coding-Standards

4. Binde Lint und Tests früh ein​

Wenn Aider regelmäßig Code bearbeiten soll, verbinde es mit echter Validierung, anstatt dich nur auf das Selbstvertrauen des Chats zu verlassen.

5. Verwende stärkere Modelle für Änderungen, günstigere für unterstützende Aufgaben, wo es sinnvoll ist​

Aider trennt Haupt- und Hilfsrollen, sodass Spielraum bleibt, Kosten und Qualität auszubalancieren.

6. Nutze /ask und /architect bewusst​

Nicht jeder Schritt sollte direktes Editieren sein. Manchmal liefert das Planen vor dem Ă„ndern von Code bessere Ergebnisse und kleinere Diffs.

12. Wo Aider am stärksten ist​

Aider passt besonders gut, wenn du Folgendes willst:

  • einen Terminal-first-Coding-Agent
  • explizite Git-Historie und RĂĽckgängig-Machbarkeit
  • die Freiheit, verschiedene LLM-Anbieter zu wählen
  • ein Tool, das in bestehenden Codebasen gut funktioniert
  • einen Workflow, der nah an normalen Entwicklergewohnheiten bleibt

Es ist besonders gut fĂĽr:

  • Bugfixes
  • fokussierte Refactorings
  • testgestĂĽtzte Ă„nderungen
  • Remote-Server- oder SSH-Workflows
  • kostensensitives Experimentieren ĂĽber mehrere Modelle hinweg

13. Wo Aider schwächer ist​

Aider ist nicht fĂĽr jedes Team der ideale Standard.

Es könnte weniger überzeugend sein, wenn du Folgendes willst:​

  • zuerst ein poliertes, grafisch IDE-natives Erlebnis
  • tiefe Editor-UI-Funktionen wie Inline-Widgets und reichhaltige Panels
  • einen Cloud-Agent, der asynchron PRs öffnet, ohne lokales Setup
  • einen stark gefĂĽhrten Produkt-Workflow statt eines flexiblen Shell-Tools

In diesen Fällen könnten sich Tools wie:

  • Cursor
  • GitHub Copilot Agent Mode
  • Claude Code im IDE-Modus
  • Cloud-Coding-Agents

unmittelbar ergonomischer anfĂĽhlen.

14. Aider vs. andere Coding-Agents​

Aider vs. Claude Code​

  • Claude Code ist enger mit Anthropics Agent-Stack und Modellfähigkeiten integriert.
  • Aider ist anbieterflexibler und ausdrĂĽcklich stärker Git-zentriert.

Aider vs. Codex CLI​

  • Codex CLI passt am besten, wenn du im OpenAI-Ă–kosystem bleiben willst.
  • Aider passt besser, wenn du Modelle und Anbieter frei wechseln willst.

Aider vs. Cursor oder Copilot​

  • Cursor/Copilot sind stärker Editor-nativ.
  • Aider ist besser fĂĽr Entwickler, die Terminal-Workflows und transparente Git-Operationen bevorzugen.

Empfehlung​

Aider ist einer der ausgereiftesten quelloffenen Terminal-Coding-Agents, die heute verfĂĽgbar sind. Es ist nicht die schickste Option, aber eine sehr praktische.

Wähle Aider, wenn du Folgendes willst:

  • Terminal-first-Pair-Programming
  • starke Git-Ergonomie
  • repo-bewusstes Code-Editing
  • Modell-/Anbieter-Flexibilität
  • Lint-/Test-Schleifen im selben Workflow

Wenn dein Team sich in der Shell wohlfühlt und expliziten Kontrolle über Automatisierung schätzt, ist Aider eine sehr starke Option.

Quellen​