Unlimited Aider mit der Claude API

Aider ist ein terminalbasiertes AI Pair-Programming-Tool, das direkt mit deinem bestehenden git Repository arbeitet. Es nutzt eine spezielle Architektur mit getrennten Modellen für unterschiedliche Rollen: ein Hauptmodell fürs Coding, ein Editor-Modell zum Anwenden von Änderungen und ein Architect-Modell für Planung. Jeder Refactoring-Zyklus erzeugt mehrere API Calls, weil Aider Änderungen entwirft, sie mit dem Editor-Modell auf Dateien anwendet, sie in git committet und die Repo Map aktualisiert. Genau dieses Multi-Model- und Multi-Call-Muster macht Aider zu einem idealen Kandidaten für eine Claude API mit Flatrate über AI Prime Tech Unlimited.

Aiders Multi-Call-Architektur und Token-Muster

Aider sendet nicht einfach nur deine Anfrage an Claude und gibt eine einzelne Antwort zurück. Jede Interaktion startet eine Pipeline: Das Hauptmodell erzeugt die Edit-Anweisungen, das Editor-Modell parst diese Anweisungen und wendet sie auf deine Dateien an, und wenn der Architect Mode aktiv ist, läuft davor noch ein separater Planungsschritt. Zusätzlich pflegt Aider eine Repository Map, also eine komprimierte Darstellung der Struktur deiner gesamten Codebase. Diese Repo Map wird in jede Anfrage eingebunden, damit das Modell auch Dateien, Klassen, Funktionen und Abhängigkeiten berücksichtigt, die du nicht explizit in den Chat gezogen hast.

Allein die Repo Map kann je nach Projektgröße 10.000 bis 30.000 Tokens verbrauchen, und sie wird bei jeder einzelnen Anfrage erneut mitgeschickt. Wenn du dazu noch die Dateiinhalte rechnest, die du bewusst in den Chat aufgenommen hast, außerdem den Gesprächsverlauf und die Antwort des Modells, landet eine typische Aider-Interaktion schnell bei 50.000 bis 100.000 Tokens. Eine Refactoring-Session mit fünf oder sechs Rückfragen, Korrekturen und Wiederholungen erreicht problemlos eine halbe Million Tokens oder mehr. Wer nach claude api kosten oder claude code api kosten sucht, unterschätzt genau diesen Effekt häufig: Bei agentischem Coding zählt nicht nur der sichtbare Prompt, sondern die komplette Arbeitsumgebung, die jedes Mal mitgesendet wird.

Der Architect Mode verdoppelt die Calls pro Interaktion: Zuerst plant das Architect-Modell die Änderung auf hoher Ebene, danach implementiert das Hauptmodell den Plan als konkrete Edits. Das führt bei komplexen Aufgaben meist zu deutlich besseren Ergebnissen, verdoppelt aber im klassischen Pay-per-Token-Modell auch den API-Verbrauch. Viele Nutzer deaktivieren den Architect Mode deshalb, um Kosten zu sparen. Mit unbegrenztem Claude Zugang über eine Flatrate solltest du ihn dagegen für jede nicht-triviale Aufgabe aktiv lassen. Gerade bei größeren Refactorings, API-Migrationen, Test-Umstellungen oder Architekturänderungen ist der zusätzliche Planungsschritt oft der Unterschied zwischen einem brauchbaren Patch und mehreren frustrierenden Korrekturschleifen.

Verbindung über den nativen Anthropic-Pfad

Aider unterstützt Anthropic-Modelle nativ über den Modell-Prefix anthropic/. Wenn du eine eigene Base URL verwenden willst, setzt du die env var ANTHROPIC_API_BASE auf https://claudeapikey.dev, also auf den Root Host ohne /v1. Das ist wichtig, weil das Anthropic SDK die Pfade intern selbst zusammensetzt. ANTHROPIC_API_KEY setzt du auf deinen AI Prime Tech Unlimited Key. Falls du gerade erst deinen Claude API Key erstellen möchtest, läuft das bei diesem Gateway über deinen AI Prime Tech Unlimited Account und nicht über die normale Anthropic Console.

