Zurück zum Blog

Tools & IntegrationenAnleitung

Aider-Konfigurationsdatei für deinen eigenen API-Schlüssel: .aider.conf.yml und Windows setx

Behalte deinen eigenen API-Schlüssel und die Basis-URL in .aider.conf.yml, triff die richtige Ladereihenfolge und vermeide die Windows-setx-Falle, mit einer Kostenschätzung für eine Sitzung.

Von CheapTokens TeamVeröffentlicht am 3 Min. Lesezeit

Terminal mit den Befehlen, die Aider mit einer OpenAI-kompatiblen API verbinden
Auf dieser Seite
  1. Windows: setx und ein neues Terminal
  2. Welches Modell für welche Änderungen
  3. Eine erste Änderung ausführen
  4. Schluss mit dem Neutippen: .aider.conf.yml
  5. Was eine Sitzung kostet
  6. Wenn es nicht funktioniert

Zwei Variablen, OPENAI_API_BASE und OPENAI_API_KEY, und ein Modell-Argument wie openai/<model id> genügen, um Aider auf CheapTokens zu zeigen. Die Schritt-für-Schritt-Grundlagen (Installation, erste Anfrage, 401/404/400/402) stehen in How to connect Aider to CheapTokens; diese Seite behandelt, was dieser Leitfaden auslässt: Windows setx, die Konfigurationsdatei und ihre Ladereihenfolge sowie eine Kostenschätzung für eine Sitzung.

Quelle: Aiders Dokumentation für OpenAI-kompatible APIs (Seite geprüft am 26. Oktober 2026; die Dokumentation zeigt kein Datum und keine Version, und die neueste aider-chat auf PyPI war an diesem Tag 0.86.2).

Windows: setx und ein neues Terminal#

Auf Mac und Linux export du die beiden Variablen. Unter Windows (PowerShell oder cmd) verwendest du setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Unter Windows gibt es einen Haken. setx schreibt die Variablen für zukünftige Sitzungen, nicht für die, in der du gerade tippst, also schließe das Terminal und öffne ein neues, bevor du Aider startest. Wenn du die Variablen setzt und Aider trotzdem nach einem Schlüssel fragt, ist das der übliche Grund.

Welches Modell für welche Änderungen#

Das Modell-Argument ist openai/ plus die vollständige ID, für CheapTokens hat es also zwei Schrägstriche:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 hat einen Kontext von 180K und antwortet mit bis zu 8.192 Tokens, passend für kleine und mittlere Änderungen, bei denen die Antworten kurz bleiben. Wenn deine Änderungen als lange Diffs zurückkommen, ist das andere Modell, das einen Versuch wert ist, DeepSeek-V4-Flash: bis zu 32.768 Tokens pro Antwort, ein Kontext von 380K und ein Preis zu jeder Tageszeit.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Kopiere die vollständige ID aus der CheapTokens-Dokumentation oder der Modellliste auf pricing.

Eine erste Änderung ausführen#

Aider arbeitet in einem Git-Repo, also starte in einem. Füge eine Datei hinzu und frage nach etwas Kleinem:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Wenn Aider mit einer Änderung an der Datei antwortet, stimmen Schlüssel, Basis-URL und Modell-ID alle.

Die falsche Modell-ID neben der vollständigen ID, die funktioniert, dann die erste Änderung
Falsche ID versus vollständige ID und die erste Anfrage

Schluss mit dem Neutippen: .aider.conf.yml#

Aider liest .aider.conf.yml aus deinem Home-Verzeichnis, dann aus dem Git-Repo-Root, dann aus dem aktuellen Verzeichnis, und spätere Dateien gewinnen. Eine globale Datei kann also den Schlüssel und die Basis enthalten, und eine Repo-Datei kann das Modell wählen. Wenn du genau eine bestimmte Datei und nichts anderes willst, lädt aider --config <file> nur diese.

Eine Datei im Home-Verzeichnis (Beispiel, setze deinen eigenen Schlüssel ein):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Jetzt startet aider allein mit dem richtigen Endpunkt und Modell. Wenn du die Datei in ein Repo committest, lass den Schlüssel weg und behalte ihn in der Umgebungsvariable oder in einer .env-Datei; die Schlüsselzeilen sind für dein eigenes Home-Verzeichnis gedacht.

Für ein Modell, das Aider nicht kennt, beschreibt die Dokumentation ein model-settings-file (.aider.model.settings.yml), in dem du seine Einstellungen angeben kannst.

Was eine Sitzung kostet#

Aider sendet die von dir hinzugefügten Dateien und den Chat-Verlauf mit jeder Nachricht erneut, sodass die Input-Tokens schneller wachsen als die Output-Tokens. Nehmen wir an, eine Arbeitssitzung mit etwa 20 Nachrichten sendet 400.000 Input-Tokens und erhält 40.000 Output-Tokens zurück (eine Annahme für das Beispiel; setze deine eigenen Zahlen ein). Bei MiniMax-M2.7 sind das $0.026, und insgesamt günstiger als OpenRouter, wenn Input und Output zusammen gezählt werden. Die Tabelle unten führt dieselbe Sitzung über unsere Modelle aus:

Modell Kosten OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400.000 Input- und 40.000 Output-Tokens insgesamt. Die Preise pro 1 Mio. Tokens sind aktuell und ändern sich zusammen mit unseren Tarifen; die OpenRouter-Spalte zeigt Referenzpreise für dieselbe Arbeitslast.

Wie du die Input-Seite klein hältst (schreibgeschützte Dateien, /drop, Größe der Repo-Map), steht in How much does Aider cost. Aktuelle Preise findest du immer auf der pricing page.

Wenn es nicht funktioniert#

  • Aider fragt nach einem API-Schlüssel oder spricht mit dem falschen Dienst. Die Variablen sind für den Prozess nicht sichtbar. Starte unter Windows das Terminal nach setx neu; führe auf Mac und Linux echo $OPENAI_API_BASE in derselben Shell aus.
  • Deine Konfiguration scheint ignoriert zu werden. Denk an die Reihenfolge: Home, Repo-Root, aktuelles Verzeichnis. Eine Datei, die näher bei dir liegt, überschreibt die globale.
  • Modell nicht gefunden, 404 oder ein Authentifizierungsfehler. Diese werden in How to connect Aider to CheapTokens behandelt.

Dieselbe OpenAI-kompatible Adresse funktioniert in anderen Tools; wenn du auch einen Editor-Agenten verwendest, siehe connecting OpenCode oder die Übersicht dazu, wo du deinen eigenen API-Schlüssel einfügst.