Aideri installimine ja OmniProxy seadistamine

Aider on tööriist, mis aitab koodi terminalist muuta. See koostab kogu koodibaasist kaardi, et aidata mudelil suuremaid projekte mõista. Git on versioonihaldustööriist, mis salvestab koodimuudatused, võimaldades teil erinevusi kontrollida ja varasemaid versioone taastada. Pärast seda, kui olete Aiderile ülesande andnud, töötleb see ülesannet samm-sammult ja kirjutab commit-sõnumid. Kui teile muudatused ei meeldi, saate need tagasi võtta käsuga /undo.

Enne alustamist

On kaks levinud installimisvõimalust:

• Kui teie arvutis on juba Python 3.8 kuni 3.13, installige aider-install kõigepealt. Python on Aideri jaoks vajalik käituskeskkond.

Mac ja Linux

install.sh

• Käivitage pärast curli sh-ga
• Installib vajadusel Pythoni
• Kasutage wgeti, kui curl pole saadaval

Windows

install.ps1

• Käivitage PowerShellis
• Pärast installimist avage terminal uuesti
• Määrake keskkonnamuutujad käsuga setx

Python on juba installitud

aider-install

• Installige see pakett esmalt pipiga
• Seejärel käivitage aider-install
• See loob oma keskkonna

Veenduge, et OmniProxy töötab. Pärast installimist sisenege enne Aideri käivitamist projekti kataloogi, mida kavatsete muuta.

Installimine ja esmakordne käivitamine

Kui teil on juba Python 3.8 kuni 3.13

Käivitage need käsud järjekorras:

python -m pip install aider-install
aider-install

aider-install installib Aideri eraldi Pythoni keskkonda, et see ei segaks teisi arvutis olevaid Pythoni projekte. Vajadusel installib see ka Python 3.12, mida Aider saab kasutada.

Üherealine installimine

Macis ja Linuxis käivitage:

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

Kui curli pole installitud, kasutage:

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

Windowsi PowerShellis käivitage:

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

Need üherealised käsud põhinevad uv-l, mis on programm Pythoni tööriistade ja keskkondade installimiseks ja haldamiseks. Võite kasutada ka järgmist käsku:

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

Võite kasutada ka pipx-i. Otse installimisel käsuga python -m pip install aider-chat, on toetatud Pythoni versioonid 3.9 kuni 3.12. See on aga alternatiivne installimismeetod, seega eelistage ülaltoodud meetodeid. Süsteemi paketihaldurite Aideri paketid võivad sisaldada sõltuvuste konflikte, seega ei tohiks need olla teie esimene valik.

2026-10-09 seisuga installis üherealine installimiskäsk Aider v0.86.2. Installimise ajal võite näha teadet, et vahemälu ja sihtkoht asuvad erinevatel ketastel ja failid kopeeritakse. Installimine viiakse siiski lõpule.

Pärast installimist sisenege projekti kataloogi. Ühilduv API on liides, mis suhtleb teiste mudeliteenustega, kasutades OpenAI vormingut. Käivitage Aider seda mustrit kasutades:

aider --model openai/<model-name>

Asendage <model-name> täieliku mudeli ID-ga, mille kopeerisite järgmises jaotises OmniProxyst. Mudeli ID on nimi, mida kasutatakse mudeli täpseks tuvastamiseks.

Ühenduse seadete hankimine OmniProxyst

Peate määrama järgmised kaks keskkonnamuutujat. Keskkonnamuutujad on terminaliprogrammide poolt loetavad ühenduse seaded:

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

OPENAI_API_BASE on API lõpp-punkt ja peab sisaldama /v1. OPENAI_API_KEY on API-le juurdepääsemiseks kasutatav võti.

Windowsis kasutage setx muutujate salvestamiseks. Pärast seda peate terminali uuesti avama:

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

Kopeerige kogu mudeli nimi praegusest OmniProxy loendist, sealhulgas kõik kaldkriipsud mudeli ID-s. Aideri käivitamisel lisage openai/ enne täielikku ID-d.

2026-10-09 seisuga on teenusepakkuja dokumentatsioonis kaks viite-ID-d gemini-3.8-flash ja grok-4.7. Kui neid nimesid praeguses loendis pole, ärge kopeerige neid otse. Kasutage täielikku ID-d, mis tegelikult loendis esineb.

Aadress

OPENAI_API_BASE

• Suunake see OmniProxyle
• Lisage /v1
• Ärge pange seda hoidlasse

Võti

OPENAI_API_KEY

