Coding Agents einrichten

Aider einrichten: API Key, Base URL und Modelle

Installiere Aider, konfiguriere die BetterToken Base URL und API Key, wähle ein verfügbares Modell und behebe häufige Fehler. Praktische Hinweise.

Um Aider mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

Die aktuelle Version des Tools ist installiert
Ein BetterToken API Key: Registriere dich und erhalte einen
Eine Model ID aus der model plaza

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

Installiere Python

Installation

Aider installieren

Führe die folgenden Befehle in einem Terminal aus:

python -m pip install aider-install
aider-install

Bestätige nach der Installation, dass Aider verfügbar ist:

aider --help

Manuelle Konfiguration

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

BetterToken für das aktuelle Terminal konfigurieren

macOS / Linux

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

Windows PowerShell

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

Schließe PowerShell nach setx und öffne es erneut. Wechsle dann in dein Projektverzeichnis und führe Folgendes aus:

aider --model openai/YOUR_MODEL_ID

Ersetze YOUR_API_KEY durch deinen BetterToken API Key. YOUR_MODEL_ID ist nur ein Beispiel. Ersetze ihn durch eine aktuelle Model ID aus der model plaza und behalte das Präfix openai/ bei.

Konfiguration mit .env speichern

Damit du die Variablen nicht bei jedem Öffnen eines Terminals setzen musst, erstelle eine Datei .env im Git-Stammverzeichnis deines Projekts:

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

Füge .env zu .gitignore hinzu, damit der API Key nicht committet wird. Wechsle dann in das Projektverzeichnis und führe Folgendes aus:

aider

Um für ein Projekt eine andere Datei zu verwenden, gib sie ausdrücklich an:

aider --env-file ./aider-bettertoken.env

Optional: .aider.conf.yml verwenden

Um nur nicht sensible Einstellungen dauerhaft zu speichern, erstelle .aider.conf.yml in deinem Home- oder Projektverzeichnis:

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

Bewahre den API Key in der Umgebungsvariable OPENAI_API_KEY statt in einer gemeinsam genutzten YAML-Datei auf.

Modell ändern

Ersetze das Modell im Startbefehl durch eine aktuelle Model ID aus der model plaza:

aider --model openai/YOUR_MODEL_ID

Entferne das Präfix openai/ nicht. Die Model ID muss mit dem konfigurierten Endpunkt kompatibel sein.

Verbindung prüfen

Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

Modell wechseln

Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.

Häufige Fehler

Symptom	Vorgehen
`401`, `Unauthorized` oder `Invalid API key`	Prüfe `OPENAI_API_KEY`, bestätige, dass es ein BetterToken API Key ist, und entferne zusätzliche Leerzeichen.
`model not found` oder Modell nicht verfügbar	Kopiere eine aktuelle Model ID aus der model plaza und übergib sie an Aider als `openai/model-id`.
Falsche Request-URL oder `404`	Bestätige, dass `OPENAI_API_BASE` auf `https://bettertoken.ai/v1` gesetzt ist. Hänge nicht `/chat/completions` an.
Windows liest die neuen Variablen nicht	`setx` wirkt nur in neu geöffneten Terminals. Schließe das aktuelle PowerShell-Fenster und öffne ein neues.
Aider meldet ein unbekanntes Modell	Prüfe zuerst die Model ID und den API Provider. Aider kann für ein neues Modell eine Warnung anzeigen, du musst aber weiterhin eine aktuelle ID aus der model plaza verwenden.

Einrichtungs-FAQ

Welche Base URL soll Aider verwenden?

Verwende https://bettertoken.ai/v1. Das ist die OpenAI-kompatible Base URL von BetterToken.

Warum benötigt der Modellname das Präfix openai/?

Aider verwendet dieses Präfix, um ein OpenAI-kompatibles Modell zu erkennen. Wenn es fehlt, kann Aider den falschen Provider auswählen.

Kann ich den API Key in .aider.conf.yml speichern?

Wir empfehlen das nicht. Verwende Umgebungsvariablen oder eine von Git ignorierte Datei .env, um das Risiko zu verringern, einen API Key in Projektdateien offenzulegen.

Erweiterte Konfiguration

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.