Instalacija alata Aider i konfiguracija za OmniProxy

Aider je alat koji pomaže u izmjeni koda izravno iz terminala. On izrađuje mapu cijele baze koda kako bi pomogao modelu da razumije veće projekte. Git je alat za kontrolu verzija koji bilježi promjene u kodu, omogućujući vam pregled razlika i vraćanje na prethodne verzije. Nakon što Aideru zadate zadatak, on ga obrađuje korak po korak i piše poruke uz commit. Ako vam se promjene ne sviđaju, možete ih poništiti pomoću /undo.

Prije početka

Postoje dvije uobičajene opcije instalacije:

Ako vaše računalo već ima Python 3.8 do 3.13, instalirajte aider-install prvo. Python je runtime okruženje potrebno za rad alata Aider.

Mac i Linux

install.sh

Pokrenite sa sh nakon curl
Instalira Python ako je potrebno
Koristite wget ako curl nije dostupan

Windows

install.ps1

Pokrenite u PowerShell-u
Ponovno otvorite terminal nakon instalacije
Postavite varijable okruženja pomoću setx

Python je već instaliran

aider-install

Prvo instalirajte ovaj paket pomoću pip-a
Zatim pokrenite aider-install
Stvara vlastito okruženje

Instalacijska skripta u jednom retku postavlja Python 3.12 kada je to potrebno. Izravna instalacija paketa aider-chat pomoću pip-a manje je pouzdana.

Provjerite je li OmniProxy pokrenut. Nakon instalacije, prije pokretanja alata Aider, uđite u direktorij projekta koji planirate mijenjati.

Instalacija i prvo pokretanje

Ako već imate Python 3.8 do 3.13

Pokrenite ove naredbe redom:

python -m pip install aider-install
aider-install

aider-install instalira Aider u zasebno Python okruženje kako ne bi ometao druge Python projekte na vašem računalu. Kada je potrebno, također instalira Python 3.12 koji Aider koristi.

Instalacija u jednom retku

Na Mac-u i Linux-u pokrenite:

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

Ako curl nije instaliran, koristite:

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

U Windows PowerShell-u pokrenite:

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

Ove naredbe u jednom retku temelje se na alatu uv, programu za instalaciju i upravljanje Python alatima i okruženjima. Također možete koristiti sljedeću naredbu:

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

Možete koristiti i pipx. Prilikom izravne instalacije pomoću python -m pip install aider-chat, podržane verzije Pythona su 3.9 do 3.12. Međutim, ovo je alternativna metoda instalacije, stoga dajte prednost gore opisanim metodama. Aider paketi iz upravitelja paketa operacijskog sustava mogu imati neusklađene ovisnosti, pa ne bi trebali biti vaš prvi izbor.

Na datum 2026-10-09, instalacijska naredba u jednom retku instalirala je Aider v0.86.2. Tijekom instalacije možda ćete vidjeti poruku da su predmemorija (cache) i odredište na različitim diskovima i da će se datoteke kopirati. Instalacija će se ipak uspješno dovršiti.

Nakon instalacije, uđite u direktorij projekta. Kompatibilni API je sučelje koje komunicira s drugim modelima koristeći OpenAI format. Pokrenite Aider koristeći ovaj obrazac:

aider --model openai/<model-name>

Zamijenite <model-name> punim ID-om modela kopiranim iz OmniProxy-a u sljedećem odjeljku. ID modela je naziv koji se koristi za preciznu identifikaciju modela.

Dohvaćanje postavki povezivanja iz OmniProxy-a

Morate postaviti sljedeće dvije varijable okruženja. Varijable okruženja mogu se shvatiti kao skup postavki povezivanja koje čitaju programi u terminalu:

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

OPENAI_API_BASE je API krajnja točka (endpoint) i mora uključivati /v1. OPENAI_API_KEY je ključ koji se koristi za pristup API-ju.

Na Windowsima koristite setx za spremanje varijabli. Nakon toga morate ponovno otvoriti terminal:

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

Kopirajte cijeli naziv modela s trenutnog popisa u OmniProxy-u, uključujući sve kose crte u ID-u modela. Prilikom pokretanja alata Aider, dodajte openai/ prije punog ID-a.

Na datum 2026-10-09, dva referentna ID-a u dokumentaciji pružatelja usluga bila su gemini-3.8-flash i grok-4.7. Ako ti nazivi nisu na trenutnom popisu, nemojte ih kopirati izravno. Koristite puni ID koji se stvarno pojavljuje na popisu.

Adresa

OPENAI_API_BASE

Usmjerite na OmniProxy
Uključite /v1
Ne stavljajte ga u repozitorij

Ključ

OPENAI_API_KEY

Koristite onaj koji pruža pristupnik (gateway)
Ponovno otvorite Windows terminale nakon promjene
Držite ključeve pružatelja usluga u pristupniku

