Aider installieren und nutzen: pip/uv, API-Key, erste Änderung
Aider mit pip oder uv installieren, einen API-Schlüssel verbinden, dann eine erste Änderung im echten Git-Repository.
Gewünscht ist ein Pair-Agent, der ein lokales Git-Repo liest, einen Diff vorschlägt und Dateien ändert — ohne das Terminal zu verlassen.
Dieser Durchgang behandelt Installation und Nutzung von Aider: aider-chat mit pip, pipx oder uv, API-Schlüssel verbinden, erste Änderung im echten Repository. Schritte nach aider.chat/docs/install.html und aider.chat/docs/usage.html.
Für wen es taugt
Aider arbeitet gegen ein lokales Git-Repository: Dateien prüfen, Patches vorschlagen, nach Bestätigung schreiben, optional committen. Kein Web-Chat, keine IDE-Erweiterung nötig. Der Ordner muss bereits ein Git-Projekt sein.
Im echten Repo starten
Vor dem Start ins vorhandene Git-Projekt cd. Beim ersten Lauf ein oder zwei Dateien wie die README, eine prüfbare Zeile.
Schlüssel in der Umgebung
Offiziell: OPENAI_API_KEY oder ANTHROPIC_API_KEY. Exportieren oder in eine Root-.env legen. Nicht in den Prompt kleben, Datei nicht committen.
Commits können an sein
Nach dem Akzeptieren läuft oft git commit. Vorher Baum sauber halten und Geheimnisse in .gitignore.
Installieren, Schlüssel, erste Änderung
-
1
aider-chat installieren
Der PyPI-Name ist
aider-chat, nicht das nackte Paketaider. Typisch:python3 -m pip install aider-chat. Isoliert:pipx install aider-chatoderuv tool install --python python3.12 aider-chat. Prüfen mitaider --help. -
2
API-Schlüssel verbinden
In der Shell
export OPENAI_API_KEY=…oderexport ANTHROPIC_API_KEY=…. Für Wiederholungen dieselben Namen in eine Root-.envund gitignoren.aider --list-modelszeigt erkannte Anbieter. Modell-IDs: aider.chat/docs/llms.html. -
3
Erste Repo-Änderung
Ins Repository wechseln,
aider README.mdstarten. Eine fokussierte Änderung, etwa eine README-Zeile. Diff lesen, dann akzeptieren. Auto-Commit über den Schalter in der offiziellen Usage-Doku abschalten — Schlüssel nicht später aus der Historie klauben.
python3 -m pip install aider-chat
# pipx install aider-chat
# uv tool install --python python3.12 aider-chat
export OPENAI_API_KEY=sk-...
# export ANTHROPIC_API_KEY=sk-ant-...
cd ~/code/your-repo
aider README.md
# Add a one-line note to the README that this repo uses Aider for local edits
Was den ersten Lauf stoppt
| Methode | Abrechnung | Besser für |
|---|---|---|
| OPENAI_API_KEY | OpenAI-Platform-Tarife | GPT lokal am Repo |
| ANTHROPIC_API_KEY | Anthropic-Verbrauch | Claude lokal am Repo |
| Root-.env | Gleicher Schlüssel | Wiederholte lokale Sitzungen |
- Es muss schon Git sein
- Aider nutzt Git für Kontext und Commits. In einem leeren Ordner
git initund mindestens einen Commit, dann starten. Nicht gegen ein unversioniertes Verzeichnis testen. - .env wie ein Passwort
- Nicht committen, nicht in Tickets kleben. Liegt sie schon remote, Schlüssel in der Anbieterkonsole rotieren — die Commit-Message zu löschen reicht nicht.
- Auto-Commit nimmt den schmutzigen Baum mit
- Vor dem Akzeptieren den Staging-Umfang prüfen. Schlüssel, lokale Overrides, große Artefakte sollten schon ignore sein. Manuelle Commits: Auto-Commit laut Doku aus.
Offizielle Erinnerung: API-Aufrufe rechnen zu Anbietertarifen. Zuerst ein günstiges, kurzes Modell für den Ablauf, dann das Modell, für das Sie wirklich zahlen wollen.
Wenn der Diff gesprochen werden muss
Nach den Edits fehlt oft ein Bild: was sich geändert hat und warum es mergefähig ist. Keine extra Meeting-Suite. Kurzen Raum auf tidemeet öffnen oder Raum erstellen lesen. Canvas: Whiteboard-Grundlagen. Weiterer Terminal-Agent auf dieser Site: Codex CLI.
Fragen
Muss eine IDE-Erweiterung installiert sein?
Nein. Aider ist ein eigenständiges Terminalprogramm. Für die erste Repo-Änderung reichen Python, Git und ein gültiger API-Schlüssel.
Unterschied zwischen pip und uv?
Dasselbe Paket aider-chat. pip schreibt in den aktuellen Interpreter; pipx und uv tool legen einen isolierten Befehl an — besser für eine dauerhafte Laptop-Installation. Nutzen Sie, was schon da ist.
Soll die erste Änderung ein großes Refactoring sein?
Nein. Dateien nennen, eine prüfbare Änderung, Baum sauber, Geheimnisse ignore, Diff lesen, dann akzeptieren.
Was hat das mit einem temporären Meeting-Tool zu tun?
Keine Produktbindung. Wer nur einen Diff besprechen will, findet unter temporäre Meeting-Tools, wann ein kurzer Browserraum reicht.