Starte Aider anschließend mit dem Model-Flag: aider --model anthropic/claude-sonnet-4-5. Der Prefix anthropic/ sagt Aider, dass es den Anthropic SDK Path nutzen soll, der wiederum ANTHROPIC_API_BASE und ANTHROPIC_API_KEY aus der Umgebung liest. Es gibt kein --anthropic-api-base Command-Line-Flag. Du musst also entweder die env var verwenden oder sie inline mit --set-env setzen: aider --set-env ANTHROPIC_API_BASE={SITE} --model anthropic/claude-sonnet-4-5. Diese Konfiguration ist besonders relevant für Entwickler, die eine Claude API kaufen oder ein Gateway statt direkter Anthropic-Abrechnung verwenden wollen.

Dieser Pfad bietet vollständige Unterstützung für die Anthropic Messages API, inklusive Streaming, Tool Use und Thinking Blocks. Er ist für Claude-Modelle die empfohlene Variante, weil Aiders Parsing für Edit-Formate sehr gut zur Response-Struktur von Anthropic passt. Auch das Editor-Modell und das Weak Model kannst du über diesen Pfad auf Claude-Varianten setzen. Wenn du möglichst wenig Reibung bei strukturierten Edits, Diffs und Tool Calls willst, ist der native Anthropic-Pfad die stabilste Wahl. Der OpenAI-kompatible Pfad ist praktisch, aber der native Pfad ist für Aider mit Claude in der Regel sauberer.

Verbindung über den OpenAI-kompatiblen Pfad

Alternativ kannst du den OpenAI-kompatiblen Pfad verwenden. Dafür setzt du OPENAI_API_BASE auf https://claudeapikey.dev/v1, hier ausdrücklich mit dem /v1-Suffix, und OPENAI_API_KEY auf deinen Unlimited Key. Danach startest du Aider mit: aider --model openai/claude-sonnet-4-5. Der Prefix openai/ routet die Anfrage über LiteLLMs OpenAI Handler. Das ist nützlich, wenn du bereits Tools, Scripts oder Deployment-Setups hast, die OpenAI-kompatible Endpoints erwarten.

Der OpenAI-Pfad funktioniert für einfache Interaktionen gut, kann aber bei manchen Anthropic-spezifischen Features Einschränkungen haben. Aider verwendet unter der Haube LiteLLM, um zwischen Provider-Formaten zu übersetzen. Diese Übersetzungsschicht behandelt die meisten Fälle korrekt, trotzdem kann es bei komplexen strukturierten Edits, Tool Calling oder Streaming-Details gelegentlich zu Formatierungsproblemen kommen. Für maximale Kompatibilität, besonders wenn du Aider intensiv für Refactorings nutzt, ist der native Anthropic-Pfad vorzuziehen.

Du kannst die Pfade auch mischen: zum Beispiel den Anthropic-Pfad für das Hauptmodell und einen anderen Provider für das Weak Model. Diese Flexibilität ist praktisch, wenn du Claude für anspruchsvolles Reasoning willst, aber ein günstigeres Modell für triviale Aufgaben wie Commit Messages einsetzen möchtest. Bei AI Prime Tech Unlimited gibt es allerdings keinen starken Kostenanreiz für diesen Mix. Wenn du nach claude api kostenlos suchst, geht es meistens um Testen oder kleine Experimente; bei produktivem Aider-Einsatz ist aber die wichtigere Frage, ob du vorhersehbare Kosten und genug Headroom für viele Calls bekommst. Mit einer Flatrate kannst du Claude für Planung, Umsetzung, Zusammenfassungen und Commit Messages durchgehend verwenden.

Architect Mode und Model-Splits

