Aider installieren und mit OmniProxy konfigurieren

Aider ist ein Tool, das dich beim Ändern von Code im Terminal unterstützt. Es erstellt eine Übersicht über das gesamte Code-Repository, damit das Modell auch größere Projekte besser versteht. Git ist ein Versionsverwaltungssystem, das Codeänderungen protokolliert und dazu dient, Unterschiede anzuzeigen oder Änderungen wiederherzustellen. Nachdem du Aider eine Aufgabe gegeben hast, bearbeitet es sie schrittweise und erstellt eine Commit-Beschreibung. Wenn dir eine Änderung nicht gefällt, kannst du sie mit /undo rückgängig machen.

Vor der Installation

Es gibt zwei übliche Installationswege:

• Auf dem Computer ist bereits Python 3.8 bis 3.13 installiert: Installiere zuerst aider-install. Python ist die Laufzeitumgebung, die Aider benötigt.
• Es ist keine geeignete Python-Version vorhanden: Verwende den Einzeiler zur Installation. Bei Bedarf wird dabei auch Python 3.12 eingerichtet.

Mac und Linux

install.sh

• Nach curl mit sh ausführen
• Installiert bei Bedarf Python
• Ohne curl kann wget verwendet werden

Windows

install.ps1

• Mit PowerShell ausführen
• Terminal nach der Installation neu öffnen
• Umgebungsvariablen mit setx setzen

Python bereits vorhanden

aider-install

• Zuerst dieses Paket mit pip installieren
• Dann aider-install ausführen
• Erstellt eine eigene Umgebung

Stelle sicher, dass OmniProxy läuft. Wechsle nach Abschluss der Installation zunächst in das Projektverzeichnis, das du bearbeiten möchtest, und starte dann Aider.

Installieren und zum ersten Mal starten

Python 3.8 bis 3.13 ist bereits installiert

Führe die folgenden Befehle nacheinander aus:

python -m pip install aider-install
aider-install

aider-install installiert Aider in einer separaten Python-Umgebung, damit es nicht mit anderen Python-Projekten auf dem Computer vermischt wird. Bei Bedarf installiert es zusätzlich Python 3.12 für Aider.

Installation per Einzeiler

Führe auf Mac und Linux Folgendes aus:

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

Wenn curl auf dem Computer nicht vorhanden ist, kannst du stattdessen Folgendes verwenden:

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

Führe in Windows PowerShell Folgendes aus:

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

Diese Einzeiler basieren auf uv. uv ist ein Programm zum Installieren und Verwalten von Python-Tools und -Umgebungen. Alternativ kannst du auch den folgenden Befehl verwenden:

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

Außerdem kann pipx verwendet werden. Bei einer direkten Installation mit python -m pip install aider-chat werden Python-Versionen von 3.9 bis 3.12 unterstützt. Dies gilt jedoch als alternative Installationsmethode; verwende bevorzugt die zuvor beschriebenen Methoden. Bei Aider-Paketen aus den Paketverwaltungen des Betriebssystems kann es zu nicht passenden Abhängigkeiten kommen, weshalb diese nicht die bevorzugte Installationsmethode sein sollten.

Am 2026-10-09 wurde mit dem Einzeiler Aider v0.86.2 installiert. Falls während der Installation gemeldet wird, dass Cache und Ziel nicht auf demselben Laufwerk liegen und Dateien deshalb kopiert werden, wird die Installation trotzdem abgeschlossen.

Wechsle nach Abschluss der Installation in das Projektverzeichnis. Eine kompatible API ist eine Schnittstelle, die im OpenAI-Format mit anderen Modelldiensten kommuniziert. Der Startbefehl hat folgende Form:

aider --model openai/<model-name>

Ersetze <model-name> durch die vollständige Modell-ID, die du im nächsten Abschnitt aus OmniProxy kopierst. Die Modell-ID ist der Name, mit dem ein Modell eindeutig ausgewählt wird.

Verbindungsparameter aus OmniProxy abrufen

Die folgenden beiden Umgebungsvariablen müssen gesetzt werden. Umgebungsvariablen sind Verbindungseinstellungen, die von Programmen im Terminal gelesen werden:

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

OPENAI_API_BASE ist die API-Adresse und muss bis einschließlich /v1 angegeben werden. OPENAI_API_KEY ist der Schlüssel für den Zugriff auf die API.

Unter Windows speicherst du die Variablen mit setx. Danach musst du das Terminal neu öffnen:

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

Kopiere den Modellnamen vollständig aus der aktuellen Modellliste von OmniProxy. Schrägstriche in der Modell-ID müssen erhalten bleiben. Beim Start von Aider setzt du zusätzlich openai/ vor die vollständige ID.

Am 2026-10-09 waren die beiden Vergleichs-IDs in der Dokumentation der Anbieter gemini-3.8-flash und grok-4.7. Wenn diese Namen nicht in der aktuellen Liste vorhanden sind, kopiere sie nicht unverändert, sondern verwende eine vollständige ID, die tatsächlich in der Liste aufgeführt ist.

Adresse

OPENAI_API_BASE

• Auf OmniProxy verweisen
• Bis einschließlich /v1 angeben
• Nicht im Repository speichern

Schlüssel

OPENAI_API_KEY

• Den vom Gateway erhaltenen verwenden
• Unter Windows danach neu öffnen
• Anbieterschlüssel bleiben im Gateway

Start

openai/Modell

• Mit cd ins Projektverzeichnis wechseln
• Dem Modellnamen openai/ voranstellen
• Name muss der Gateway-Liste entsprechen

