Aider-Integration
Aider mit QCode.cc konfigurieren: Claude über den Anthropic-Endpunkt (Präfix anthropic/), GPT und chinesische Modelle über den OpenAI-kompatiblen Endpunkt
Auf dieser Seite
- Auf einen Blick
- 🔴 Zuerst lesen: Claude erfordert den Anthropic-Endpunkt
- Warum Aider
- Installation
- Claude konfigurieren (Anthropic-Endpunkt)
- GPT und chinesische Modelle konfigurieren (OpenAI-kompatibler Endpunkt)
- Nutzung
- Alternative Endpunkte
- Verfügbare Modelle
- Aider vs. Claude Code CLI
- Fehlerbehebung
- Weiter
Zuletzt geprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (Upstream-Repository; siehe den Statushinweis unten)
Upstream-Aktivität: Der letzte Commit in Aider-AI/aider datiert vom 2026-05-22, seitdem gab es keine Releases (geprüft über die GitHub-API am 2026-09-18). Alles auf dieser Seite funktioniert weiterhin; als aktiv gepflegte Alternative empfehlen wir Cline oder Kilo Code.
Auf einen Blick¶
| Punkt | Details |
|---|---|
| Nutzbare Modelle | Claude ✅ (Präfix anthropic/ am Anthropic-Endpunkt) · GPT ✅ · Chinesische Modelle ✅ (OpenAI-kompatibler Endpunkt) · Gemini ❌ (hier ist keine Gemini-Route dokumentiert) |
| Protokoll & Base URL | Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1 |
| Relevante Umgebungsvariablen | ANTHROPIC_API_BASE und OPENAI_API_BASE verweisen jeweils auf eine der beiden Strecken |
| Konfigurationsort | CLI-Flags oder ~/.aider.conf.yml |
| Offizielle Dokumentation | aider.chat |
Aider ist ein beliebter Open-Source-KI-Pair-Programmer (39K+ GitHub-Sterne), der in Ihrem Terminal läuft und über 100 Sprachen unterstützt. Er leitet Modelle über LiteLLM, sodass er sowohl das Anthropic- als auch das OpenAI-Protokoll spricht.
🔴 Zuerst lesen: Claude erfordert den Anthropic-Endpunkt¶
Der OpenAI-kompatible Endpunkt von QCode akzeptiert keine Claude-Modelle. Wenn Sie OPENAI_API_BASE auf QCode setzen und dann einen Modellnamen wie openai/claude-… verwenden, erhalten Sie model_not_available_on_endpoint.
| Gewünschtes Modell | Aider-Modellpräfix | Umgebungsvariable | Wert |
|---|---|---|---|
| Claude | anthropic/ |
ANTHROPIC_API_BASE |
https://api.qcode.cc/api |
| GPT / die vier chinesischen Familien | openai/ |
OPENAI_API_BASE |
https://api.qcode.cc/openai/v1 |
Siehe Endpunkte & API-Pfade.
Warum Aider¶
- Vollständig Open Source: Sie zahlen nur für die API-Nutzung
- Architect-Modus: Ein Modell plant, ein anderes bearbeitet – bessere Ergebnisqualität
- Tiefe Git-Integration: Jede KI-Änderung wird zu einem Git-Commit
- Repository Map: Tree-sitter-basierte Indizierung der gesamten Codebasis
- Beide Protokolle: Claude über Anthropic, GPT / chinesische Modelle über OpenAI
Installation¶
# pipx recommended (isolated install)
pipx install aider-chat
# or pip
pip install aider-chat
Claude konfigurieren (Anthropic-Endpunkt)¶
export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_your_qcode_key"
aider --model anthropic/claude-sonnet-5
LiteLLM hängt /v1/messages automatisch an diese Base an, daher enden Sie bei /api ohne abschließenden Schrägstrich.
Der Variablenname hängt von der Version ab: LiteLLM hat historisch sowohl
ANTHROPIC_API_BASEals auchANTHROPIC_BASE_URLverwendet. Wenn eine der beiden keine Wirkung hat, versuchen Sie die andere oder übergeben Sie--anthropic-api-keyauf der Kommandozeile. Maßgeblich ist die Aider-Dokumentation.
Dauerhaft einrichten (an ~/.zshrc oder ~/.bashrc anhängen):
echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_your_qcode_key"' >> ~/.zshrc
source ~/.zshrc
GPT und chinesische Modelle konfigurieren (OpenAI-kompatibler Endpunkt)¶
export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_your_qcode_key"
aider --model openai/gpt-6-sol
Die vier chinesischen Familien (glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.7-max …) funktionieren auf beiden Strecken; die IDs finden Sie unter Chinesische Modelle.
Nutzung¶
cd /path/to/your/project
# Everyday driver
aider --model anthropic/claude-sonnet-5
# Flagship
aider --model anthropic/claude-opus-5
Architect-Modus (empfohlen)¶
Ein Modell plant, ein anderes führt die Änderungen durch:
# Opus plans + Sonnet edits (recommended)
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5
# Sonnet plans + Haiku edits (cheaper)
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-4-5
Beide Modelle müssen auf derselben Protokoll-Route liegen. Eine Mischung (z. B. ein
anthropic/-Planer mit einemopenai/claude-…-Editor) schlägt auf der Editor-Seite fehl.
Häufige Befehle¶
Innerhalb einer Aider-Sitzung:
| Befehl | Beschreibung |
|---|---|
/add file.py |
Eine Datei zum Chat-Kontext hinzufügen |
/drop file.py |
Eine Datei entfernen |
/run pytest |
Einen Befehl ausführen und die Ausgabe an die AI senden |
/diff |
Alle Änderungen anzeigen |
/undo |
Die letzte AI-Änderung rückgängig machen |
/commit |
Aktuelle Änderungen committen |
/help |
Hilfe anzeigen |
Alternative Endpunkte¶
Die drei Zugriffsbereiche sind funktional identisch und unterscheiden sich nur im Netzwerk-Routing. Ein API-Key funktioniert auf allen:
| Knoten | Anthropic (Claude) | OpenAI (GPT / Chinesisch) |
|---|---|---|
| Global | https://api.qcode.cc/api |
https://api.qcode.cc/openai/v1 |
| Asien (beste Wahl ab Festland-China) | https://asia.qcode.cc/api |
https://asia.qcode.cc/openai/v1 |
| Nordamerika / Europa | https://us.qcode.cc/api |
https://us.qcode.cc/openai/v1 |
Verfügbare Modelle¶
| Modell | Name in Aider | Hinweise |
|---|---|---|
| Claude Sonnet 5 | anthropic/claude-sonnet-5 |
Empfohlen, bestes Preis-Leistungs-Verhältnis |
| Claude Opus 5 | anthropic/claude-opus-5 |
Leistungsfähigstes Modell |
| Claude Haiku 4.5 | anthropic/claude-haiku-4-5 |
Günstig und schnell |
| GPT 6 Sol | openai/gpt-6-sol |
OpenAI-Flaggschiff |
| GPT 6 Luna | openai/gpt-6-luna |
Schnell, niedrige Kosten |
| GLM 5.2 | openai/glm-5.2 |
Chinesisch, niedriger Stückpreis |
4.x-Modelle wie
claude-sonnet-4-6undclaude-opus-4-8sind weiterhin verfügbar (gleichesanthropic/-Präfix). Die aktuelle Liste finden Sie auf qcode.cc/models.
Aider vs. Claude Code CLI¶
| Dimension | Aider | Claude Code CLI |
|---|---|---|
| Open Source | Vollständig offen | Geschlossen |
| Git-Integration | Auto-Commit pro Änderung | Manuelles /commit |
| Architect-Modus | Zwei-Modell-Planung + Bearbeitung | Einzelnes Modell |
| Tooling | Dateibearbeitung + Shell | Umfangreicher (LSP, Suche, Browser) |
| Kontextbehandlung | Repository Map Indexing | 200K–1M-Token-Fenster |
| Kontingent | Gemeinsamer QCode.cc-Tarif | Gemeinsamer QCode.cc-Tarif |
Eine gute Kombination: Aider für schnelle Änderungen und Architect-Modus-Planung, Claude Code CLI für tiefgehende Projektanalyse und Automatisierung.
Fehlerbehebung¶
model_not_available_on_endpoint¶
Sie haben ein Claude-Modell an den OpenAI-Zweig gesendet. Prüfen Sie zwei Dinge: Das Modell-Präfix muss anthropic/ lauten, nicht openai/; und die Basis muss ANTHROPIC_API_BASE=https://api.qcode.cc/api sein.
„Model not found“¶
Aider benötigt das Präfix, um zu wissen, welcher Anbieter verwendet werden soll:
# correct
aider --model anthropic/claude-sonnet-5
# wrong (missing prefix)
aider --model claude-sonnet-5
Zeitüberschreitung bei Anfragen¶
Versuchen Sie einen anderen Knoten oder erhöhen Sie den Timeout:
aider --model anthropic/claude-sonnet-5 --timeout 120
Weiter¶
- Endpunkte & API-Pfade — Tabelle: Protokoll × Modellfamilie
- Cline-Integration — eine GUI-Alternative in VS Code
- CLI-Tipps — erweiterte Claude Code-Nutzung
- Aider-Dokumentation