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

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

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

export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5

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

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.

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

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:

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

{
  "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

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:

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

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

Informationen zu Fehlern, die vom Modell und nicht von Aider stammen, finden Sie in Anleitung zu Claude API-Fehlern.

Häufig gestellte Fragen

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.