Pokretanje

openai/model

cd u direktorij projekta
Dodajte prefiks openai/ nazivu modela
Koristite naziv s popisa pristupnika

Dvije varijable okruženja, zajedno s nazivom modela s prefiksom openai/, čine sintaksu kompatibilnog API-ja.

Unos konfiguracije alata

Ne morate stvarati zasebnu konfiguracijsku datoteku. Uđite u direktorij projekta, pokrenite Aider i zamijenite ID modela nazivom koji stvarno postoji na trenutnom popisu u OmniProxy-u:

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

Za korištenje drugog primjera modela, pokrenite:

aider --model openai/grok-4.7

Kada Aider naiđe na nepoznat model, prikazuje upozorenje. Ovo upozorenje samo po sebi ne znači da je krajnja točka netočna. Provjerite zapisnike (logs) zahtjeva u OmniProxy-u kako biste potvrdili je li se zahtjev pojavio.

Aider u kontekst dodaje samo datoteke koje Git već prati. Kontekst je kod i informacije koje model može čitati tijekom trenutnog zadatka. Ako trenutni direktorij još nije Git repozitorij, Aider će ga stvoriti, ali datoteke koje Git ne prati i dalje se neće moći čitati. Koristite git add za dodavanje datoteka i njihovo commit-anje prije pokretanja alata Aider.

Aider i dalje može mijenjati datoteke. --no-auto-commits samo onemogućuje automatske commit-ove; ne sprječava izmjene datoteka. Kada prvi put koristite Aider, odaberite nevažan repozitorij i pokrenite git diff nakon zadatka kako biste pregledali stvarne promjene.

Ne stavljajte stvarne ključeve u datoteke projekta ili na javne stranice. Ključeve pružatelja usluga pohranite samo u OmniProxy. Ako pristupnik ne provjerava ključeve, možete postaviti OPENAI_API_KEY na zamjenski niz znakova koji se koristi samo na vašem lokalnom računalu.

Provjera sa stvarnim zadatkom

Prvo provjerite je li datoteka koju želite da Aider čita commit-ana u Git. Zatim pokrenite sljedeću naredbu iz direktorija projekta. Zamijenite ID modela punim ID-om s trenutnog popisa u OmniProxy-u:

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 šalje zadatak izravno alatu Aider, dok --no-auto-commits govori alatu Aider da ne stvara Git commit-ove automatski tijekom ovog pokretanja.

Na datum 2026-10-09, Aider v0.86.2 uspješno je pročitao prvi redak praćene datoteke. Ako datoteku ne prati Git, Aider će reći da ne može vidjeti sadržaj. To ne znači da je API krajnja točka netočna. Nakon dovršetka upita, provjerite zapisnike zahtjeva u OmniProxy-u kako biste potvrdili izvor zahtjeva i ID modela.

Pokretanje

Aider se pokreće

Naredba je dostupna
Varijable okruženja su aktivne
U direktoriju projekta

Zadatak

Pregledao je datoteku

Pitaj o određenoj datoteci
Pregledaj njegovo objašnjenje
Nepoznati modeli mogu izazvati upozorenje

Zapisnici

Vidljivo u pristupniku

Izvor je Aider
ID modela se podudara
Ključ nije unesen na stranici

Potvrdite da su varijable okruženja aktivne i da je naredba dostupna, a zatim dovršite jedan stvarni upit.

Uobičajene pogreške

aider nije moguće pronaći: Prvo ponovno otvorite terminal. Ako ste ga instalirali izravno pomoću pip-a, pokušajte python -m aider.
Windows se i dalje povezuje na staru krajnju točku nakon promjene varijabli: Morate ponovno otvoriti terminal nakon pokretanja setx. Samo novi prozor će učitati ažurirane varijable.
Naziv modela ne počinje s openai/: Kompatibilni API zahtijeva format openai/<model-name>.
Pojavljuje se upozorenje o nepoznatom modelu: Ovo je normalno upozorenje i ne znači da veza nije uspjela. Provjerite je li OmniProxy primio zahtjev.
ID modela nije valjan: Ponovno kopirajte cijeli ID s trenutnog popisa u OmniProxy-u. Zadržite openai/ prefiks i sve kose crte koje su već prisutne u ID-u.
Aider kaže da nema sadržaja datoteke: Provjerite prati li Git datoteku. Datoteke u praznom repozitoriju ili datoteke koje nisu praćene ne dodaju se u kontekst.

Službene reference

Za korake instalacije pogledajte Aider instalacija. Za varijable okruženja i prefiks modela pogledajte OpenAI kompatibilni API-ji. Primjere ID-ova modela možete pronaći na popisu Gemini modela i na stranici xAI modela.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · Aider ↗