Aider-Installation und OmniProxy-Konfiguration

Aider ist ein Tool, das bei der Bearbeitung von Code über das Terminal hilft. Es erstellt eine Übersicht der gesamten Codebasis, damit das Modell auch größere Projekte versteht. Git ist ein Versionskontrollsystem, das Codeänderungen aufzeichnet, sodass Sie Unterschiede prüfen und frühere Versionen wiederherstellen können. Nachdem Sie Aider eine Aufgabe erteilt haben, verarbeitet es diese schrittweise und schreibt Commit-Nachrichten. Wenn Ihnen die Änderungen nicht gefallen, können Sie diese rückgängig machen mit /undo.

Vorbereitung

Es gibt zwei gängige Installationsoptionen:

• Falls auf Ihrem Computer bereits Python 3.8 bis 3.13 installiert ist, installieren Sie aider-install zuerst. Python ist die für Aider erforderliche Laufzeitumgebung.

Mac und Linux

install.sh

• Mit sh nach curl ausführen
• Installiert Python bei Bedarf
• Verwenden Sie wget, falls curl nicht verfügbar ist

Windows

install.ps1

• In PowerShell ausführen
• Terminal nach der Installation neu starten
• Umgebungsvariablen mit setx setzen

Python bereits installiert

aider-install

• Installieren Sie dieses Paket zuerst mit pip
• Führen Sie dann aider-install aus
• Erstellt eine eigene Umgebung

Stellen Sie sicher, dass OmniProxy läuft. Wechseln Sie nach der Installation in das Projektverzeichnis, das Sie bearbeiten möchten, bevor Sie Aider starten.

Installation und erster Start

Falls Sie bereits Python 3.8 bis 3.13 installiert haben

Führen Sie diese Befehle nacheinander aus:

python -m pip install aider-install
aider-install

aider-install installiert Aider in einer separaten Python-Umgebung, damit es andere Python-Projekte auf Ihrem Computer nicht beeinträchtigt. Bei Bedarf wird auch Python 3.12 für Aider installiert.

Ein-Zeilen-Installation

Führen Sie auf Mac und Linux Folgendes aus:

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

Falls curl nicht installiert ist, verwenden Sie:

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

Führen Sie in der Windows PowerShell Folgendes aus:

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

Diese Ein-Zeilen-Befehle basieren auf uv, einem Programm zur Installation und Verwaltung von Python-Tools und -Umgebungen. Sie können auch den folgenden Befehl verwenden:

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

Sie können auch pipx verwenden. Bei der direkten Installation mit python -m pip install aider-chatsind die unterstützten Python-Versionen 3.9 bis 3.12. Dies ist jedoch eine alternative Installationsmethode; bevorzugen Sie die oben beschriebenen Wege. Aider-Pakete aus System-Paketmanagern können Abhängigkeitskonflikte aufweisen und sollten daher nicht die erste Wahl sein.

Am 09.10.2026 installierte der Ein-Zeilen-Befehl Aider v0.86.2. Während der Installation erhalten Sie möglicherweise den Hinweis, dass sich Cache und Ziel auf unterschiedlichen Datenträgern befinden und Dateien kopiert werden. Die Installation wird dennoch erfolgreich abgeschlossen.

Wechseln Sie nach der Installation in das Projektverzeichnis. Eine kompatible API ist eine Schnittstelle, die mit anderen Modelldiensten im OpenAI-Format kommuniziert. Starten Sie Aider nach diesem Muster:

aider --model openai/<model-name>

Ersetzen Sie <model-name> durch die vollständige Modell-ID, die Sie im nächsten Abschnitt aus OmniProxy kopieren. Eine Modell-ID ist der Name, der zur präzisen Identifizierung eines Modells verwendet wird.

Verbindungseinstellungen von OmniProxy abrufen

Sie müssen die folgenden zwei Umgebungsvariablen festlegen. Umgebungsvariablen können als eine Reihe von Verbindungseinstellungen betrachtet werden, die von Terminalprogrammen gelesen werden:

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

OPENAI_API_BASE ist der API-Endpunkt; die Adresse muss /v1 enthalten. OPENAI_API_KEY ist der Schlüssel für den API-Zugriff.

Verwenden Sie unter Windows setx um die Variablen zu speichern. Sie müssen das Terminal danach neu starten:

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

Kopieren Sie den vollständigen Modellnamen aus der aktuellen OmniProxy-Liste, einschließlich etwaiger Schrägstriche in der Modell-ID. Fügen Sie beim Starten von Aider openai/ vor die vollständige ID. gemini-3.8-flash Stand 09.10.2026 sind die beiden Referenz-IDs in der Anbieterdokumentation grok-4.7und . Falls diese Namen nicht in der aktuellen Liste stehen, kopieren Sie sie nicht direkt. Verwenden Sie eine vollständige ID, die tatsächlich in der Liste erscheint.

Adresse

OPENAI_API_BASE

• Auf OmniProxy verweisen
• /v1 einfügen
• Nicht im Repository speichern

Schlüssel

OPENAI_API_KEY

