# Aider-Integration

> **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](/docs/ide/cline) oder [Kilo Code](/docs/ide/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](https://aider.chat) |

[Aider](https://github.com/paul-gauthier/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](/docs/getting-started/endpoints-and-api-paths).

## 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

```bash
# pipx recommended (isolated install)
pipx install aider-chat

# or pip
pip install aider-chat
```

## Claude konfigurieren (Anthropic-Endpunkt)

```bash
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_BASE` als auch `ANTHROPIC_BASE_URL` verwendet. Wenn eine der beiden keine Wirkung hat, versuchen Sie die andere oder übergeben Sie `--anthropic-api-key` auf der Kommandozeile. Maßgeblich ist die [Aider-Dokumentation](https://aider.chat/).

Dauerhaft einrichten (an `~/.zshrc` oder `~/.bashrc` anhängen):

```bash
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)

```bash
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](/docs/usage/cn-models).
## Nutzung

```bash
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:

```bash
# 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 einem `openai/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-6` und `claude-opus-4-8` sind weiterhin verfügbar (gleiches `anthropic/`-Präfix). Die aktuelle Liste finden Sie auf [qcode.cc/models](https://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:

```bash
# 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:

```bash
aider --model anthropic/claude-sonnet-5 --timeout 120
```

## Weiter

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Tabelle: Protokoll × Modellfamilie
- [Cline-Integration](/docs/ide/cline) — eine GUI-Alternative in VS Code
- [CLI-Tipps](/docs/usage/cli-tips) — erweiterte Claude Code-Nutzung
- [Aider-Dokumentation](https://aider.chat/)