Opțiunile comenzii aider în Aider CLI

aider [opțiuni] [FIȘIER ...]

Ce face Opțiunile comenzii aider

Tabelul cuprinde toate opțiunile din pagina oficială Options reference, în aceeași ordine: model principal, chei API, setări de model, cache, hartă a repository-ului, istoric, afișare, Git, linting și teste, analytics, actualizări, moduri, voce, alte setări și opțiunile depreciate. aider --help afișează aceeași listă.

Aproape orice opțiune se poate seta în patru feluri echivalente: în linia de comandă (--dark-mode), în .aider.conf.yml (dark-mode: true), ca variabilă de mediu (AIDER_DARK_MODE=true) sau în fișierul .env. Numele variabilei este AIDER_ plus numele opțiunii cu majuscule și _ în loc de -.

Opțiunile booleene au și forma negată --no-.... Opțiunile marcate „se poate repeta” acceptă mai multe valori. Fișierele date fără opțiune după aider sunt adăugate în chat pentru editare.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
-h, --help	Afișează ajutorul și iese.
--model MODEL	Modelul pentru chatul principal.
--openai-api-key VALUE	Cheia API OpenAI.
--anthropic-api-key VALUE	Cheia API Anthropic.
--openai-api-base VALUE	URL-ul de bază al API-ului.
--openai-api-type VALUE	Depreciată; folosește --set-env OPENAI_API_TYPE=valoare.
--openai-api-version VALUE	Depreciată; folosește --set-env OPENAI_API_VERSION=valoare.
--openai-api-deployment-id VALUE	Depreciată; folosește --set-env OPENAI_API_DEPLOYMENT_ID=valoare.
--openai-organization-id VALUE	Depreciată; folosește --set-env OPENAI_ORGANIZATION=valoare.
--set-env ENV_VAR_NAME=value	Setează o variabilă de mediu pentru setările API; se poate repeta.
--api-key PROVIDER=KEY	Setează cheia unui furnizor: --api-key gemini=xxx setează GEMINI_API_KEY; se poate repeta.
--list-models MODEL, --models MODEL	Listează modelele cunoscute care se potrivesc cu numele parțial dat.
--model-settings-file FILE	Fișier cu setări pentru modele necunoscute (implicit .aider.model.settings.yml).
--model-metadata-file FILE	Fișier cu fereastra de context și costurile pentru modele necunoscute (implicit .aider.model.metadata.json).
--alias ALIAS:MODEL	Adaugă un alias de model; se poate repeta.
--reasoning-effort VALUE	Parametrul API reasoning_effort (implicit nesetat).
--thinking-tokens VALUE	Bugetul de thinking tokens pentru modelele care îl acceptă; 0 dezactivează (implicit nesetat).
--verify-ssl / --no-verify-ssl	Verifică certificatul SSL la conectarea la modele (implicit activ).
--timeout VALUE	Timeout în secunde pentru apelurile API (implicit niciunul).
--edit-format FORMAT, --chat-mode FORMAT	Formatul de editare sau modul de chat (implicit depinde de model).
--architect	Folosește formatul architect pentru chatul principal.
--auto-accept-architect / --no-auto-accept-architect	Acceptă automat modificările propuse de arhitect (implicit activ).
--weak-model WEAK_MODEL	Modelul pentru mesajele de commit și rezumarea istoricului (implicit depinde de --model).
--editor-model EDITOR_MODEL	Modelul pentru sarcinile de editor (implicit depinde de --model).
--editor-edit-format FORMAT	Formatul de editare al modelului editor (implicit depinde de modelul editor).
--show-model-warnings / --no-show-model-warnings	Textul oficial: lucrează doar cu modele care au metadate disponibile (implicit activ).
--check-model-accepts-settings / --no-check-model-accepts-settings	Verifică dacă modelul acceptă setări ca reasoning_effort sau thinking_tokens (implicit activ).
--max-chat-history-tokens VALUE	Limită orientativă pentru istoricul chatului, după care începe rezumarea; implicit valoarea max_chat_history_tokens a modelului.
--cache-prompts / --no-cache-prompts	Activează cache-ul de prompturi (implicit dezactivat).
--cache-keepalive-pings VALUE	De câte ori trimite Aider un ping la intervale de 5 minute ca să păstreze cache-ul cald (implicit 0).
--map-tokens VALUE	Numărul sugerat de tokeni pentru harta repository-ului; 0 o dezactivează.
--map-refresh VALUE	Cât de des se reface harta: auto, always, files, manual (implicit auto).
--map-multiplier-no-files VALUE	Multiplicatorul pentru --map-tokens când nu sunt fișiere în chat (implicit 2).
--input-history-file FILE	Fișierul cu istoricul mesajelor introduse (implicit .aider.input.history).
--chat-history-file FILE	Fișierul cu istoricul chatului (implicit .aider.chat.history.md).
--restore-chat-history / --no-restore-chat-history	Restaurează mesajele din istoricul anterior (implicit dezactivat).
--llm-history-file FILE	Jurnalizează conversația cu LLM-ul în acest fișier (de exemplu .aider.llm.history).
--dark-mode	Culori potrivite pentru un terminal cu fundal închis (implicit dezactivat).
--light-mode	Culori potrivite pentru un terminal cu fundal deschis (implicit dezactivat).
--pretty / --no-pretty	Ieșire formatată și colorată (implicit activ).
--stream / --no-stream	Răspunsuri în streaming (implicit activ).
--user-input-color VALUE	Culoarea textului introdus de utilizator (implicit #00cc00).
--tool-output-color VALUE	Culoarea ieșirii uneltelor (implicit niciuna).
--tool-error-color VALUE	Culoarea mesajelor de eroare (implicit #FF2222).
--tool-warning-color VALUE	Culoarea avertismentelor (implicit #FFA500).
--assistant-output-color VALUE	Culoarea răspunsurilor asistentului (implicit #0088ff).
--completion-menu-color COLOR	Culoarea meniului de completare (implicit culoarea textului din terminal).
--completion-menu-bg-color COLOR	Fundalul meniului de completare (implicit fundalul terminalului).
--completion-menu-current-color COLOR	Culoarea elementului curent din meniu (implicit culoarea de fundal a terminalului).
--completion-menu-current-bg-color COLOR	Fundalul elementului curent din meniu (implicit culoarea textului din terminal).
--code-theme VALUE	Tema pentru codul din Markdown: default, monokai, solarized-dark, solarized-light sau orice stil Pygments (implicit default).
--show-diffs	Afișează diff-urile la commit (implicit dezactivat).
--git / --no-git	Caută un repository git (implicit activ). --no-git oprește complet folosirea git.
--gitignore / --no-gitignore	Adaugă .aider* în .gitignore (implicit activ).
--add-gitignore-files / --no-add-gitignore-files	Permite editarea fișierelor listate în .gitignore (implicit dezactivat).
--aiderignore FILE	Fișierul de excluderi Aider (implicit .aiderignore din rădăcina repository-ului).
--subtree-only	Ia în calcul doar fișierele din subdirectorul curent al repository-ului (implicit dezactivat).
--auto-commits / --no-auto-commits	Commit automat pentru modificările LLM-ului (implicit activ).
--dirty-commits / --no-dirty-commits	Commit pentru modificările existente când repository-ul are fișiere necomise (implicit activ).
--attribute-author / --no-attribute-author	Marchează modificările Aider în numele autorului git (implicit activ). Setată explicit, are prioritate față de --attribute-co-authored-by.
--attribute-committer / --no-attribute-committer	Marchează commiturile Aider în numele committer-ului git (implicit activ). Setată explicit, are prioritate față de --attribute-co-authored-by.
--attribute-commit-message-author / --no-...	Prefixează cu aider: mesajele commiturilor scrise de Aider (implicit dezactivat).
--attribute-commit-message-committer / --no-...	Prefixează cu aider: toate mesajele de commit (implicit dezactivat).
--attribute-co-authored-by / --no-attribute-co-authored-by	Adaugă trailerul Co-authored-by în mesajul de commit (implicit activ); înlocuiește marcarea autorului și a committer-ului, dacă acelea nu sunt setate explicit.
--git-commit-verify / --no-git-commit-verify	Rulează hook-urile pre-commit (implicit dezactivat: Aider face commit cu --no-verify).
--commit	Face commit pentru toate modificările în așteptare, cu un mesaj potrivit, apoi iese.
--commit-prompt PROMPT	Prompt propriu pentru generarea mesajelor de commit.
--dry-run / --no-dry-run	Rulare fără modificarea fișierelor (implicit dezactivat).
--skip-sanity-check-repo	Sare peste verificarea repository-ului git (implicit dezactivat).
--watch-files / --no-watch-files	Urmărește fișierele pentru comentarii AI (implicit dezactivat).
--lint	Verifică și repară fișierele date sau, dacă lipsesc, fișierele modificate.
--lint-cmd	Comanda de lint pentru un limbaj, de forma "python: flake8 --select=..."; se poate repeta.
--auto-lint / --no-auto-lint	Lint automat după modificări (implicit activ).
--test-cmd VALUE	Comanda de rulare a testelor.
--auto-test / --no-auto-test	Teste automate după modificări (implicit dezactivat).
--test	Rulează testele, repară problemele găsite și iese.
--analytics / --no-analytics	Analytics pentru sesiunea curentă (implicit: aleator).
--analytics-log FILE	Fișier în care se jurnalizează evenimentele de analytics.
--analytics-disable	Dezactivează permanent analytics (implicit dezactivat).
--analytics-posthog-host HOST	Trimite analytics la o instanță PostHog proprie.
--analytics-posthog-project-api-key KEY	Trimite analytics la un proiect PostHog propriu.
--just-check-update	Verifică dacă există actualizări și întoarce rezultatul în codul de ieșire.
--check-update / --no-check-update	Verifică la pornire dacă există o versiune nouă (implicit activ).
--show-release-notes / --no-show-release-notes	Afișează notele de versiune la prima rulare a unei versiuni noi (implicit: întreabă).
--install-main-branch	Instalează ultima versiune din ramura main.
--upgrade, --update	Actualizează Aider la ultima versiune de pe PyPI.
--version	Afișează versiunea și iese.
-m, --message, --msg COMMAND	Trimite un singur mesaj, procesează răspunsul și iese (fără chat interactiv).
-f, --message-file FILE	Ca --message, cu mesajul citit din fișier.
--gui / --browser (--no-gui / --no-browser)	Rulează Aider în browser, interfață experimentală (implicit dezactivat).
--copy-paste / --no-copy-paste	Copiere automată a contextului și preluare a răspunsului între Aider și o interfață web (implicit dezactivat).
--apply FILE	Aplică modificările din fișier în loc să pornească chatul (depanare).
--apply-clipboard-edits	Aplică conținutul clipboard-ului ca editări, în formatul de editor al modelului principal.
--exit	Face pașii de pornire, apoi iese înainte să accepte input (depanare).
--show-repo-map	Afișează harta repository-ului și iese (depanare).
--show-prompts	Afișează prompturile de sistem și iese (depanare).
--voice-format VOICE_FORMAT	Formatul audio pentru înregistrare (implicit wav); webm și mp3 cer ffmpeg.
--voice-language VOICE_LANGUAGE	Limba vocii, cod ISO 639-1. Textul de ajutor spune „default: auto”, iar valoarea implicită afișată este en.
--voice-input-device DEVICE	Numele dispozitivului de intrare pentru înregistrare.
--disable-playwright	Nu propune și nu încearcă instalarea Playwright pentru /web (implicit dezactivat).
--file FILE	Fișier de editat; se poate repeta.
--read FILE	Fișier read-only; se poate repeta.
--vim	Mod de editare VI în terminal (implicit dezactivat).
--chat-language LANG	Limba folosită în chat (implicit: setările sistemului).
--commit-language LANG	Limba mesajelor de commit (implicit: limba utilizatorului).
--yes-always	Răspunde „da” la orice confirmare.
-v, --verbose	Ieșire detaliată (implicit dezactivat).
--load LOAD_FILE	Încarcă și execută la pornire comenzile /... dintr-un fișier.
--encoding VALUE	Codificarea pentru intrare și ieșire (implicit utf-8).
--line-endings VALUE	Terminațiile de rând la scrierea fișierelor (implicit platform).
-c, --config CONFIG_FILE	Fișierul de configurare; încarcă doar acest fișier (implicit se caută .aider.conf.yml în rădăcina git, directorul curent și directorul home).
--env-file ENV_FILE	Fișierul .env de încărcat (implicit .env din rădăcina git).
--suggest-shell-commands / --no-suggest-shell-commands	Sugerează comenzi shell (implicit activ).
--fancy-input / --no-fancy-input	Input cu istoric și completare (implicit activ).
--multiline / --no-multiline	Mod multiline: Meta-Enter trimite mesajul (implicit dezactivat).
--notifications / --no-notifications	Clopoțel în terminal când răspunsul este gata (implicit dezactivat).
--notifications-command COMMAND	Comandă rulată pentru notificări în locul clopoțelului.
--detect-urls / --no-detect-urls	Detectează URL-urile din mesaje și oferă adăugarea lor în chat (implicit activ).
--editor VALUE	Editorul folosit de /editor.
--shell-completions SHELL	Afișează scriptul de completare pentru bash, tcsh sau zsh și iese.
--opus	Depreciată: claude-3-opus-20240229. Folosește --model.
--sonnet	Depreciată: anthropic/claude-3-7-sonnet-20250219. Folosește --model.
--haiku	Depreciată: claude-3-5-haiku-20241022. Folosește --model.
-4, --4	Depreciată: gpt-4-0613. Folosește --model.
--4o	Depreciată: gpt-4o. Folosește --model.
--mini	Depreciată: gpt-4o-mini. Folosește --model.
--4-turbo	Depreciată: gpt-4-1106-preview. Folosește --model.
--35turbo, --35-turbo, --3, -3	Depreciată: gpt-3.5-turbo. Folosește --model.
--deepseek	Depreciată: deepseek/deepseek-chat. Folosește --model.
--o1-mini	Depreciată: o1-mini. Folosește --model.
--o1-preview	Depreciată: o1-preview. Folosește --model.

Exemple practice

Exemplul 1: O opțiune setată în patru feluri

aider --dark-mode
# .aider.conf.yml
dark-mode: true
# shell
export AIDER_DARK_MODE=true
# .env
AIDER_DARK_MODE=true

Exemplul 2: Un singur mesaj, fără chat interactiv

aider --message "make a script that prints hello" hello.js

Exemplul 3: Completări pentru zsh

aider --shell-completions zsh

Greșeli frecvente și bune practici

• Folosești opțiunile depreciate (--sonnet, --4o) și primești modele vechi. Alege modelul cu --model sau cu un alias.
• Pui chei API pentru alți furnizori direct în .aider.conf.yml ca openai-api-key. Doar OpenAI și Anthropic au chei dedicate; pentru restul folosește api-key sau fișierul .env.
• Rulezi scripturi cu --message fără --yes-always și rămân blocate la o confirmare.

Comenzi înrudite

• aider-start
• aider-model
• aiderignore
• slash-settings