CLI-Optionen (Flags)

Sammelt die wichtigsten CLI-Flags von Aider, gruppiert nach Modell, Automatisierung, Kontext und Sonstigem.

Aiders CLI-Flags lassen sich beim Start kombinieren (z.B. aider --model ... --test-cmd ... --yes-always) oder in einer Config-Datei/als Env-Variablen setzen. Die wichtigsten, gruppiert: Modell: --model MODEL (Hauptmodell, Env AIDER_MODEL); --weak-model WEAK_MODEL (für Commit-Messages/Verlaufs-Zusammenfassung); --editor-model EDITOR_MODEL (schreibt im Architect-Modus die Datei-Edits); --architect (aktiviert direkt den Architect-Modus); --reasoning-effort VALUE und --thinking-tokens VALUE (Denktiefe/-budget steuern) Automation/Scripting: --message/-m/--msg (einzelne Nachricht senden, Antwort verarbeiten, danach beenden - für Skripte/CI); --message-file/-f (Nachricht aus Datei lesen); --yes-always (bestätigt jede Rückfrage automatisch, ohne nachzufragen); --no-auto-commits (deaktiviert automatisches Committen von LLM-Änderungen, Default ist An); --test-cmd (Testkommando definieren) zusammen mit --auto-test bzw. einmalig --test; --lint-cmd (Lint-Kommandos pro Sprache) zusammen mit --auto-lint bzw. einmalig --lint; --watch-files (beobachtet Dateien auf spezielle KI-Kommentare, die Aider auslösen) Kontext: --read FILE (Datei read-only hinzufügen, mehrfach nutzbar) bzw. --file FILE (editierbar hinzufügen); --map-tokens VALUE (Größe der Repository-Map, 0 deaktiviert sie); --map-refresh VALUE (auto/always/files/manual) Install/Sonstiges: --upgrade/--update (Aider selbst aktualisieren); --just-check-update (nur prüfen, ob ein Update verfügbar ist); --config/-c (eigene Config-Datei); --env-file (eigene .env-Datei für API-Keys); --version; --help/-h

✅ WANN EINSETZEN?

-m in Skripten/CI-Pipelines für nicht-interaktive Einzel-Läufe nutzen

aider --message 'Fix the failing test in test_auth.py' --yes-always --test-cmd 'pytest -q' in einem CI-Job

Automatisierung gezielt einschränken statt alles zu erlauben

aider --test-cmd 'pytest -q' --auto-test --no-auto-commits — Tests laufen automatisch, Commits aber erst nach manueller Prüfung

⛔ WANN EHER NICHT?

--yes-always pauschal in jedem interaktiven Lauf setzen, ohne die Vorschläge zu prüfen

Damit werden auch riskante oder ungewollte Änderungen automatisch bestätigt, ohne dass jemand sie vorher sieht.

Besser: --yes-always nur in kontrollierten Skript-/CI-Kontexten mit --message einsetzen, interaktiv Vorschläge manuell bestätigen

API-Keys direkt als Klartext-Flag in der Shell-History landen lassen

--openai-api-key/--anthropic-api-key als Kommandozeilen-Argument bleibt oft in der Shell-History und in Prozesslisten sichtbar.

Besser: Keys stattdessen über --env-file/.env oder Umgebungsvariablen wie AIDER_ANTHROPIC_API_KEY setzen

QUELLEN

Aider Docs — Options Reference ↗ aider.chat