Aider instalācija un OmniProxy konfigurācija

Aider ir rīks, kas palīdz modificēt kodu no termināļa. Tas izveido visa koda bāzes karti, lai palīdzētu modelim izprast lielākus projektus. Git ir versiju kontroles rīks, kas reģistrē koda izmaiņas, ļaujot pārbaudīt atšķirības un atjaunot iepriekšējās versijas. Pēc tam, kad esat devuši Aider uzdevumu, tas apstrādā uzdevumu soli pa solim un ieraksta “commit” ziņojumus. Ja jums nepatīk izmaiņas, varat tās atsaukt ar /undo.

Pirms sākat

Ir divas izplatītas instalēšanas iespējas:

• Ja jūsu datorā jau ir Python 3.8 līdz 3.13, instalējiet aider-install vispirms. Python ir izpildlaika vide, kas nepieciešama Aider.

Mac un Linux

install.sh

• Palaist ar sh pēc curl
• Instalē Python, ja nepieciešams
• Izmantojiet wget, ja curl nav pieejams

Windows

install.ps1

• Palaist PowerShell
• Pēc instalēšanas atkārtoti atveriet termināli
• Iestatiet vides mainīgos ar setx

Python jau instalēts

aider-install

• Vispirms instalējiet šo pakotni ar pip
• Pēc tam palaidiet aider-install
• Tas izveido savu vidi

Pārliecinieties, ka OmniProxy darbojas. Pēc instalēšanas pirms Aider palaišanas ievadiet projekta direktoriju, kuru plānojat modificēt.

Instalēšana un pirmā palaišana

Ja jums jau ir Python 3.8 līdz 3.13

Palaidiet šīs komandas secībā:

python -m pip install aider-install
aider-install

aider-install instalē Aider atsevišķā Python vidē, lai tas netraucētu citiem Python projektiem jūsu datorā. Kad nepieciešams, tas arī instalē Python 3.12, ko Aider var izmantot.

Vienas rindiņas instalēšana

Mac un Linux sistēmās palaidiet:

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

Ja curl nav instalēts, izmantojiet:

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

Windows PowerShell palaidiet:

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

Šīs vienas rindiņas komandas ir balstītas uz uv, programmu Python rīku un vides instalēšanai un pārvaldībai. Varat arī izmantot šādu komandu:

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

Varat arī izmantot pipx. Instalējot tieši ar python -m pip install aider-chat, atbalstītās Python versijas ir no 3.9 līdz 3.12. Tomēr šī ir alternatīva instalēšanas metode, tāpēc dodiet priekšroku iepriekš aprakstītajām metodēm. Aider pakotnēm no sistēmas pakotņu pārvaldniekiem var būt atkarību neatbilstības, tāpēc tām nevajadzētu būt jūsu pirmajai izvēlei.

2026-10-09 vienas rindiņas instalēšanas komanda instalēja Aider v0.86.2. Instalēšanas laikā varat redzēt ziņojumu, ka kešatmiņa un mērķa vieta atrodas dažādos diskos un ka faili tiks kopēti. Instalēšana tik un tā tiks pabeigta.

Pēc instalēšanas ievadiet projekta direktoriju. Saderīgs API ir saskarne, kas sazinās ar citiem modeļu pakalpojumiem, izmantojot OpenAI formātu. Palaidiet Aider, izmantojot šo modeli:

aider --model openai/<model-name>

Aizstājiet <model-name> ar pilnu modeļa ID, kas nokopēts no OmniProxy nākamajā sadaļā. Modeļa ID ir nosaukums, ko izmanto, lai precīzi identificētu modeli.

Savienojuma iestatījumu iegūšana no OmniProxy

Jums ir jāiestata šādi divi vides mainīgie. Vides mainīgos var saprast kā savienojuma iestatījumu kopu, ko nolasa termināļa programmas:

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

OPENAI_API_BASE ir API galapunkts, un tajā jāiekļauj /v1. OPENAI_API_KEY ir atslēga, ko izmanto piekļuvei API.

Windows sistēmā izmantojiet setx lai saglabātu mainīgos. Pēc tam jums ir jāatver terminālis atkārtoti:

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

Nokopējiet visu modeļa nosaukumu no pašreizējā OmniProxy saraksta, ieskaitot visas slīpsvītras modeļa ID. Sākot Aider, pievienojiet openai/ pirms pilna ID.

Uz 2026-10-09 divi atsauces ID pakalpojumu sniedzēja dokumentācijā bija gemini-3.8-flash un grok-4.7. Ja šie nosaukumi nav pašreizējā sarakstā, nekopējiet tos tieši. Izmantojiet pilnu ID, kas faktiski parādās sarakstā.

Adrese

OPENAI_API_BASE

• Norādiet to uz OmniProxy
• Iekļaujiet /v1
• Nelieciet to repozitorijā

Atslēga

OPENAI_API_KEY

• Izmantojiet vārtejas nodrošināto
• Pēc izmaiņām atkārtoti atveriet Windows termināļus
• Glabājiet pakalpojumu sniedzēja atslēgas vārtejā

