Aider mit einer kostenlosen LLM-API nutzen
Aider ist ein Open-Source-Pair-Programmer für das Terminal. Er bearbeitet Dateien in Ihrem Git-Repository und erstellt Commits. Diese Anleitung verbindet Aider über FreeLLMAPI mit kostenlosen Modellen. Sie zeigt außerdem die Aider-Einstellungen, die für kostenlose Modelle wichtig sind: Edit-Format, schwaches Modell und Größe der Repo-Map.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
Schritt 1: FreeLLMAPI installieren
FreeLLMAPI ist ein Open-Source-Gateway. Es läuft in Docker auf Ihrem Computer. Es bündelt die kostenlosen Stufen von 45 Anbietern hinter einem OpenAI-kompatiblen Schlüssel.
Installation unter macOS oder Linux
curl -fsSL https://freellmapi.co/install.sh | bashÖffnen Sie http://localhost:3001. Fügen Sie auf der Seite Keys mindestens zwei kostenlose Anbieter-Schlüssel hinzu. Kopieren Sie Ihren einheitlichen Schlüssel von derselben Seite.
Schritt 2: Aider verbinden
Der Setup-Befehl schreibt ~/.aider.conf.yml. Vorher erstellt er eine Sicherung der vorhandenen Datei.
Ein Befehl
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderDie Datei, die der Befehl schreibt, sieht so aus:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Das Präfix openai/ ist erforderlich. Es sagt Aider, dass der Modellname an eine OpenAI-kompatible API gesendet wird. Um Umgebungsvariablen und keine Datei zu verwenden, gehen Sie so vor:
Nur Umgebungsvariablen
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider sucht .aider.conf.yml in Ihrem Home-Verzeichnis, dann im Stammverzeichnis Ihres Git-Repositorys und dann im aktuellen Verzeichnis. Die Datei, die zuletzt geladen wird, hat Vorrang. Eine Projektdatei kann das Modell daher für ein einzelnes Repository ändern.
Schritt 3: Modelle wählen
Aider sendet Ihre Dateien und eine Repo-Map in jeder Anfrage. Für seine Haupt-Bearbeitungsschleife braucht es keine Tool-Aufrufe, weil es Änderungen aus dem Text des Modells liest. Ein großes Kontextfenster und gute Befolgung von Anweisungen sind wichtiger. Die Tabelle zeigt kostenlose Modelle mit heute mindestens 128K Kontext.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 Anfragen/Min. 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Ja | Nein |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 weitere | 1M | 40 Anfragen/Min. 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 Anfragen/Min. 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Ja | Nein |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Deepseek V4.1 Flash | APINex | 1M | 5 Anfragen/Min. 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Nein | Nein |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 Anfragen/Min. 50 Anfragen/Tag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 Anfragen/Min. 50 Anfragen/Tag Shared rate limit | Ja | Nein |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Nein | Nein |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 weitere | 262K | 30 Anfragen/Min. 250 Anfragen/Tag 70,000 Token/Min. ~6M | Ja | Ja |
Es werden 12 von 184 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Verwenden Sie openai/auto, damit der Router ein Modell wählt. Verwenden Sie openai/auto:smart, um die Modelle mit der höchsten Intelligenz zu bevorzugen. Um ein Modell festzulegen, verwenden Sie openai/ und eine Katalog-ID aus GET /v1/models.
Sie können die Modelle für eine Sitzung auch in der Kommandozeile festlegen. Dieses Beispiel verwendet die stärksten Modelle für Änderungen. Für Commit-Nachrichten und Zusammenfassungen des Chatverlaufs verwendet es schnelle Modelle:
Modelle für eine Sitzung
aider --model openai/auto:smart --weak-model openai/auto:fastFür ein geplantes Profil legen Sie im FreeLLMAPI-Dashboard eine Fallback-Kette an, zum Beispiel eine Kette mit dem Namen coding. Verwenden Sie dann --model openai/auto:coding. Ein unbekannter Profilname liefert den Fehler 400. Die Anfrage geht dann nicht ohne Hinweis an eine andere Kette.
Aider-Einstellungen für kostenlose Modelle
Aider kennt die Einstellungen für bekannte Modelle. Ein Gateway-Modell wie auto ist nicht bekannt. Setzen Sie diese Werte daher selbst.
| Einstellung | Funktion | Empfohlener Wert für kostenlose Modelle |
|---|---|---|
edit-format | Das Format, in dem das Modell Änderungen sendet: whole, diff, diff-fenced oder udiff | diff für starke Modelle. whole für schwache Modelle, weil es einfacher ist, aber mehr Tokens sendet. |
weak-model | Das Modell für Commit-Nachrichten und Zusammenfassungen des Chatverlaufs | openai/auto:fast, damit kleine Aufgaben nicht das Kontingent Ihres starken Modells verbrauchen |
map-tokens | Die Anzahl der Tokens für die Repo-Map. 0 schaltet sie aus. | 1024 oder weniger bei kleinen kostenlosen Stufen |
architect | Ein Modell plant die Änderung und ein Editor-Modell schreibt die Änderungen | Optional. Es verdoppelt die Zahl der Anfragen. |
~/.aider.conf.yml mit Einstellungen für kostenlose Modelle
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Um Aider das Kontextfenster eines Gateway-Modells mitzugeben, fügen Sie eine Datei .aider.model.metadata.json hinzu. Der Schlüssel ist der vollständige Modellname. Aider sucht diese Datei an denselben Orten wie die Konfigurationsdatei.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Rate-Limits und Failover
Kostenlose Stufen haben Limits pro Minute und pro Tag. FreeLLMAPI zählt die Nutzung jedes Schlüssels. Wenn ein Anbieter einen Fehler 429 sendet, leitet der Router die Anfrage an das nächste Modell in Ihrer Kette weiter. Aider sieht den Fehler nicht und arbeitet weiter.
- Fügen Sie Schlüssel von vier oder mehr Anbietern hinzu. Mehr Anbieter ergeben mehr Anfragen pro Tag.
- Fügen Sie mit
/addnur die Dateien hinzu, die Sie ändern wollen. Jede Datei ist in jeder Anfrage enthalten. - Verwenden Sie
/clearzwischen den Aufgaben, um einen kürzeren Chatverlauf zu senden. Ein kurzer Verlauf senkt auch die Tokens pro Minute. - Verwenden Sie
/drop, um Dateien zu entfernen, die Sie nicht mehr brauchen.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| „Model openai/auto: Unknown context window size and costs, using sane defaults.“ | Aider kennt das Gateway-Modell nicht | Diese Warnung ist meist harmlos. Um sie zu entfernen, fügen Sie .aider.model.metadata.json hinzu. |
| Die Änderung wurde nicht angewendet | Das Modell hat das Edit-Format nicht eingehalten | Verwenden Sie --edit-format whole oder ein stärkeres Modell |
401 „Invalid API key“ | Aider sendet einen anderen Schlüssel, zum Beispiel aus einer anderen Konfigurationsdatei | Prüfen Sie die Konfigurationsdateien im Home-Verzeichnis, im Git-Stammverzeichnis und im aktuellen Verzeichnis |
| Aider ruft api.openai.com auf | Das Präfix openai/ ist verwendet, aber die Base URL ist nicht gesetzt | Setzen Sie openai-api-base oder OPENAI_API_BASE |
| „All models rate-limited after N attempts“ | Alle Schlüssel haben ihr Limit erreicht | Fügen Sie Schlüssel von weiteren Anbietern hinzu oder verringern Sie map-tokens |
Häufig gestellte Fragen
Kann ich Aider kostenlos nutzen?
Ja. Aider ist Open Source. Richten Sie es mit openai-api-base und dem Modellpräfix openai/ auf FreeLLMAPI aus. Das Gateway verwendet kostenlose Anbieter-Stufen, daher kostet die Inferenz 0 $.
Wie verwende ich Aider mit einer OpenAI-kompatiblen API?
Setzen Sie OPENAI_API_BASE und OPENAI_API_KEY und starten Sie dann aider --model openai/
Welches Edit-Format sollte ich mit kostenlosen Modellen verwenden?
Verwenden Sie diff für starke Modelle, weil es weniger Tokens sendet. Wenn Änderungen nicht angewendet werden, verwenden Sie whole. Es ist für schwache Modelle einfacher, sendet aber jedes Mal die ganze Datei.
Was bedeutet „Unknown context window size and costs, using sane defaults“?
Aider kennt den Modellnamen nicht und verwendet daher Standardwerte. Die Warnung ist meist harmlos. Fügen Sie .aider.model.metadata.json mit dem Kontextfenster hinzu, um sie zu entfernen.
Welches kostenlose Modell ist am besten für Aider?
Verwenden Sie ein Modell mit einem großen Kontextfenster und guter Befolgung von Anweisungen. Die Tabelle auf dieser Seite zeigt die stärksten kostenlosen Modelle mit heute 128K oder mehr Kontext.
Verwandte Anleitungen
- OpenCode mit einer kostenlosen LLM API nutzen
- Codex CLI mit kostenlosen Modellen nutzen
- Beste kostenlose Coding-Modell-APIs
- Kostenlose OpenAI-kompatible API-Base-URLs
- Kostenlose LLM-API mit 1 Million Tokens Kontext
Quellen
- Aider docs: OpenAI-compatible APIs (geprüft 20 November 2026)
- Aider docs: YAML config file (geprüft 20 November 2026)
- Aider docs: options reference (geprüft 20 November 2026)
- Aider docs: edit formats (geprüft 20 November 2026)
- Aider docs: model warnings (geprüft 20 November 2026)
- Aider docs: advanced model settings (geprüft 20 November 2026)
- FreeLLMAPI CLI generators (geprüft 20 November 2026)