„Aider“ diegimas ir „OmniProxy“ konfigūravimas

„Aider“ yra įrankis, padedantis keisti kodą iš terminalo. Jis sukuria viso kodo bazės žemėlapį, kad modelis galėtų suprasti didesnius projektus. „Git“ yra versijų valdymo įrankis, fiksuojantis kodo pakeitimus, leidžiantis peržiūrėti skirtumus ir atkurti ankstesnes versijas. Kai pateikiate „Aider“ užduotį, ji apdorojama žingsnis po žingsnio ir įrašomi „commit“ pranešimai. Jei pakeitimai nepatinka, galite juos atšaukti naudodami /undo.

Prieš pradedant

Yra du įprasti diegimo būdai:

• Jei jūsų kompiuteryje jau yra „Python 3.8“–„3.13“, įdiekite aider-install pirmiausia. „Python“ yra „Aider“ reikalinga vykdymo aplinka.

„Mac“ ir „Linux“

install.sh

• Vykdykite su „sh“ po „curl“
• Įdiegia „Python“, jei reikia
• Naudokite „wget“, jei „curl“ nepasiekiamas

„Windows“

install.ps1

• Vykdykite „PowerShell“
• Po diegimo iš naujo atidarykite terminalą
• Nustatykite aplinkos kintamuosius su „setx“

„Python“ jau įdiegtas

aider-install

• Pirmiausia įdiekite šį paketą su „pip“
• Tada vykdykite „aider-install“
• Jis sukuria savo aplinką

Įsitikinkite, kad „OmniProxy“ veikia. Po diegimo, prieš paleisdami „Aider“, pereikite į projekto katalogą, kurį planuojate keisti.

Diegimas ir pirmasis paleidimas

Jei jau turite „Python 3.8“–„3.13“

Vykdykite šias komandas paeiliui:

python -m pip install aider-install
aider-install

aider-install įdiegia „Aider“ atskiroje „Python“ aplinkoje, kad ji netrukdytų kitiems jūsų kompiuterio „Python“ projektams. Prireikus ji taip pat įdiegia „Python 3.12“, kurį naudos „Aider“.

Vieno žingsnio diegimas

„Mac“ ir „Linux“ sistemose vykdykite:

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

Jei „curl“ neįdiegtas, naudokite:

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

„Windows PowerShell“ vykdykite:

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

Šios vieno žingsnio komandos pagrįstos „uv“ – programa, skirta „Python“ įrankiams ir aplinkoms diegti bei valdyti. Taip pat galite naudoti šią komandą:

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

Taip pat galite naudoti „pipx“. Diegiant tiesiogiai su python -m pip install aider-chat, palaikomos „Python“ versijos yra 3.9–3.12. Tačiau tai yra alternatyvus diegimo būdas, todėl teikite pirmenybę aukščiau aprašytiems metodams. „Aider“ paketai iš sistemos paketų tvarkyklių gali turėti priklausomybių neatitikimų, todėl jie neturėtų būti pirmasis pasirinkimas.

2026-10-09 duomenimis, vieno žingsnio diegimo komanda įdiegė „Aider v0.86.2“. Diegimo metu galite pamatyti pranešimą, kad talpykla ir paskirties vieta yra skirtinguose diskuose ir kad failai bus nukopijuoti. Diegimas vis tiek bus baigtas.

Po diegimo pereikite į projekto katalogą. Suderinama API yra sąsaja, kuri bendrauja su kitomis modelių paslaugomis naudojant „OpenAI“ formatą. Paleiskite „Aider“ naudodami šį šabloną:

aider --model openai/<model-name>

Pakeiskite <model-name> visu modelio ID, nukopijuotu iš „OmniProxy“ kitame skyriuje. Modelio ID yra pavadinimas, naudojamas tiksliai identifikuoti modelį.

Gaukite ryšio nustatymus iš „OmniProxy“

Turite nustatyti šiuos du aplinkos kintamuosius. Aplinkos kintamuosius galima suprasti kaip ryšio nustatymų rinkinį, kurį nuskaito terminalo programos:

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

OPENAI_API_BASE yra API galinis taškas (endpoint) ir turi apimti /v1. OPENAI_API_KEY yra raktas, naudojamas prieigai prie API.

„Windows“ sistemoje naudokite setx kintamiesiems išsaugoti. Po to privalote iš naujo atidaryti terminalą:

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

Nukopijuokite visą modelio pavadinimą iš dabartinio „OmniProxy“ sąrašo, įskaitant visus pasviruosius brūkšnius modelio ID. Paleisdami „Aider“, pridėkite openai/ prieš visą ID.

2026-10-09 duomenimis, du nuorodų ID teikėjo dokumentacijoje yra gemini-3.8-flash ir grok-4.7. Jei šių pavadinimų nėra dabartiniame sąraše, nekopijuokite jų tiesiogiai. Naudokite visą ID, kuris iš tikrųjų rodomas sąraše.

Adresas

OPENAI_API_BASE

• Nurodykite į „OmniProxy“
• Įtraukite /v1
• Nedėkite jo į saugyklą

Raktas

OPENAI_API_KEY