Aiders /architect Command aktiviert einen zweiphasigen Workflow: Ein Architect-Modell plant die Änderungen, danach implementiert das Editor- oder Hauptmodell diese Planung. Für maximale Planungsqualität kannst du das Architect-Modell mit --architect anthropic/claude-opus-4-6 setzen. Das Editor-Modell übernimmt anschließend die mechanische Arbeit, korrekt formatierte Diffs und konkrete Dateiänderungen zu erzeugen, und kann daher ein schnelleres Modell sein. In der Praxis ist dieser Split besonders stark bei großen Codebases, weil Claude erst die Struktur und Risiken durchdenken kann, bevor Dateien verändert werden.

Die weak-model Einstellung steuert, welches Modell leichte Aufgaben übernimmt: Commit Messages erzeugen, Änderungen zusammenfassen und andere nicht-kritische Arbeiten erledigen. Du setzt es mit --weak-model anthropic/claude-haiku-4-5. In einem Pay-per-Token-Modell spart das Weak Model viel Geld, weil einfache Aufgaben von teuren Modellen wegverlagert werden. Bei Unlimited liegt der Vorteil eher in der Latenz als in den Kosten. Haiku antwortet bei simplen Aufgaben schneller und hält die Session flüssig, während Sonnet oder Opus für die schwierigeren Entscheidungen reserviert bleiben.

Eine vollständig konfigurierte Aider-Session mit Unlimited könnte so aussehen: --model anthropic/claude-sonnet-4-5 für das Haupt-Coding, --architect anthropic/claude-opus-4-6 für Planung und --weak-model anthropic/claude-haiku-4-5 für Commits und Zusammenfassungen. Damit nutzt du an jedem Entscheidungspunkt das passende Claude-Modell, ohne jedes Mal die claude api kosten im Kopf mitzuzählen. Der einzige echte Trade-off ist die Antwortzeit bei Architect-Schritten mit Opus. Für große Änderungen lohnt sich diese Wartezeit fast immer, weil weniger Fehlversuche, weniger manuelle Korrekturen und weniger Undo-Retry-Schleifen entstehen.

Repository Map und CONVENTIONS.md

Aider generiert automatisch eine Repo Map: eine verdichtete Sicht auf die Dateistruktur deines Repositories, Klassenhierarchien und Funktionssignaturen. Diese Map wird in jede API-Anfrage aufgenommen. Dadurch versteht das Modell Code, den es nicht explizit im Chat gesehen hat, kann passende Imports vorschlagen, vorhandene Funktionen wiederverwenden und konsistent mit dem restlichen Projekt arbeiten. Für Entwickler fühlt sich das oft so an, als hätte Claude ein deutlich besseres Projektgedächtnis, obwohl technisch vor allem zusätzlicher Kontext in jeder Anfrage steckt.

Die Größe der Repo Map skaliert mit deinem Projekt. Bei einem kleinen Projekt mit rund 50 Dateien können 5.000 Tokens dazukommen. In einem großen Monorepo mit 500 oder mehr Dateien kann die Map 30.000 Tokens erreichen. Weil dieser Kontext in jeder Anfrage steckt, entsteht ein erheblicher Basisverbrauch pro Interaktion. Bei klassischer Abrechnung führt das schnell zu der Frage, ob die Repo Map verkleinert oder deaktiviert werden sollte. Mit Unlimited ist das kein Problem: Lass Aider die Repo Map so detailliert erzeugen, wie es für gute Ergebnisse sinnvoll ist, statt künstlich Kontext zu sparen.

