Namestitev orodja Aider in konfiguracija OmniProxy

Aider je orodje, ki pomaga pri spreminjanju kode neposredno iz terminala. Ustvari zemljevid celotne kode, da model lažje razume večje projekte. Git je orodje za nadzor različic, ki beleži spremembe kode, kar vam omogoča pregled razlik in obnovitev prejšnjih različic. Ko Aiderju dodelite nalogo, jo obdela korak za korakom in zapiše sporočila o uveljavitvi (commit). Če vam spremembe niso všeč, jih lahko razveljavite z /undo.

Preden začnete

Na voljo sta dve pogosti možnosti namestitve:

• Če ima vaš računalnik že nameščen Python 3.8 do 3.13, najprej namestite aider-install. Python je izvajalno okolje, ki ga Aider potrebuje.
• Če nimate ustrezne različice Pythona, uporabite ukaz za namestitev v eni vrstici. Po potrebi bo namestil tudi Python 3.12.

Mac in Linux

install.sh

• Zaženite s sh po ukazu curl
• Po potrebi namesti Python
• Uporabite wget, če curl ni na voljo

Windows

install.ps1

• Zaženite v PowerShell
• Po namestitvi ponovno odprite terminal
• Nastavite okoljske spremenljivke s setx

Python je že nameščen

aider-install

• Najprej namestite ta paket s pip
• Nato zaženite aider-install
• Ustvari lastno okolje

Prepričajte se, da OmniProxy deluje. Po namestitvi se pred zagonom orodja Aider pomaknite v mapo projekta, ki ga želite spremeniti.

Prva namestitev in zagon

Če že imate nameščen Python 3.8 do 3.13

Zaporedoma zaženite te ukaze:

python -m pip install aider-install
aider-install

aider-install namesti Aider v ločeno okolje Python, da ne moti drugih projektov v vašem računalniku. Po potrebi namesti tudi Python 3.12, ki ga Aider uporablja.

Namestitev v eni vrstici

Na sistemih Mac in Linux zaženite:

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

Če curl ni nameščen, uporabite:

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

V sistemu Windows PowerShell zaženite:

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

Ti ukazi v eni vrstici temeljijo na uv, programu za namestitev in upravljanje orodij ter okolij Python. Uporabite lahko tudi naslednji ukaz:

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

Uporabite lahko tudi pipx. Pri neposredni namestitvi z python -m pip install aider-chat so podprte različice Pythona od 3.9 do 3.12. Vendar je to alternativna metoda, zato dajte prednost zgoraj opisanim načinom. Paketi Aider iz sistemskih upraviteljev paketov imajo lahko težave z odvisnostmi, zato naj ne bodo vaša prva izbira.

Na dan 9. 10. 2026 je ukaz za namestitev v eni vrstici namestil Aider v0.86.2. Med namestitvijo se lahko prikaže sporočilo, da sta predpomnilnik in ciljna mapa na različnih diskih in da bodo datoteke kopirane. Namestitev se bo kljub temu uspešno zaključila.

Po namestitvi vstopite v mapo projekta. Združljiv API je vmesnik, ki komunicira z drugimi storitvami modelov z uporabo formata OpenAI. Aider zaženite s tem vzorcem:

aider --model openai/<model-name>

Zamenjajte <model-name> s celotnim ID-jem modela, ki ga kopirate iz OmniProxy v naslednjem razdelku. ID modela je ime, ki se uporablja za natančno identifikacijo modela.

Pridobitev nastavitev povezave iz OmniProxy

Nastaviti morate naslednji dve okoljski spremenljivki. Okoljske spremenljivke lahko razumemo kot nabor nastavitev povezave, ki jih berejo programi v terminalu:

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

OPENAI_API_BASE je naslov API-ja in mora vključevati /v1. OPENAI_API_KEY je ključ za dostop do API-ja.

V sistemu Windows uporabite setx za shranjevanje spremenljivk. Po tem morate terminal ponovno odpreti:

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

Kopirajte celotno ime modela s trenutnega seznama OmniProxy, vključno s poševnicami v ID-ju modela. Pri zagonu orodja Aider pred celoten ID dodajte openai/.

Na dan 9. 10. 2026 sta bila referenčna ID-ja v dokumentaciji ponudnika gemini-3.8-flash in grok-4.7. Če teh imen ni na trenutnem seznamu, jih ne kopirajte neposredno. Uporabite celoten ID, ki se dejansko pojavi na seznamu.

Naslov

OPENAI_API_BASE

• Usmerite ga na OmniProxy
• Vključite /v1
• Ne postavljajte ga v repozitorij