• Naudokite tą, kurį pateikė šliuzas
• Pakeitus, iš naujo atidarykite „Windows“ terminalus
• Laikykite teikėjo raktus šliuze

Paleidimas

openai/model

• „cd“ į projekto katalogą
• Prieš modelio pavadinimą pridėkite „openai/“
• Naudokite pavadinimą iš šliuzo sąrašo

Įrankio konfigūravimas

Jums nereikia kurti atskiro konfigūracijos failo. Pereikite į projekto katalogą, paleiskite „Aider“ ir pakeiskite modelio ID pavadinimu, kuris iš tikrųjų egzistuoja dabartiniame „OmniProxy“ sąraše:

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

Norėdami naudoti kitą pavyzdinį modelį, vykdykite:

aider --model openai/grok-4.7

Kai „Aider“ susiduria su nepažįstamu modeliu, ji parodo įspėjimą. Šis įspėjimas savaime nereiškia, kad galinis taškas yra neteisingas. Patikrinkite „OmniProxy“ užklausų žurnalus, kad patvirtintumėte, ar užklausa pasirodė.

„Aider“ į kontekstą įtraukia tik tuos failus, kuriuos jau stebi „Git“. Kontekstas yra kodas ir informacija, kurią modelis gali perskaityti dabartinės užduoties metu. Jei dabartinis katalogas dar nėra „Git“ saugykla, „Aider“ ją sukuria, tačiau failų, kurių „Git“ nestebi, vis tiek negalima perskaityti. Naudokite git add failams pridėti ir įrašyti (commit) prieš paleidžiant „Aider“.

„Aider“ vis tiek gali keisti failus. --no-auto-commits tik išjungia automatinius „commit“; tai neužkerta kelio failų pakeitimams. Pirmą kartą naudodami „Aider“, pasirinkite nesvarbią saugyklą ir vykdykite git diff po užduoties, kad peržiūrėtumėte tikruosius pakeitimus.

Nelaikykite tikrų raktų projekto failuose ar viešuosiuose puslapiuose. Teikėjų raktus saugokite tik „OmniProxy“. Jei šliuzas nepatvirtina raktų, galite nustatyti OPENAI_API_KEY į vietos rezervavimo ženklų eilutę, naudojamą tik jūsų vietiniame kompiuteryje.

Patikrinimas su tikra užduotimi

Pirmiausia įsitikinkite, kad failas, kurį norite, kad „Aider“ perskaitytų, buvo įrašytas į „Git“. Tada vykdykite šią komandą iš projekto katalogo. Pakeiskite modelio ID visu ID iš dabartinio „OmniProxy“ sąrašo:

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 siunčia užduotį tiesiai į „Aider“, o --no-auto-commits nurodo „Aider“ automatiškai nekuri „Git“ įrašų šio vykdymo metu.

2026-10-09 duomenimis, „Aider v0.86.2“ sėkmingai perskaitė pirmąją stebimo failo eilutę. Jei failo nestebi „Git“, „Aider“ pasakys, kad nemato turinio. Tai nereiškia, kad API galinis taškas yra neteisingas. Baigę užklausą, patikrinkite „OmniProxy“ užklausų žurnalus, kad patikrintumėte užklausos šaltinį ir modelio ID.

Paleidimas

„aider“ paleidžiama

• Komanda pasiekiama
• Aplinkos kintamieji aktyvūs
• Projekto kataloge

Užduotis

Ji patikrino failą

• Klausti apie konkretų failą
• Peržiūrėti jos paaiškinimą
• Nepažįstami modeliai gali sukelti įspėjimą

Žurnalai

Matomi šliuze

• Šaltinis yra „Aider“
• Modelio ID atitinka
• Raktas nebuvo įvestas puslapyje

Dažnos klaidos

• aider nerasta: Pirmiausia iš naujo atidarykite terminalą. Jei įdiegėte tiesiogiai su „pip“, bandykite python -m aider.
• „Windows“ vis tiek jungiasi prie seno galinio taško pakeitus kintamuosius: Privalote iš naujo atidaryti terminalą po to, kai paleidote setx. Tik naujas langas nuskaitys atnaujintus kintamuosius.
• Modelio pavadinimas neprasideda openai/: Suderinamai API reikalingas formatas openai/<model-name>.
• Pasirodo įspėjimas apie nepažįstamą modelį: Tai įprastas įspėjimas ir nereiškia, kad ryšys nepavyko. Patikrinkite, ar „OmniProxy“ gavo užklausą.
• Modelio ID neteisingas: Dar kartą nukopijuokite visą ID iš dabartinio „OmniProxy“ sąrašo. Išlaikykite openai/ priešdėlį ir visus pasviruosius brūkšnius, jau esančius ID.
• „Aider“ sako, kad nėra failo turinio: Įsitikinkite, kad failą stebi „Git“. Tuščios saugyklos failai arba nestebimi failai neįtraukiami į kontekstą.

Oficialios nuorodos

Diegimo veiksmus žr. „Aider“ diegimas. Aplinkos kintamuosius ir modelio priešdėlį žr. „OpenAI“ suderinamos API. Pavyzdinius modelių ID galite rasti „Gemini“ modelių sąraše ir xAI modelių puslapyje.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · Aider ↗