CONVENTIONS.md ist Aiders Entsprechung zu projektweiten Instruktionen. Du legst die Datei im Root deines Repositories ab, und Aider nimmt den Inhalt in den System Prompt auf. Dort kannst du Coding Standards, Naming Conventions, bevorzugte Patterns, Testregeln, Architekturentscheidungen und projektspezifische Vorgaben dokumentieren. Wie die Repo Map erhöht auch CONVENTIONS.md den Token-Verbrauch bei jeder Anfrage. Mit einer Flatrate kannst du hier ausführlich werden: Schreibe klare, vollständige Regeln statt ultrakurzer Stichpunkte. Das ist besonders wertvoll, wenn mehrere Entwickler oder Agents am selben Repository arbeiten und alle dieselben Erwartungen an Stil, Tests, Error Handling und API-Design erfüllen sollen.

Git-Integration und Auto-Commits

Aider committet jede Änderung automatisch in git und erzeugt dafür eine beschreibende Commit Message über das Weak Model. So entsteht eine saubere Historie von AI-unterstützten Änderungen, die du einzeln reviewen, cherry-picken oder revertieren kannst. Die Auto-Commit-Funktion setzt voraus, dass dein Working Directory ein git Repository ist und keine uncommitted changes enthält, es sei denn, du überschreibst dieses Verhalten mit --dirty. Für professionelle Workflows ist diese Historie extrem hilfreich, weil du genau nachvollziehen kannst, welche Änderung aus welchem Prompt entstanden ist.

Jede Commit-Message-Generierung ist ein separater API Call an das Weak Model. In einer Session mit vielen kleinen Änderungen summieren sich diese Calls. Bei Unlimited kannst du Auto-Commits mit maximaler Frequenz laufen lassen: Committe nach jeder einzelnen Änderung und erhalte die feinste mögliche Historie. Du kannst Commits später immer noch squashen, aber du kannst einen großen, gemischten Commit nicht sauber in sinnvolle Einzelschritte zurückverwandeln. Gerade bei Aider ist eine granulare Historie praktisch, weil AI-generierte Änderungen manchmal schnell überprüft und bei Bedarf gezielt zurückgenommen werden müssen.

Mit /undo kannst du die letzte Änderung inklusive Commit zurücknehmen und deine Anfrage danach neu formulieren. Im Unlimited-Modell kostet diese Undo-Retry-Schleife nichts extra und wird dadurch zu einem natürlichen Arbeitsstil: Änderung ausprobieren, Ergebnis prüfen, bei Bedarf zurückrollen, Prompt präzisieren und erneut ausführen. Entwickler, die vorher wegen Kosten gezögert haben, mehrere Varianten zu testen, bekommen dadurch deutlich mehr Freiheit. Statt eine perfekte Anfrage beim ersten Versuch schreiben zu müssen, kannst du iterativ mit Claude arbeiten und Aider als echtes Pair-Programming-Tool nutzen.

Troubleshooting der Aider-Konfiguration

Der häufigste Fehler ist ein verwechseltes Base-URL-Format zwischen den beiden Pfaden. Für den Anthropic-Pfad mit dem Prefix anthropic/ muss ANTHROPIC_API_BASE der Root Host ohne /v1 sein. Für den OpenAI-Pfad mit dem Prefix openai/ muss OPENAI_API_BASE dagegen /v1 enthalten. Wenn du Connection Errors, 404s oder unerwartete Endpoint-Fehler bekommst, prüfe zuerst genau diese Einstellung. Viele Probleme wirken zunächst wie Authentifizierungs- oder Modellfehler, sind aber nur ein falscher Base Path.

Wenn Aider 'model not found' meldet, prüfe, ob der Model String den richtigen Prefix enthält: anthropic/claude-sonnet-4-5 für den Anthropic-Pfad oder openai/claude-sonnet-4-5 für den OpenAI-Pfad. Der Prefix sagt LiteLLM, welches SDK beziehungsweise welchen Handler es verwenden soll, und die Model ID nach dem Slash muss zu dem passen, was das Gateway bereitstellt. Wenn du deinen Claude API Key erstellen oder austauschen musst, stelle außerdem sicher, dass die passende env var gesetzt ist: ANTHROPIC_API_KEY für den nativen Pfad oder OPENAI_API_KEY für den OpenAI-kompatiblen Pfad.