Palaišana

openai/model

• cd uz projekta direktoriju
• Pievienojiet modeļa nosaukumam prefiksu openai/
• Izmantojiet nosaukumu no vārtejas saraksta

Rīka konfigurācijas ievadīšana

Jums nav jāizveido atsevišķs konfigurācijas fails. Ievadiet projekta direktoriju, palaidiet Aider un aizstājiet modeļa ID ar nosaukumu, kas faktiski pastāv pašreizējā OmniProxy sarakstā:

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

Lai izmantotu otru piemēra modeli, palaidiet:

aider --model openai/grok-4.7

Kad Aider saskaras ar nepazīstamu modeli, tas parāda brīdinājumu. Šis brīdinājums pats par sevi nenozīmē, ka galapunkts ir nepareizs. Pārbaudiet OmniProxy pieprasījumu žurnālus, lai apstiprinātu, vai pieprasījums parādījās.

Aider kontekstam pievieno tikai tos failus, kurus jau izseko Git. Konteksts ir kods un informācija, ko modelis var nolasīt pašreizējā uzdevuma laikā. Ja pašreizējā direktorija vēl nav Git repozitorijs, Aider to izveido, taču failus, kurus Git neizseko, joprojām nevar nolasīt. Izmantojiet git add lai pievienotu failus un tos apstiprinātu (commit) pirms Aider palaišanas.

Aider joprojām var modificēt failus. --no-auto-commits tikai atspējo automātiskos “commit” ierakstus; tas neliedz failu modifikācijas. Pirmo reizi izmantojot Aider, izvēlieties nesvarīgu repozitoriju un palaidiet git diff pēc uzdevuma, lai pārskatītu faktiskās izmaiņas.

Nelieciet īstas atslēgas projekta failos vai publiskās lapās. Glabājiet pakalpojumu sniedzēja atslēgas tikai OmniProxy. Ja vārteja nevalidē atslēgas, varat iestatīt OPENAI_API_KEY uz viettura virkni, ko izmanto tikai jūsu vietējā datorā.

Verifikācija ar reālu uzdevumu

Vispirms pārliecinieties, ka fails, kuru vēlaties, lai Aider nolasa, ir apstiprināts (commit) Git. Pēc tam palaidiet šo komandu no projekta direktorijas. Aizstājiet modeļa ID ar pilnu ID no pašreizējā OmniProxy saraksta:

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 nosūta uzdevumu tieši uz Aider, savukārt --no-auto-commits liek Aider automātiski neveidot Git “commit” ierakstus šīs izpildes laikā.

2026-10-09 Aider v0.86.2 veiksmīgi nolasīja izsekota faila pirmo rindiņu. Ja Git neizseko failu, Aider paziņos, ka nevar redzēt saturu. Tas nenozīmē, ka API galapunkts ir nepareizs. Pēc vaicājuma pabeigšanas pārbaudiet OmniProxy pieprasījumu žurnālus, lai pārbaudītu pieprasījuma avotu un modeļa ID.

Palaišana

Aider palaišana

• Komanda ir pieejama
• Vides mainīgie ir aktīvi
• Projekta direktorijā

Uzdevums

Tas pārbaudīja failu

• Jautāt par konkrētu failu
• Pārskatīt tā skaidrojumu
• Nepazīstami modeļi var izraisīt brīdinājumu

Žurnāli

Redzams vārtejā

• Avots ir Aider
• Modeļa ID atbilst
• Atslēga netika ievadīta lapā

Biežākās kļūdas

• aider nevar atrast: Vispirms atkārtoti atveriet termināli. Ja instalējāt to tieši ar pip, mēģiniet python -m aider.
• Windows joprojām savienojas ar veco galapunktu pēc mainīgo maiņas: Pēc setx palaišanas terminālis ir jāatver atkārtoti. Tikai jauns logs nolasīs atjauninātos mainīgos.
• Modeļa nosaukums nesākas ar openai/: Saderīgam API ir nepieciešams formāts openai/<model-name>.
• Parādās brīdinājums par nepazīstamu modeli: Šis ir normāls brīdinājums un nenozīmē, ka savienojums neizdevās. Pārbaudiet, vai OmniProxy saņēma pieprasījumu.
• Modeļa ID nav derīgs: Vēlreiz nokopējiet pilnu ID no pašreizējā OmniProxy saraksta. Saglabājiet openai/ prefiksu un visas slīpsvītras, kas jau ir ID.
• Aider saka, ka nav faila satura: Pārliecinieties, ka Git izseko failu. Faili tukšā repozitorijā vai neizsekoti faili netiek pievienoti kontekstam.

Oficiālās atsauces

Instalēšanas darbības skatiet Aider instalācija. Vides mainīgos un modeļa prefiksu skatiet OpenAI saderīgi API. Modeļu ID piemērus var atrast Gemini modeļu sarakstā un xAI modeļu lapā.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · Aider ↗