Tool konfigurieren

Hier musst du keine zusätzliche Konfigurationsdatei erstellen. Wechsle zuerst in das Projektverzeichnis und starte anschließend Aider. Ersetze dabei die Modell-ID durch einen Namen, der tatsächlich in der aktuellen OmniProxy-Liste vorhanden ist:

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

Um stattdessen das andere Beispielmodell zu verwenden, führe Folgendes aus:

aider --model openai/grok-4.7

Wenn Aider ein Modell nicht kennt, zeigt die Oberfläche eine Warnung an. Diese Warnung bedeutet nicht automatisch, dass die Adresse falsch ist. Prüfe in den Aufrufprotokollen von OmniProxy, ob die Anfrage dort eingegangen ist.

Aider nimmt nur Dateien in den Kontext auf, die bereits von Git verfolgt werden. Der Kontext umfasst den Code und die Informationen, die das Modell während der aktuellen Aufgabe lesen kann. Wenn das aktuelle Verzeichnis noch kein Git-Repository ist, erstellt Aider selbst eines. Dateien, die nicht von Git verfolgt werden, können jedoch weiterhin nicht gelesen werden. Füge die Dateien daher zuerst mit git add hinzu, committe sie und starte anschließend Aider.

Aider kann Dateien weiterhin ändern. --no-auto-commits deaktiviert lediglich automatische Commits und verhindert nicht, dass Dateien geändert werden. Verwende beim ersten Test möglichst ein unwichtiges Repository und führe nach Abschluss der Aufgabe git diff aus, um die tatsächlichen Änderungen zu prüfen.

Schreibe keine echten Schlüssel in Projektdateien oder auf öffentlich zugängliche Seiten. Schlüssel des Anbieters gehören ausschließlich in OmniProxy. Wenn das Gateway den Schlüssel nicht überprüft, kannst du für OPENAI_API_KEY eine Platzhalterzeichenfolge eintragen, die nur lokal verwendet wird.

Mit einer echten Aufgabe überprüfen

Vergewissere dich zuerst, dass die zu lesende Datei bereits in Git committed wurde. Führe danach den folgenden Befehl im Projektverzeichnis aus. Ersetze die Modell-ID durch die vollständige ID aus der aktuellen OmniProxy-Liste:

aider --model openai/gemini-3.8-flash --message "Was steht in der ersten Zeile dieser Datei? Ändere die Datei nicht." --no-auto-commits

Mit --message übergibst du Aider direkt eine einzelne Aufgabe. --no-auto-commits bedeutet, dass bei diesem Durchlauf keine automatischen Git-Commits erstellt werden sollen.

Am 2026-10-09 wurde mit Aider v0.86.2 die erste Zeile einer verfolgten Datei erfolgreich ausgelesen. Wenn die Datei noch nicht von Git verfolgt wird, antwortet Aider, dass der Inhalt nicht sichtbar ist. Das bedeutet nicht, dass die API-Adresse falsch ist. Prüfe nach der Anfrage zusätzlich in den Aufrufprotokollen von OmniProxy die Herkunft der Anfrage und die Modell-ID.

Start

aider lässt sich starten

• Befehl wird gefunden
• Umgebungsvariablen sind aktiv
• Im Projektverzeichnis bleiben

Aufgabe

Datei wurde gelesen

• Nach einer bestimmten Datei fragen
• Erklärung dazu prüfen
• Bei unbekannten Modellen erscheint eine Warnung

Protokoll

Im Gateway sichtbar

• Quelle ist Aider
• Modell-ID stimmt überein
• Schlüssel ist nicht auf der Seite gelandet

Häufige Fehler

• aider wird nicht gefunden: Öffne zuerst das Terminal neu. Bei einer direkten Installation mit pip kannst du python -m aider ausprobieren.
• Windows verbindet sich nach dem Ändern der Variablen weiterhin mit der alten Adresse: Nach der Ausführung von setx musst du das Terminal neu öffnen. Erst ein neues Fenster liest die aktualisierten Variablen ein.
• Vor dem Modellnamen fehlt openai/: Für die kompatible API ist die Schreibweise openai/<model-name> erforderlich.
• Es erscheint eine Warnung zu einem unbekannten Modell: Dies ist ein normaler Hinweis und bedeutet nicht, dass die Verbindung fehlgeschlagen ist. Prüfe anschließend, ob OmniProxy die Anfrage empfangen hat.
• Die Modell-ID ist ungültig: Kopiere die vollständige ID erneut aus der aktuellen OmniProxy-Liste. Behalte sowohl das Präfix openai/ als auch alle vorhandenen Schrägstriche in der ID bei.
• Aider meldet, dass kein Dateiinhalt vorhanden ist: Prüfe zuerst, ob die Datei bereits von Git verfolgt wird. Ein leeres Repository oder nicht verfolgte Dateien werden nicht in den Kontext aufgenommen.

Offizielle Referenzen

Die Installationsschritte findest du unter Aider installation. Informationen zu den Umgebungsvariablen und zum Modellpräfix findest du unter OpenAI compatible APIs. Die in den Beispielen verwendeten Modell-IDs kannst du in der Gemini-Modellliste und auf der xAI-Modellseite nachschlagen.

Ersetze jeden Platzhalter durch Werte aus deiner OmniProxy-Konfiguration. Veröffentliche niemals einen echten Schlüssel.

Ein gespeichertes Ergebnis oder HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Prüfe Quelle und Modell im OmniProxy-Aufrufprotokoll.

Offizielle Quellen · Aider ↗