Dokumentation

Aider

Aider liest OPENAI_API_BASE und OPENAI_API_KEY aus. Richten Sie sie auf Kunavo aus, stellen Sie der Modell-ID openai/ voran, und Claude und GPT sind nur ein --model-Argument voneinander entfernt.

Zwei Umgebungsvariablen und ein Präfix. Setzen Sie OPENAI_API_BASE auf https://api.kunavo.com/v1, OPENAI_API_KEY auf Ihren sk-kn-…-Schlüssel und starten Sie Aider dann mit --model openai/<id>. Am Repository und an der Aider-Installation müssen Sie nichts ändern.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

Das Präfix openai/ ist erforderlich, und das Suffix /v1 gehört in die Basis-URL. Ohne das Präfix löst Aider die ID anhand seiner eigenen Anbietertabelle auf — dadurch entsteht der Fehler „unbekanntes Modell“ — und ohne /v1 wird die Anfrage nicht an die richtige Route geleitet.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Exportieren Sie OPENAI_API_BASE und OPENAI_API_KEY in der Shell, aus der Sie Aider starten, oder tragen Sie sie wie unten gezeigt in ~/.aider.conf.yml ein.
Starten Sie Aider in Ihrem Repository mit aider --model openai/claude-sonnet-5.
Aider gibt beim Start das aufgelöste Modell aus. Wenn diese Zeile die angeforderte ID zeigt, ist der Endpunkt korrekt eingerichtet.

Aiders eigene Referenz dazu ist die Seite zu OpenAI-kompatiblen APIs.

Nicht in Ihrem Shell-Profil speichern

Dieselben beiden Werte lassen sich in Aiders Konfigurationsdatei speichern. Das ist sinnvoller, wenn Sie je nach Projekt zwischen Endpunkten wechseln.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Vor der Fehlersuche in Aider überprüfen

Eine Anfrage reicht aus, um festzustellen, ob der Endpunkt, der Schlüssel oder die Modellauflösung von Aider den Fehler verursacht. Gibt diese Anfrage eine JSON-Liste mit Modell-IDs zurück, funktionieren dieselbe Basis-URL und derselbe Schlüssel auch in Aider — dann bleibt nur noch das Präfix openai/ als mögliche Fehlerursache.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modelle Sie auswählen sollten

Jedes Textmodell auf Kunavo ist als openai/<id> erreichbar — die vollständige Liste finden Sie auf der Modellseite und live unter GET /v1/models. Die Preise sind in USD pro 1 Mio. Token angegeben, Eingabe/Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Einsatzbereich
`claude-haiku-4-5`	$0.70 / $3.50	Günstigstes Claude-Modell — gut für Aiders Repo-Map- und Commit-Nachrichten-Aufrufe
`claude-sonnet-5`	$1.40 / $7.00	Ausgewogenes Verhältnis zwischen Qualität und Preis für Bearbeitungen
`claude-opus-5`	$3.50 / $17.50	Claude-Stufe mit der höchsten Qualität — für Änderungen auf Architekturebene
`gpt-5-6-terra`	$0.70 / $4.20	Dieselbe Schlüssel, andere Modellfamilie — hilfreich als Zweitmeinung bei einem schwierigen Diff

Aider sendet die Repo-Map und die bearbeiteten Dateien bei jedem Austausch erneut. Daher richtet sich der Tokenverbrauch nach der Größe des Kontexts und nicht nach dem Umfang der Änderung. Deshalb ist Prompt-Caching hier der wichtigste Hebel; mit --model und --weak-model openai/claude-haiku-4-5 erhalten Sie die günstigste Aufteilung: Das leistungsstarke Modell übernimmt die Bearbeitung, das kleinere Modell verfasst Commit-Nachrichten und Zusammenfassungen. Die Abrechnung erfolgt pro Token über ein vorausbezahltes Guthaben, ohne Monatsgebühr — weitere Informationen unter Abrechnung.

Häufig gestellte Fragen

Wie verwende ich Aider mit einer OpenAI-kompatiblen API?

Setzen Sie OPENAI_API_BASE auf die Basis-URL des Endpunkts und OPENAI_API_KEY auf Ihren Schlüssel. Starten Sie Aider anschließend mit der Modell-ID, der openai/ vorangestellt ist — zum Beispiel `aider --model openai/claude-sonnet-5`. Für Kunavo lautet die Basis-URL https://api.kunavo.com/v1. Das Präfix ist zwingend erforderlich: Ohne es versucht Aider, die ID anhand seiner eigenen Anbietertabelle aufzulösen, statt sie an Ihren Endpunkt zu senden.

Kann Aider Claude-Modelle über einen OpenAI-kompatiblen Endpunkt verwenden?

Ja. Aider kommuniziert über das OpenAI-Protokoll mit dem Ziel, auf das OPENAI_API_BASE verweist. Daher ist ein in diesem Format bereitgestelltes Claude-Modell ohne Anthropic-Anmeldedaten erreichbar — die Modell-ID ist einfach ein weiterer Eintrag in der Liste unter /v1/models. Bei Kunavo laufen alle Claude- und GPT-IDs über denselben Schlüssel; zum Wechseln ändern Sie also das Argument --model statt der Konfiguration.

Warum meldet Aider, das Modell sei unbekannt?

Fast immer fehlt das Präfix openai/. Aider behandelt eine ID ohne Präfix als Modell, das es erkennen sollte, und schlägt fehl, wenn es das nicht kann; `openai/<id>` weist Aider an, die ID direkt an OPENAI_API_BASE weiterzugeben. Die zweithäufigste Ursache ist eine Basis-URL ohne das Suffix /v1, was einen Verbindungs- oder 404-Fehler statt eines Fehlers wegen eines unbekannten Modells verursacht.

Zeigt Aider die Kosten einer Sitzung an?

Aider gibt Tokenzahlen und geschätzte Kosten pro Austausch aus, berechnet anhand seiner eigenen Modellmetadaten. Bei einem benutzerdefinierten Endpunkt kann die Schätzung falsch sein, da Aider die Preise Ihres Endpunkts nicht kennt. Die Tokenzahlen sind verlässlich; die tatsächliche Belastung erfahren Sie von Ihrem Anbieter. Bei Kunavo werden die Kosten pro Anfrage in der Nutzungsansicht ausgewiesen und von einem vorausbezahlten Guthaben abgezogen; eine Monatsgebühr fällt nicht an.