Instalarea Aider și configurarea OmniProxy

Aider este un instrument care ajută la modificarea codului direct din terminal. Acesta creează o hartă a întregului proiect pentru a ajuta modelul să înțeleagă bazele de cod mai mari. Git este un instrument de control al versiunilor care înregistrează modificările aduse codului, permițându-ți să inspectezi diferențele și să restaurezi versiunile anterioare. După ce îi dai o sarcină lui Aider, acesta o procesează pas cu pas și scrie mesaje de commit. Dacă nu ești mulțumit de modificări, le poți anula cu /undo.

Înainte de a începe

Există două opțiuni comune de instalare:

Dacă computerul tău are deja instalat Python 3.8 până la 3.13, instalează aider-install mai întâi. Python este mediul de execuție necesar pentru Aider.

Mac și Linux

install.sh

Rulează cu sh după curl
Instalează Python dacă este necesar
Folosește wget dacă curl nu este disponibil

Windows

install.ps1

Rulează în PowerShell
Redeschide terminalul după instalare
Setează variabilele de mediu cu setx

Python deja instalat

aider-install

Instalează mai întâi acest pachet cu pip
Apoi rulează aider-install
Creează propriul său mediu

Instalatorul într-o singură linie configurează Python 3.12 atunci când este necesar. Instalarea aider-chat direct cu pip este mai puțin fiabilă.

Asigură-te că OmniProxy rulează. După instalare, intră în directorul proiectului pe care intenționezi să îl modifici înainte de a porni Aider.

Instalare și prima lansare

Dacă ai deja Python 3.8 până la 3.13

Rulează aceste comenzi în ordine:

python -m pip install aider-install
aider-install

aider-install instalează Aider într-un mediu Python separat, astfel încât să nu interfereze cu alte proiecte Python de pe computerul tău. Când este necesar, instalează și Python 3.12 pentru a fi utilizat de Aider.

Instalare într-o singură linie

Pe Mac și Linux, rulează:

curl -LsSf https://aider.chat/install.sh | sh

Dacă curl nu este instalat, folosește:

wget -qO- https://aider.chat/install.sh | sh

În Windows PowerShell, rulează:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Aceste comenzi într-o singură linie se bazează pe uv, un program pentru instalarea și gestionarea instrumentelor și mediilor Python. Poți folosi și următoarea comandă:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Poți folosi și pipx. Când instalezi direct cu python -m pip install aider-chat, versiunile de Python acceptate sunt 3.9 până la 3.12. Totuși, aceasta este o metodă alternativă de instalare, așa că preferă metodele descrise mai sus. Pachetele Aider din managerii de pachete ai sistemului pot avea nepotriviri de dependențe, deci nu ar trebui să fie prima ta alegere.

La data de 2026-10-09, comanda de instalare într-o singură linie a instalat Aider v0.86.2. În timpul instalării, este posibil să vezi un mesaj care spune că memoria cache și destinația se află pe discuri diferite și că fișierele vor fi copiate. Instalarea se va finaliza oricum.

După instalare, intră în directorul proiectului. Un API compatibil este o interfață care comunică cu alte servicii de model folosind formatul OpenAI. Pornește Aider folosind acest model:

aider --model openai/<model-name>

Înlocuiește <model-name> cu ID-ul complet al modelului copiat din OmniProxy în secțiunea următoare. Un ID de model este numele utilizat pentru a identifica precis un model.

Obținerea setărilor de conexiune din OmniProxy

Trebuie să setezi următoarele două variabile de mediu. Variabilele de mediu pot fi înțelese ca un set de setări de conexiune citite de programele de terminal:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE este punctul final (endpoint) al API-ului și trebuie să includă /v1. OPENAI_API_KEY este cheia utilizată pentru a accesa API-ul.

Pe Windows, folosește setx pentru a salva variabilele. Trebuie să redeschizi terminalul ulterior:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Copiază întregul nume al modelului din lista curentă OmniProxy, inclusiv orice bare oblice din ID-ul modelului. Când pornești Aider, adaugă openai/ înainte de ID-ul complet.

La data de 2026-10-09, cele două ID-uri de referință din documentația furnizorului erau gemini-3.8-flash și grok-4.7. Dacă aceste nume nu se află în lista curentă, nu le copia direct. Folosește un ID complet care apare efectiv în listă.

Adresă

OPENAI_API_BASE

Indică către OmniProxy
Include /v1
Nu îl pune în depozit (repository)

Cheie

OPENAI_API_KEY

