Aider инсталација и OmniProxy конфигурација

Aider је алат који помаже у изменама кода директно из терминала. Он прави мапу целог пројекта како би помогао моделу да разуме веће кодове. Git је алат за контролу верзија који бележи измене, омогућавајући вам да видите разлике и вратите претходне верзије. Након што задате задатак, Aider га обрађује корак по корак и пише поруке уз commit. Ако вам се измене не допадају, можете их поништити помоћу /undo.

Пре почетка

Постоје две уобичајене опције за инсталацију:

Ако на рачунару већ имате Python верзије од 3.8 до 3.13, инсталирајте aider-install прво. Python је окружење неопходно за рад Aider-а.

Mac и Linux

install.sh

Покрените са sh након curl
Инсталира Python ако је потребно
Користите wget ако curl није доступан

Windows

install.ps1

Покрените у PowerShell-у
Поново отворите терминал након инсталације
Подесите променљиве окружења помоћу setx

Python је већ инсталиран

aider-install

Прво инсталирајте овај пакет помоћу pip
Затим покрените aider-install
Креира сопствено окружење

Инсталатер у једној линији подешава Python 3.12 када је потребно. Директна инсталација aider-chat пакета помоћу pip-а је мање поуздана.

Уверите се да је OmniProxy покренут. Након инсталације, уђите у директоријум пројекта који желите да мењате пре него што покренете Aider.

Инсталација и прво покретање

Ако већ имате Python од 3.8 до 3.13

Извршите ове команде редом:

python -m pip install aider-install
aider-install

aider-install инсталира Aider у посебно Python окружење како не би ометао друге пројекте на вашем рачунару. Када је потребно, такође инсталира Python 3.12 за потребе Aider-а.

Инсталација у једној линији

На Mac-у и Linux-у, покрените:

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

Ако curl није инсталиран, користите:

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

У Windows PowerShell-у, покрените:

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

Ове команде се заснивају на uv-у, програму за инсталацију и управљање Python алатима и окружењима. Такође можете користити следећу команду:

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

Можете користити и pipx. Када инсталирате директно помоћу python -m pip install aider-chat, подржане верзије Python-а су од 3.9 до 3.12. Међутим, ово је алтернативни метод, па дајте предност горе описаним методама. Aider пакети из системских менаџера пакета могу имати проблема са зависностима, па не би требало да буду ваш први избор.

На дан 2026-10-09, команда за инсталацију у једној линији је инсталирала Aider v0.86.2. Током инсталације, можда ћете видети поруку да су кеш и одредиште на различитим дисковима и да ће фајлови бити копирани. Инсталација ће се ипак успешно завршити.

Након инсталације, уђите у директоријум пројекта. Компатибилан API је интерфејс који комуницира са другим сервисним моделима користећи OpenAI формат. Покрените Aider користећи овај образац:

aider --model openai/<model-name>

Замените <model-name> пуним ID-јем модела који сте копирали из OmniProxy-а у следећем одељку. ID модела је назив који се користи за прецизну идентификацију модела.

Преузимање подешавања везе из OmniProxy-а

Потребно је да подесите следеће две променљиве окружења. Променљиве окружења се могу разумети као скуп подешавања везе које читају програми у терминалу:

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

OPENAI_API_BASE је API крајња тачка (endpoint) и мора укључивати /v1. OPENAI_API_KEY је кључ који се користи за приступ API-ју.

На Windows-у, користите setx да сачувате променљиве. Након тога морате поново отворити терминал:

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

Копирајте пун назив модела са тренутне OmniProxy листе, укључујући све косе црте у ID-ју модела. Када покрећете Aider, додајте openai/ пре пуног ID-ја.

На дан 2026-10-09, два референтна ID-ја у документацији провајдера су била gemini-3.8-flash и grok-4.7. Ако ови називи нису на тренутној листи, немојте их копирати директно. Користите пун ID који се заиста појављује на листи.

Адреса

OPENAI_API_BASE

Усмерите је на OmniProxy
Укључите /v1
Не стављајте је у репозиторијум

Кључ

OPENAI_API_KEY

Користите онај који је обезбедио гејтвеј
Поново отворите Windows терминале након промене
Чувајте кључеве провајдера у гејтвеју

