Source: https://aiprimetech.io/de/learn/use-claude-api-with-aider/ [Startseite](/de/) / [Lernen](/de/learn/) / Aider mit Claude über ein Gateway: ANTHROPIC_API_BASE, Konfigurationsdateien, Architektenmodus und Fehlerbehebung # Aider mit Claude über ein Gateway: ANTHROPIC_API_BASE, Konfigurationsdateien, Architektenmodus und Fehlerbehebungen Aider leitet jeden Modellaufruf über LiteLLM. Die Anbindung an ein Gateway erfolgt daher über eine LiteLLM-Einstellung und nicht über eine Aider-Einstellung. Für Claude bedeutet das: ANTHROPIC_API_BASE auf die Host-Basisadresse des Gateways setzen und einen Modellnamen mit dem anthropic/ Präfix verwenden. Zwei weniger offensichtliche Einstellungen sind ebenso wichtig: Neuere Claude-IDs benötigen einen Eintrag in den Modelleinstellungen, sonst fällt Aider auf die Bearbeitung ganzer Dateien ohne Repository-Übersicht zurück. ## Aider installieren macOS / LinuxKopieren ``` python -m pip install aider-install aider-install # or the one-line installer (installs Python 3.12 if needed) curl -LsSf https://aider.chat/install.sh | sh ``` WindowsKopieren ``` powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" ``` Wenn der aider Befehl anschließend nicht gefunden wird, was unter Windows häufig vorkommt, führt python -m aider dasselbe Programm aus. ## Claude über das Gateway anbinden TerminalKopieren ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsKopieren ``` setx ANTHROPIC_API_KEY your_gateway_key setx ANTHROPIC_API_BASE https://aiprimetech.io # open a new terminal, then: aider --model anthropic/claude-sonnet-5 ``` Verwenden Sie die Host-Basisadresse: ohne /v1 und ohne abschließenden Schrägstrich. LiteLLM hängt Folgendes an: /v1/messages selbst an, sodass https://aiprimetech.io/v1 wird zu /v1/v1/messages und gibt 404 zurück; ein abschließender Schrägstrich erzeugt einen doppelten Schrägstrich im Pfad. Die Dokumentation von Aider behandelt keine benutzerdefinierte Anthropic-Basis-URL. Die Variable wird von LiteLLM gelesen, das zuerst ANTHROPIC_API_BASE prüft und anschließend ANTHROPIC_BASE_URL, die von Claude Code verwendete Variable. Beide funktionieren; wenn beide gesetzt sind, hat ANTHROPIC_API_BASE Vorrang. Behalten Sie das anthropic/ Präfix im Modellnamen bei. Ohne Anbieterpräfix weiß LiteLLM bei einem unbekannten Namen nicht, wohin es die Anfrage senden soll, und schlägt mit folgender Meldung fehl: LLM Provider NOT provided. ## Einstellungen in Konfigurationsdateien ablegen Aider liest .aider.conf.yml und .env aus Ihrem Home-Verzeichnis, dem Stammverzeichnis des Git-Repositorys und dem aktuellen Verzeichnis, in dieser Reihenfolge. Später gelesene Dateien haben Vorrang. Eine Datei im Home-Verzeichnis gilt für alle Projekte. ~/.aider.conf.ymlKopieren ``` model: anthropic/claude-sonnet-5 weak-model: anthropic/claude-haiku-4-5 set-env: - ANTHROPIC_API_BASE=https://aiprimetech.io model-settings-file: ~/.aider.model.settings.yml model-metadata-file: ~/.aider.model.metadata.json ``` ~/.envKopieren ``` ANTHROPIC_API_KEY=your_gateway_key ``` weak-model übernimmt Commit-Nachrichten und Zusammenfassungen des Chatverlaufs. Ein günstiges Modell an dieser Stelle spart daher bei jeder Sitzung Geld. set-env kopiert die Variable vor jedem Modellaufruf in die Umgebung, sodass die Basis-URL nicht in Ihrem Shell-Profil stehen muss. ## Diff-Bearbeitungen und Repository-Übersicht bei neueren Modellen beibehalten Aider wählt sein Bearbeitungsformat anhand des Modellnamens. Erkannte Namen, einschließlich solcher, die sonnet-4-, opus-4- oder haiku-4-enthalten, erhalten diff Bearbeitungen und die Repository-Übersicht. Bei einem nicht erkannten Namen, etwa claude-sonnet-5, fällt Aider auf das Neuschreiben ganzer Dateien zurück und lässt die Repository-Übersicht weg. Das macht Bearbeitungen langsamer und teurer. Ein Einstellungseintrag stellt das richtige Verhalten wieder her: ~/.aider.model.settings.ymlKopieren ``` - name: anthropic/claude-sonnet-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 - name: anthropic/claude-opus-5-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 editor_model_name: anthropic/claude-sonnet-5 editor_edit_format: editor-diff ``` Unbekannte Modelle lösen außerdem eine Warnung aus: Unknown context window size and costs, using sane defaults. Sie ist harmlos, aber Aider nimmt dann ein unbegrenztes Kontextfenster und einen Preis von null an. Die Metadatendatei liefert die tatsächlichen Werte: ~/.aider.model.metadata.jsonKopieren ``` { "anthropic/claude-sonnet-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000002, "output_cost_per_token": 0.00001, "litellm_provider": "anthropic", "mode": "chat" }, "anthropic/claude-opus-5-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000004, "output_cost_per_token": 0.00002, "litellm_provider": "anthropic", "mode": "chat" } } ``` Die Preise entsprechen den Listenpreisen von Anthropic pro Token, daher zeigt Aiders Kostenanzeige die Listenkosten an; das Gateway berechnet weniger. Ein Eingabelimit von 200K ist eine sichere Obergrenze für die Arbeit, auch wenn ein Modell mehr unterstützt. ## Architektenmodus: mit einem Modell planen, mit einem anderen bearbeiten TerminalKopieren ``` aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5 ``` Im Architektenmodus schlägt das Hauptmodell die Änderung vor, und das Bearbeitungsmodell setzt sie in Dateiänderungen um. Ein leistungsfähigeres Modell für die Planung und ein günstigeres für die Bearbeitung kosten in der Regel weniger, als das leistungsfähige Modell für beides zu verwenden. Innerhalb einer Sitzung /architect wechselt für eine Nachricht zu diesem Modell und /chat-mode architect wechselt für den Rest der Sitzung. ## Der OpenAI-kompatible Weg Das Gateway unterstützt auch das OpenAI-Chat-Completions-Format, über das GPT-Modelle mit demselben Konto genutzt werden können. Bei diesem Weg enthält die Basis-URL /v1, und der Modellname erhält das openai/ Präfix: TerminalKopieren ``` export OPENAI_API_KEY=your_gateway_key export OPENAI_API_BASE=https://aiprimetech.io/v1 aider --model openai/claude-sonnet-5 ``` Für Claude empfiehlt sich der oben beschriebene native Weg: Modellmetadaten und Prompt-Caching passen zum Format von Anthropic. Wenn in Ihrer Umgebung versehentlich OPENAI_BASE_URL gesetzt ist, verwendet LiteLLM diesen Wert vorrangig vor OPENAI_API_BASE. ## Modelle | Modell-ID | Einsatzbereich | claude-sonnet-5 | Standard für Programmier- und Agentenaufgaben: schnell, leistungsstark, mittleres Preisniveau. | claude-opus-5-5 | Anspruchsvollere Denkaufgaben, umfangreiche Refactorings, lange Agentenläufe. | claude-fable-5-1 | Am leistungsfähigsten und am teuersten; für die schwierigsten Aufgaben reservieren. | claude-haiku-4-5 | Günstig und schnell: Titel, Zusammenfassungen, Klassifizierung, kleine Schritte. Aiders Kurzaliase (sonnet, opus, haiku) verweisen auf ältere Modell-IDs. Geben Sie den Modellnamen daher explizit an. Alte datierte IDs wie claude-3-5-sonnet-20241022 werden nicht bereitgestellt. ## Fehlerbehebung | Was Sie sehen | Ursache | Lösung | 404 / NotFoundError | /v1 in ANTHROPIC_API_BASE, sodass der Pfad zu /v1/v1/messages | Setzen Sie die Host-Stammadresse, https://aiprimetech.io, ohne abschließenden Schrägstrich | LLM Provider NOT provided | Modellname ohne Anbieterpräfix | Verwenden Sie anthropic/claude-sonnet-5 | AuthenticationError: Sie können nicht authentifiziert werden | Der Schlüssel fehlt in der Shell, in der Aider läuft, oder der Schlüssel gehört zu einem anderen Endpunkt | echo $ANTHROPIC_API_KEY; öffnen Sie unter Windows ein neues Terminal nach setx | Vollständiges Neuschreiben von Dateien, keine Repository-Übersicht | Aider erkennt den Modellnamen nicht | Fügen Sie den .aider.model.settings.yml Eintrag oben hinzu | Unknown context window size and costs | Keine Metadaten für das Modell | Fügen Sie die Metadatendatei hinzu oder ignorieren Sie die Warnung | Fehler beim Token-Limit | Zu viele oder zu große Dateien im Chat | /tokens , um die Nutzung anzuzeigen, /drop Dateien, /clear Verlauf | RateLimitError | Limit für gleichzeitige Anfragen oder Anfragerate erreicht | Aider wiederholt die Anfrage mit zunehmenden Wartezeiten; vermeiden Sie mehrere Sitzungen mit demselben Schlüssel | Modell nicht unterstützt | Eine alte oder falsch geschriebene Modell-ID | Verwenden Sie eine ID aus der obigen Tabelle Informationen zu Fehlern, die vom Modell und nicht von Aider stammen, finden Sie in [Anleitung zu Claude API-Fehlern](/de/learn/claude-api-errors-troubleshooting/). ## Häufig gestellte Fragen Wie verwende ich Aider mit einer benutzerdefinierten Anthropic-Basis-URL? Setzen Sie ANTHROPIC_API_BASE auf die Host-Stammadresse des Gateways, z. B. https://aiprimetech.io, ohne /v1 und ohne abschließenden Schrägstrich. Setzen Sie ANTHROPIC_API_KEY und führen Sie aider --model anthropic/claude-sonnet-5. aus. LiteLLM hängt /v1/messages an. Liest Aider ANTHROPIC_BASE_URL? Ja, über LiteLLM als Fallback. LiteLLM prüft zuerst ANTHROPIC_API_BASE und dann ANTHROPIC_BASE_URL. Warum schreibt Aider mit einem neuen Claude-Modell ganze Dateien neu? Aider erkennt den Modellnamen nicht und fällt auf das Bearbeitungsformat whole ohne Repository-Übersicht zurück. Fügen Sie in .aider.model.settings.yml einen Eintrag mit edit_format: diff und use_repo_map: true hinzu. Kann Aider einen OpenAI-kompatiblen Endpunkt verwenden? Ja: Setzen Sie OPENAI_API_BASE auf den Endpunkt einschließlich /v1 sowie OPENAI_API_KEY und verwenden Sie dann das Präfix openai/, z. B. aider --model openai/claude-sonnet-5. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber. ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude mit dem OpenAI SDK verwenden: OpenAI-kompatibler Endpunkt, Streaming, Tools und Limits](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[Hermes Agent mit Claude über ein Gateway: Einrichtung eines benutzerdefinierten Anbieters, Kostenkontrolle und Fehlerbehebungen](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Codex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und Fehlerbehebungen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat mit Claude über ein Gateway: Einrichtung von Custom Endpoint, Agentenmodus und Fehlerbehebungen](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)