Ključ

OPENAI_API_KEY

• Uporabite tistega, ki ga zagotovi prehod
• Po spremembi ponovno odprite terminale v sistemu Windows
• Ključe ponudnikov hranite v prehodu

Zagon

openai/model

• cd v mapo projekta
• Pred ime modela dodajte openai/
• Uporabite ime s seznama prehoda

Vnos konfiguracije orodja

Ni vam treba ustvariti ločene konfiguracijske datoteke. Vstopite v mapo projekta, zaženite Aider in zamenjajte ID modela z imenom, ki dejansko obstaja na trenutnem seznamu OmniProxy:

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

Za uporabo drugega primera modela zaženite:

aider --model openai/grok-4.7

Ko Aider naleti na neznan model, prikaže opozorilo. To opozorilo samo po sebi ne pomeni, da je končna točka napačna. Preverite dnevnike zahtev v OmniProxy, da potrdite, ali se je zahteva pojavila.

Aider v kontekst doda le datoteke, ki jih Git že spremlja. Kontekst je koda in informacije, ki jih model lahko bere med trenutno nalogo. Če trenutna mapa še ni repozitorij Git, ga Aider ustvari, vendar datotek, ki jih Git ne spremlja, še vedno ne more prebrati. Uporabite git add, da dodate datoteke in jih uveljavite (commit), preden zaženete Aider.

Aider lahko še vedno spreminja datoteke. --no-auto-commits le onemogoči samodejne uveljavitve; ne prepreči spreminjanja datotek. Ko Aider uporabljate prvič, izberite nepomemben repozitorij in po nalogi zaženite git diff, da pregledate dejanske spremembe.

Ne vnašajte pravih ključev v projektne datoteke ali na javne strani. Ključe ponudnikov shranjujte le v OmniProxy. Če prehod ne preverja ključev, lahko OPENAI_API_KEY nastavite na nadomestni niz, ki se uporablja le v vašem lokalnem računalniku.

Preverjanje z dejansko nalogo

Najprej se prepričajte, da je bila datoteka, ki jo želite, da Aider prebere, uveljavljena v Git. Nato v mapi projekta zaženite naslednji ukaz. Zamenjajte ID modela s celotnim ID-jem s trenutnega seznama 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 pošlje nalogo neposredno v Aider, medtem ko --no-auto-commits Aiderju naroči, naj med tem zagonom ne ustvarja samodejnih uveljavitev Git.

Na dan 9. 10. 2026 je Aider v0.86.2 uspešno prebral prvo vrstico spremljane datoteke. Če datoteke Git ne spremlja, bo Aider sporočil, da ne vidi vsebine. To ne pomeni, da je končna točka API-ja napačna. Po zaključku poizvedbe preverite dnevnike zahtev v OmniProxy, da preverite vir zahteve in ID modela.

Zagon

Aider se zažene

• Ukaz je na voljo
• Okoljske spremenljivke so aktivne
• V mapi projekta

Naloga

Pregledal je datoteko

• Vprašajte o določeni datoteki
• Preglejte njegovo razlago
• Neznani modeli lahko sprožijo opozorilo

Dnevniki

Vidni v prehodu

• Vir je Aider
• ID modela se ujema
• Ključ ni bil vnesen na strani

Pogoste napake

• aider ni mogoče najti: Najprej ponovno odprite terminal. Če ste ga namestili neposredno s pip, poskusite python -m aider.
• Windows se po spremembi spremenljivk še vedno povezuje na staro končno točko: Po zagonu setx morate ponovno odpreti terminal. Samo novo okno bo prebralo posodobljene spremenljivke.
• Ime modela se ne začne z openai/: Združljiv API zahteva format openai/<model-name>.
• Prikaže se opozorilo o neznanem modelu: To je običajno opozorilo in ne pomeni, da povezava ni uspela. Preverite, ali je OmniProxy prejel zahtevo.
• ID modela ni veljaven: Ponovno kopirajte celoten ID s trenutnega seznama OmniProxy. Obdržite predpono openai/ in vse poševnice, ki so že prisotne v ID-ju.
• Aider pravi, da ni vsebine datoteke: Prepričajte se, da datoteko spremlja Git. Datoteke v praznem repozitoriju ali nespremljane datoteke niso dodane v kontekst.

Uradne reference

Za korake namestitve glejte Namestitev Aider. Za okoljske spremenljivke in predpono modela glejte API-ji, združljivi z OpenAI. Primeri ID-jev modelov so na voljo na seznamu modelov Gemini in na strani modelov xAI.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Aider ↗