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.

Installieren API-Schlüssel verbinden Erste Repo-Änderung

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.

01

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.

02

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.

03

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. 1

    aider-chat installieren

    Der PyPI-Name ist aider-chat, nicht das nackte Paket aider. Typisch: python3 -m pip install aider-chat. Isoliert: pipx install aider-chat oder uv tool install --python python3.12 aider-chat. Prüfen mit aider --help.

  2. 2

    API-Schlüssel verbinden

    In der Shell export OPENAI_API_KEY=… oder export ANTHROPIC_API_KEY=…. Für Wiederholungen dieselben Namen in eine Root-.env und gitignoren. aider --list-models zeigt erkannte Anbieter. Modell-IDs: aider.chat/docs/llms.html.

  3. 3

    Erste Repo-Änderung

    Ins Repository wechseln, aider README.md starten. 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.

0
Zusätzliche IDE nötig
2
Übliche Schlüsselvariablen
1
Erster Prompt
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

MethodeAbrechnungBesser für
OPENAI_API_KEYOpenAI-Platform-TarifeGPT lokal am Repo
ANTHROPIC_API_KEYAnthropic-VerbrauchClaude lokal am Repo
Root-.envGleicher SchlüsselWiederholte lokale Sitzungen
Es muss schon Git sein
Aider nutzt Git für Kontext und Commits. In einem leeren Ordner git init und 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.

Raum kostenlos erstellen