Streaming-Fehler wie unvollständige Antworten, abgeschnittene Ausgabe oder hängenbleibende Sessions können darauf hinweisen, dass ein Proxy oder eine Firewall Server-Sent Events stört. Aider streamt Antworten standardmäßig. Wenn du hinter einem Corporate Proxy, VPN oder einer restriktiven Firewall arbeitest, probiere --no-stream, um Streaming zu deaktivieren und stattdessen synchrone Requests zu verwenden. Das erhöht die gefühlte Latenz, vermeidet aber viele verbindungsbezogene Streaming-Probleme. Wenn du AI Prime Tech Unlimited als Gateway nutzt, ist außerdem sinnvoll, zuerst mit einem kleinen Testprompt zu prüfen, ob Key, Base URL, Prefix und Modellname zusammenpassen, bevor du eine große Refactoring-Session startest.

# Nativer Anthropic-Pfad (empfohlen)
export ANTHROPIC_API_BASE="https://claudeapikey.dev"
export ANTHROPIC_API_KEY="<your AI Prime Tech Unlimited key>"
aider --model anthropic/claude-sonnet-4-5 \
      --architect anthropic/claude-opus-4-6 \
      --weak-model anthropic/claude-haiku-4-5

# OpenAI-kompatibler Pfad (Alternative)
# export OPENAI_API_BASE="https://claudeapikey.dev/v1"
# export OPENAI_API_KEY="<your key>"
# aider --model openai/claude-sonnet-4-5

# Oder inline mit --set-env:
# aider --set-env ANTHROPIC_API_BASE=https://claudeapikey.dev \
#       --model anthropic/claude-sonnet-4-5

FAQ

Hat Aider ein --anthropic-api-base Command-Line-Flag?
Nein. Aider liest die Anthropic Base URL aus der env var ANTHROPIC_API_BASE. Verwende --set-env ANTHROPIC_API_BASE=https://claudeapikey.dev, um sie inline zu setzen, oder exportiere sie in deinem Shell-Profil für eine dauerhafte Konfiguration.

Soll ich in Aider für Claude-Modelle den Prefix anthropic/ oder openai/ verwenden?
Nutze den Prefix anthropic/ für den nativen Anthropic SDK Path. Er bietet bessere Kompatibilität mit Claude Tool Calling, Edit-Formaten und Streaming. Der Prefix openai/ funktioniert ebenfalls, fügt aber eine Übersetzungsschicht hinzu, die bei komplexen Edits gelegentlich Formatierungsprobleme verursachen kann.

Was ist die Repo Map und wie wirkt sie sich auf den Token-Verbrauch aus?
Die Repo Map ist eine komprimierte Darstellung der Struktur deiner Codebase und wird in jede Anfrage aufgenommen. Je nach Projektgröße fügt sie etwa 5.000 bis 30.000 Tokens pro Call hinzu. Bei Unlimited ist dieser Overhead durch die Flatrate abgedeckt, daher solltest du sie für bessere Ergebnisse mit voller Detailtiefe laufen lassen.

Kann ich den Architect Mode mit Unlimited ohne Zusatzkosten nutzen?
Ja. Der Architect Mode verdoppelt die API Calls pro Interaktion, weil erst geplant und dann implementiert wird. Dadurch steigt der Token-Verbrauch deutlich. Im Unlimited-Plan ist das abgedeckt. Lass den Architect Mode für jedes nicht-triviale Refactoring aktiviert, um vom zusätzlichen Planungsschritt zu profitieren.

Warum macht Aider für jede Commit Message einen separaten API Call?
Aider verwendet das Weak Model, um für jeden Auto-Commit eine beschreibende Commit Message zu erzeugen. Das ist ein leichter Call, der bei Unlimited nichts extra kostet. Das Ergebnis ist eine saubere, gut dokumentierte git Historie aller AI-unterstützten Änderungen.