Folosește-o pe cea furnizată de gateway
Redeschide terminalele Windows după modificare
Păstrează cheile furnizorului în gateway

Lansare

openai/model

cd în directorul proiectului
Prefixează numele modelului cu openai/
Folosește numele din lista gateway-ului

Cele două variabile de mediu, împreună cu un nume de model prefixat cu openai/, formează sintaxa API compatibilă.

Introducerea configurației instrumentului

Nu este nevoie să creezi un fișier de configurare separat. Intră în directorul proiectului, pornește Aider și înlocuiește ID-ul modelului cu un nume care există efectiv în lista curentă OmniProxy:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Pentru a folosi celălalt model exemplu, rulează:

aider --model openai/grok-4.7

Când Aider întâlnește un model necunoscut, afișează un avertisment. Acest avertisment nu înseamnă neapărat că punctul final este incorect. Verifică jurnalele de cereri (request logs) ale OmniProxy pentru a confirma dacă cererea a apărut.

Aider adaugă în context doar fișierele deja urmărite de Git. Contextul reprezintă codul și informațiile pe care modelul le poate citi în timpul sarcinii curente. Dacă directorul curent nu este încă un depozit Git, Aider creează unul, dar fișierele pe care Git nu le urmărește tot nu pot fi citite. Folosește git add pentru a adăuga fișierele și a le face commit înainte de a porni Aider.

Aider poate modifica în continuare fișierele. --no-auto-commits dezactivează doar commit-urile automate; nu previne modificările fișierelor. Când folosești Aider pentru prima dată, alege un depozit neimportant și rulează git diff după sarcină pentru a revizui modificările reale.

Nu pune chei reale în fișierele de proiect sau pe pagini publice. Stochează cheile furnizorului doar în OmniProxy. Dacă gateway-ul nu validează cheile, poți seta OPENAI_API_KEY la un șir de caractere substituent (placeholder) utilizat doar pe computerul tău local.

Verificarea cu o sarcină reală

Mai întâi, asigură-te că fișierul pe care dorești să îl citească Aider a fost adăugat în Git. Apoi rulează următoarea comandă din directorul proiectului. Înlocuiește ID-ul modelului cu un ID complet din lista curentă OmniProxy:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message trimite o sarcină direct către Aider, în timp ce --no-auto-commits îi spune lui Aider să nu creeze automat commit-uri Git în timpul acestei rulări.

La data de 2026-10-09, Aider v0.86.2 a citit cu succes prima linie a unui fișier urmărit. Dacă fișierul nu este urmărit de Git, Aider va spune că nu poate vedea conținutul. Acest lucru nu înseamnă că punctul final API este incorect. După finalizarea interogării, verifică jurnalele de cereri ale OmniProxy pentru a verifica sursa cererii și ID-ul modelului.

Lansare

Aider pornește

Comanda este disponibilă
Variabilele de mediu sunt active
În directorul proiectului

Sarcină

A inspectat fișierul

Întreabă despre un fișier specific
Revizuiește explicația sa
Modelele necunoscute pot declanșa un avertisment

Jurnale

Vizibile în gateway

Sursa este Aider
ID-ul modelului se potrivește
Cheia nu a fost introdusă pe pagină

Confirmă că variabilele de mediu sunt active și comanda este disponibilă, apoi finalizează o interogare reală.

Erori comune

aider nu poate fi găsit: Redeschide mai întâi terminalul. Dacă l-ai instalat direct cu pip, încearcă python -m aider.
Windows se conectează în continuare la vechiul punct final după schimbarea variabilelor: Trebuie să redeschizi terminalul după rularea setx. Doar o fereastră nouă va citi variabilele actualizate.
Numele modelului nu începe cu openai/: API-ul compatibil necesită formatul openai/<model-name>.
Apare un avertisment de model necunoscut: Acesta este un avertisment normal și nu înseamnă că conexiunea a eșuat. Verifică dacă OmniProxy a primit cererea.
ID-ul modelului este invalid: Copiază din nou ID-ul complet din lista curentă OmniProxy. Păstrează prefixul openai/ și orice bare oblice deja prezente în ID.
Aider spune că nu există conținut în fișier: Asigură-te că fișierul este urmărit de Git. Fișierele dintr-un depozit gol sau fișierele neurmărite nu sunt adăugate în context.

Referințe oficiale

Pentru pașii de instalare, vezi Instalarea Aider. Pentru variabilele de mediu și prefixul modelului, vezi API-uri compatibile OpenAI. ID-urile modelelor exemplu pot fi găsite în lista de modele Gemini și pe pagina modelelor xAI.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · Aider ↗