Namestitev Aider in konfiguracija OmniProxy

Aider je orodje, ki pomaga pri spreminjanju kode iz terminala. Ustvari zemljevid celotne kode, da modelu pomaga razumeti 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

Obstajata 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 nastavil 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 znova 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 vstopite v mapo projekta, ki ga nameravate spremeniti, preden zaženete Aider.

Prva namestitev in zagon

Če že imate 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, tako da ne moti drugih projektov Python 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 namestitve, zato dajte prednost zgoraj opisanim metodam. Paketi Aider iz sistemskih upraviteljev paketov imajo lahko neskladja v odvisnostih, zato naj ne bodo vaša prva izbira.

Na dan 2026-10-09 je ukaz za namestitev v eni vrstici namestil Aider v0.86.2. Med namestitvijo se lahko prikaže sporočilo, da sta predpomnilnik in cilj 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. Zaženite Aider s tem vzorcem:

aider --model openai/<model-name>

Zamenjajte <model-name> s celotnim ID-jem modela, ki ste ga kopirali 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 terminalski programi:

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

OPENAI_API_BASE je končna točka API-ja in mora vključevati /v1. OPENAI_API_KEY je ključ, ki se uporablja za dostop do API-ja.

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

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 Aiderja dodajte openai/ pred celoten ID.

Od 2026-10-09 sta 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 znova odprite terminale Windows
• Ključe ponudnika 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 OmniProxy, da potrdite, ali se je zahteva pojavila.

Aider v kontekst doda le datoteke, ki jim že sledi Git. 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 jim Git ne sledi, še vedno ni mogoče brati. Uporabite git add, da dodate datoteke in jih uveljavite (commit), preden zaženete Aider.

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

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

Preverjanje z dejansko nalogo

Najprej se prepričajte, da je bila datoteka, ki jo želite, da jo 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 Aiderju, medtem ko --no-auto-commits Aiderju naroči, naj med tem zagonom ne ustvarja samodejnih uveljavitev Git.

Na dan 2026-10-09 je Aider v0.86.2 uspešno prebral prvo vrstico sledene datoteke. Če datoteki ne sledi Git, 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 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

Vidno v prehodu

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

Pogoste napake

• aider ni mogoče najti: Najprej znova 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 znova 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. Ohranite predpono openai/ in vse poševnice, ki so že prisotne v ID-ju.
• Aider pravi, da ni vsebine datoteke: Prepričajte se, da datoteki sledi Git. Datoteke v praznem repozitoriju ali datoteke, ki jim ne sledi, niso dodane v kontekst.

Uradne reference

Za korake namestitve glejte Namestitev Aider. Za okoljske spremenljivke in predpono modela glejte Združljivi API-ji 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 agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Aider ↗