Покретање

openai/model

cd у директоријум пројекта
Додајте префикс openai/ називу модела
Користите назив са листе гејтвеја

Две променљиве окружења, заједно са називом модела са префиксом openai/, чине синтаксису компатибилног API-ја.

Унос конфигурације алата

Не морате креирати посебан конфигурациони фајл. Уђите у директоријум пројекта, покрените Aider и замените ID модела називом који заиста постоји на тренутној OmniProxy листи:

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

Да бисте користили други пример модела, покрените:

aider --model openai/grok-4.7

Када Aider наиђе на непознат модел, приказује упозорење. Ово упозорење само по себи не значи да је крајња тачка неисправна. Проверите OmniProxy логове захтева да бисте потврдили да ли се захтев појавио.

Aider додаје у контекст само фајлове које Git већ прати. Контекст је код и информације које модел може да чита током тренутног задатка. Ако тренутни директоријум још увек није Git репозиторијум, Aider ће га креирати, али фајлове које Git не прати и даље неће моћи да чита. Користите git add да додате фајлове и commit-ујете их пре покретања Aider-а.

Aider и даље може да мења фајлове. --no-auto-commits само онемогућава аутоматске commit-е; не спречава измене фајлова. Када први пут користите Aider, изаберите небитан репозиторијум и покрените git diff након задатка да прегледате стварне измене.

Не стављајте праве кључеве у фајлове пројекта или на јавне странице. Чувајте кључеве провајдера само у OmniProxy-у. Ако гејтвеј не проверава кључеве, можете подесити OPENAI_API_KEY на placeholder стринг који се користи само на вашем локалном рачунару.

Верификација са стварним задатком

Прво, уверите се да је фајл који желите да Aider чита commit-ован у Git. Затим покрените следећу команду из директоријума пројекта. Замените ID модела пуним ID-јем са тренутне 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 шаље задатак директно Aider-у, док --no-auto-commits говори Aider-у да не креира Git commit-е аутоматски током овог покретања.

На дан 2026-10-09, Aider v0.86.2 је успешно прочитао прву линију праћеног фајла. Ако фајл није праћен од стране Git-а, Aider ће рећи да не може да види садржај. То не значи да је API крајња тачка неисправна. Након завршетка упита, проверите OmniProxy логове захтева да бисте потврдили извор захтева и ID модела.

Покретање

Aider се покреће

Команда је доступна
Променљиве окружења су активне
У директоријуму пројекта

Задатак

Прегледао је фајл

Питајте о одређеном фајлу
Прегледајте његово објашњење
Непознати модели могу изазвати упозорење

Логови

Видљиви у гејтвеју

Извор је Aider
ID модела се поклапа
Кључ није унет на страници

Потврдите да су променљиве окружења активне и да је команда доступна, а затим извршите један стварни упит.

Честе грешке

aider се не може пронаћи: Прво поново отворите терминал. Ако сте га инсталирали директно помоћу pip-а, покушајте python -m aider.
Windows се и даље повезује на стару крајњу тачку након промене променљивих: Морате поново отворити терминал након покретања setx. Само нови прозор ће прочитати ажуриране променљиве.
Назив модела не почиње са openai/: Компатибилни API захтева формат openai/<model-name>.
Појављује се упозорење о непознатом моделу: Ово је нормално упозорење и не значи да веза није успела. Проверите да ли је OmniProxy примио захтев.
ID модела је неважећи: Поново копирајте комплетан ID са тренутне OmniProxy листе. Задржите openai/ префикс и све косе црте које су већ присутне у ID-ју.
Aider каже да нема садржаја фајла: Уверите се да је фајл праћен од стране Git-а. Фајлови у празном репозиторијуму или непраћени фајлови се не додају у контекст.

Званичне референце

За кораке инсталације, погледајте Aider инсталација. За променљиве окружења и префикс модела, погледајте OpenAI компатибилни API-ји. Пример ID-јева модела се може наћи у Gemini листи модела и на xAI страници модела.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

Сачувани резултат или HTTP 200 сами по себи не доказују пуну компатибилност Агента. Проверите извор и модел у запису позива OmniProxy.

Званични извори · Aider ↗