• Den vom Gateway bereitgestellten Schlüssel verwenden
• Windows-Terminals nach Änderungen neu starten
• Anbieterschlüssel im Gateway behalten

Start

openai/modell

• In das Projektverzeichnis wechseln (cd)
• Modellnamen mit openai/ präfixieren
• Namen aus der Gateway-Liste verwenden

Tool-Konfiguration eingeben

Sie müssen keine separate Konfigurationsdatei erstellen. Wechseln Sie in das Projektverzeichnis, starten Sie Aider und ersetzen Sie die Modell-ID durch einen Namen, der tatsächlich in der aktuellen OmniProxy-Liste existiert:

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

Um das andere Beispielmodell zu verwenden, führen Sie aus:

aider --model openai/grok-4.7

Wenn Aider auf ein unbekanntes Modell stößt, wird eine Warnung angezeigt. Diese Warnung bedeutet nicht zwangsläufig, dass der Endpunkt falsch ist. Überprüfen Sie die Anfrageprotokolle von OmniProxy, um zu bestätigen, ob die Anfrage eingegangen ist.

Aider fügt nur Dateien zum Kontext hinzu, die bereits von Git verfolgt werden. Der Kontext ist der 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 eines, aber Dateien, die nicht von Git verfolgt werden, können weiterhin nicht gelesen werden. Verwenden Sie git add um die Dateien hinzuzufügen und zu committen, bevor Sie Aider starten.

Aider kann Dateien dennoch bearbeiten. --no-auto-commits deaktiviert nur automatische Commits; es verhindert nicht die Dateibearbeitung. Wählen Sie bei der ersten Verwendung von Aider ein unwichtiges Repository und führen Sie git diff nach der Aufgabe aus, um die tatsächlichen Änderungen zu überprüfen.

Speichern Sie keine echten Schlüssel in Projektdateien oder auf öffentlichen Seiten. Speichern Sie Anbieterschlüssel nur in OmniProxy. Wenn das Gateway keine Schlüssel validiert, können Sie OPENAI_API_KEY auf einen Platzhalter-String setzen, der nur auf Ihrem lokalen Computer verwendet wird.

Mit einer echten Aufgabe verifizieren

Stellen Sie zunächst sicher, dass die Datei, die Aider lesen soll, in Git committet wurde. Führen Sie dann den folgenden Befehl aus dem Projektverzeichnis aus. Ersetzen Sie die Modell-ID durch eine vollständige ID aus der aktuellen OmniProxy-Liste:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message sendet eine Aufgabe direkt an Aider, während --no-auto-commits Aider anweist, während dieses Durchlaufs keine Git-Commits automatisch zu erstellen.

Am 09.10.2026 konnte Aider v0.86.2 die erste Zeile einer verfolgten Datei erfolgreich lesen. Wenn die Datei nicht von Git verfolgt wird, meldet Aider, dass es den Inhalt nicht sehen kann. Dies bedeutet nicht, dass der API-Endpunkt falsch ist. Überprüfen Sie nach Abschluss der Abfrage die Anfrageprotokolle von OmniProxy, um die Anfragenquelle und die Modell-ID zu verifizieren.

Start

Aider startet

• Befehl ist verfügbar
• Umgebungsvariablen sind aktiv
• Im Projektverzeichnis

Aufgabe

Datei wurde inspiziert

• Nach einer bestimmten Datei fragen
• Erklärung überprüfen
• Unbekannte Modelle können eine Warnung auslösen

Protokolle

Im Gateway sichtbar

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

Häufige Fehler

• aider nicht gefunden: Starten Sie zuerst das Terminal neu. Falls Sie es direkt mit pip installiert haben, versuchen Sie python -m aider.
• Windows verbindet sich nach dem Ändern der Variablen immer noch mit dem alten Endpunkt: Sie müssen das Terminal nach dem Ausführen von setxneu starten. Nur ein neues Fenster liest die aktualisierten Variablen.
• Der Modellname beginnt nicht mit openai/: Die kompatible API erfordert das Format openai/<model-name>.
• Warnung wegen unbekanntem Modell erscheint: Dies ist eine normale Warnung und bedeutet nicht, dass die Verbindung fehlgeschlagen ist. Prüfen Sie, ob OmniProxy die Anfrage erhalten hat.
• Die Modell-ID ist ungültig: Kopieren Sie die vollständige ID erneut aus der aktuellen OmniProxy-Liste. Behalten Sie das openai/ Präfix und alle bereits vorhandenen Schrägstriche in der ID bei.
• Aider meldet, dass kein Dateiinhalt vorhanden ist: Stellen Sie sicher, dass die Datei von Git verfolgt wird. Dateien in einem leeren Repository oder nicht verfolgte Dateien werden nicht zum Kontext hinzugefügt.

Offizielle Referenzen

Für Installationsschritte siehe Aider-Installation. Für Umgebungsvariablen und das Modell-Präfix siehe OpenAI-kompatible APIs. Die Beispiel-Modell-IDs finden Sie in der Gemini-Modellliste und auf der xAI-Modellseite.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · Aider ↗