• Kasutage lüüsi pakutavat
• Pärast muutmist avage Windowsi terminalid uuesti
• Hoidke teenusepakkuja võtmeid lüüsis

Käivitamine

openai/mudel

• cd projekti kataloogi
• Lisage mudeli nimele eesliide openai/
• Kasutage nime lüüsi loendist

Tööriista seadistamine

Te ei pea looma eraldi konfiguratsioonifaili. Sisenege projekti kataloogi, käivitage Aider ja asendage mudeli ID nimega, mis tegelikult praeguses OmniProxy loendis eksisteerib:

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

Teise näidismudeli kasutamiseks käivitage:

aider --model openai/grok-4.7

Kui Aider kohtab tundmatut mudelit, kuvab see hoiatuse. See hoiatus ei tähenda iseenesest, et lõpp-punkt on vale. Kontrollige OmniProxy päringuloge, et kinnitada, kas päring ilmus.

Aider lisab konteksti ainult Giti poolt jälgitavad failid. Kontekst on kood ja teave, mida mudel saab praeguse ülesande ajal lugeda. Kui praegune kataloog pole veel Giti hoidla, loob Aider selle, kuid Giti poolt mittejälgitavaid faile ei saa endiselt lugeda. Kasutage git add failide lisamiseks ja nende commitimiseks enne Aideri käivitamist.

Aider saab faile siiski muuta. --no-auto-commits keelab ainult automaatsed commitid; see ei takista failide muutmist. Aideri esmakordsel kasutamisel valige ebaoluline hoidla ja käivitage git diff pärast ülesannet, et tegelikke muudatusi üle vaadata.

Ärge pange tegelikke võtmeid projektifailidesse ega avalikele lehtedele. Hoidke teenusepakkuja võtmeid ainult OmniProxys. Kui lüüs võtmeid ei valideeri, saate määrata OPENAI_API_KEY kohahoidja stringiks, mida kasutatakse ainult teie kohalikus arvutis.

Kontrollimine reaalse ülesandega

Esmalt veenduge, et fail, mida soovite Aideril lugeda, on Giti commititud. Seejärel käivitage projekti kataloogist järgmine käsk. Asendage mudeli ID täieliku ID-ga praegusest OmniProxy loendist:

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 saadab ülesande otse Aiderile, samas kui --no-auto-commits käsib Aideril selle käivituse ajal automaatselt Giti commite mitte luua.

2026-10-09 seisuga luges Aider v0.86.2 edukalt jälgitava faili esimest rida. Kui faili Git ei jälgi, ütleb Aider, et ta ei näe sisu. See ei tähenda, et API lõpp-punkt on vale. Pärast päringu lõpetamist kontrollige OmniProxy päringuloge, et kontrollida päringu allikat ja mudeli ID-d.

Käivitamine

aider käivitub

• Käsk on saadaval
• Keskkonnamuutujad on aktiivsed
• Projekti kataloogis

Ülesanne

See kontrollis faili

• Küsi konkreetse faili kohta
• Vaata selle selgitust
• Tundmatud mudelid võivad käivitada hoiatuse

Logid

Nähtav lüüsis

• Allikas on Aider
• Mudeli ID ühtib
• Võtit ei sisestatud lehel

Levinud vead

• aider ei leita: Avage esmalt terminal uuesti. Kui installisite selle otse pipiga, proovige python -m aider.
• Windows loob pärast muutujate muutmist endiselt ühenduse vana lõpp-punktiga: Pärast käivitamist peate terminali uuesti avama setx. Ainult uus aken loeb värskendatud muutujaid.
• Mudeli nimi ei alga openai/: Ühilduv API nõuab vormingut openai/<model-name>.
• Ilmub tundmatu mudeli hoiatus: See on tavaline hoiatus ja ei tähenda, et ühendus ebaõnnestus. Kontrollige, kas OmniProxy sai päringu.
• Mudeli ID on kehtetu: Kopeerige täielik ID uuesti praegusest OmniProxy loendist. Hoidke openai/ eesliide ja kõik ID-s juba olemasolevad kaldkriipsud.
• Aider ütleb, et faili sisu pole: Veenduge, et faili jälgib Git. Tühjas hoidlas olevaid faile või mittejälgitavaid faile konteksti ei lisata.

Ametlikud viited

Installimisetappide kohta vaadake Aideri installimine. Keskkonnamuutujate ja mudeli eesliite kohta vaadake OpenAI-ga ühilduvad API-d. Näidismudeli ID-d leiate Gemini mudelite loendist ja xAI mudelite lehelt.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · Aider ↗