Zum Hauptinhalt springen
Aider ist ein KI-Pair-Programming-Tool, das dein lokales git-Repository vom Terminal aus bearbeitet. Venice funktioniert über die OpenAI-kompatible API-Unterstützung von Aider — setze die Venice-Basis-URL und den API-Schlüssel und stelle der Modell-ID openai/ voran.

Terminal-Pair-Programming

Bearbeite dein git-Repository mit Venice-Modellen über die CLI

OpenAI-kompatibel

Verwendet Venices /chat/completions-Endpoint

Jedes Textmodell

Tausche jede Venice-Textmodell-ID ein

​
Voraussetzungen

  • Ein Venice API-Schlüssel von venice.ai/settings/api
  • Python 3.9+ auf deinem Rechner verfügbar
  • Ein git-Repository, in dem du arbeitest

​
Einrichtung

1

Aider installieren

Installiere Aider mit dem offiziellen Installer:
Siehe die Aider-Installationsdokumentation, falls du eine andere Installationsmethode bevorzugst.
2

Venice als OpenAI-Endpoint konfigurieren

Richte Aider auf Venice aus, indem du die OpenAI-kompatible Basis-URL und deinen Venice API-Schlüssel setzt.Mac / Linux:
Windows (PowerShell):
Windows (Eingabeaufforderung, persistiert):
Starte das Terminal nach setx neu, damit die neuen Variablen verfügbar sind.
3

Aider mit einem Venice-Modell starten

Stelle im Projektverzeichnis der Venice-Modell-ID openai/ voran:
Weitere gute Einstiegsmodelle:
Alle Textmodell-IDs findest du im Modell-Katalog.

​
Konfiguration mit .env persistieren

Für ein projektlokales Setup erstelle eine .env-Datei im Root deines git-Repositorys:
Starte Aider dann wie gewohnt:
Aider liest .env auch aus deinem Home-Verzeichnis. Werte im Repo-Root haben Vorrang vor Werten aus dem Home-Verzeichnis. Halte diese Datei aus git heraus — füge .env zur .gitignore hinzu, falls sie noch nicht ignoriert wird.
Du kannst auch AIDER_OPENAI_API_BASE und AIDER_OPENAI_API_KEY setzen. Die offizielle Aider-Dokumentation nennt für OpenAI-kompatible Anbieter weiterhin OPENAI_API_BASE und OPENAI_API_KEY.

​
Konfiguration mit YAML persistieren

Du kannst dieselben Einstellungen in .aider.conf.yml im Root deines Repositorys oder in deinem Home-Verzeichnis ablegen:
Führe dann aus:

​
Setup verifizieren

Frage Aider nach dem Start etwas Kleines, das belegt, dass das Modell erreichbar ist:
Wenn Endpoint und Schlüssel korrekt sind, streamt Aider eine Antwort vom ausgewählten Venice-Modell. Du kannst den API-Schlüssel auch außerhalb von Aider bestätigen:

​
Modelle auswählen

Stelle den Venice-Modell-IDs beim Start von Aider immer openai/ voran. Ohne dieses Präfix leitet Aider die Anfrage nicht über den OpenAI-kompatiblen Provider-Pfad. Aktuelle Modell-IDs zur Laufzeit ermitteln:
Oder prüfe GET /models/traits für Defaults wie text:default.

​
Konfigurationshinweise

  • Halte OPENAI_API_BASE auf https://api.venice.ai/api/v1 gesetzt. Hänge kein /chat/completions an; Aider fügt den Chat-Pfad selbst hinzu.
  • Verwende einen Venice API-Schlüssel in OPENAI_API_KEY. Nutze keinen OpenAI-Schlüssel mit der Venice-Basis-URL.
  • Aider warnt möglicherweise, dass das Modell ein unbekanntes Kontextfenster oder unbekannte Kosten hat. Diese Warnung ist für viele Venice-Modell-IDs zu erwarten und kann meist ignoriert werden. Siehe Aider Model-Warnungen.
  • Bevorzuge leistungsfähige Coding-/Reasoning-Modelle für Bearbeitungen über mehrere Dateien. Kleinere oder nicht auf Coding ausgelegte Modelle können mit den Bearbeitungsformaten von Aider Probleme haben.
Das Setzen von OPENAI_API_BASE und OPENAI_API_KEY in deiner Shell wirkt sich auch auf andere Tools aus, die diese Variablen lesen. Bevorzuge eine projektbezogene .env oder .aider.conf.yml, wenn du OpenAI anderweitig in derselben Umgebung nutzt.

​
Fehlerbehebung

Stelle sicher, dass OPENAI_API_KEY ein Venice-Schlüssel von venice.ai/settings/api ist, ohne zusätzliche Leerzeichen. Starte unter Windows nach setx das Terminal neu.
Bestätige, dass die Modell-ID im Textmodell-Katalog existiert und dass du Aider mit dem openai/-Präfix gestartet hast, zum Beispiel openai/zai-org-glm-5-1.
Prüfe, dass OPENAI_API_BASE in derselben Shell-Sitzung exakt https://api.venice.ai/api/v1 lautet. Gib es mit echo $OPENAI_API_BASE aus (oder $env:OPENAI_API_BASE in PowerShell).
Bei vielen Venice-Modellen zu erwarten. Aider fällt auf sinnvolle Defaults zurück. Um sie zu unterdrücken, füge Modell-Metadaten wie in den Aider Advanced Model Settings beschrieben hinzu.

​
Ressourcen

Venice Textmodelle

Verfügbare Venice-Modell-IDs durchsuchen

Aider OpenAI-kompatible Dokumentation

Offizielle Aider-Provider-Einrichtung

Aider-Konfiguration mit .env

API-Schlüssel und Modell-Einstellungen persistieren

Venice API-Referenz

Vollständige Endpoint- und Parameter-Dokumentation