Инсталиране на Aider и конфигуриране на OmniProxy

Aider е инструмент, който помага при промяната на код директно от терминала. Той създава карта на целия проект, за да помогне на модела да разбере по-големи кодови бази. Git е инструмент за контрол на версиите, който записва промените в кода, позволявайки ви да преглеждате разликите и да възстановявате предишни версии. След като зададете задача на Aider, той я обработва стъпка по стъпка и записва съобщения за комит. Ако не харесвате промените, можете да ги отмените с /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 крайната точка и трябва да включва /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 срещне непознат модел, той показва предупреждение. Това предупреждение само по себе си не означава, че крайната точка е неправилна. Проверете регистрационните файлове (logs) на OmniProxy, за да потвърдите дали заявката се е появила.

Aider добавя към контекста само файлове, които вече се проследяват от Git. Контекстът е кодът и информацията, които моделът може да чете по време на текущата задача. Ако текущата директория все още не е Git хранилище, Aider ще създаде такова, но файловете, които Git не проследява, все още няма да могат да бъдат прочетени. Използвайте git add за да добавите файловете и да ги комитнете, преди да стартирате Aider.

Aider все още може да променя файлове. --no-auto-commits само деактивира автоматичните комити; това не предотвратява промените във файловете. Когато използвате Aider за първи път, изберете маловажно хранилище и изпълнете git diff след задачата, за да прегледате действителните промени.

Не поставяйте реални ключове във файлове на проекти или публични страници. Съхранявайте ключовете на доставчика само в OmniProxy. Ако шлюзът не валидира ключове, можете да зададете OPENAI_API_KEY на заместващ низ, използван само на вашия локален компютър.

Проверка с реална задача

Първо се уверете, че файлът, който искате Aider да прочете, е бил комитнат в 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 комити автоматично по време на това изпълнение.

Към 2026-10-09, Aider v0.86.2 успешно прочете първия ред на проследен файл. Ако файлът не се проследява от Git, Aider ще каже, че не може да види съдържанието. Това не означава, че крайната точка на API е неправилна. След завършване на заявката, проверете регистрационните файлове на OmniProxy, за да потвърдите източника на заявката и ID на модела.

Стартиране

Aider се стартира

Командата е налична
Променливите на средата са активни
В директорията на проекта

Задача

Файлът е инспектиран

Попитайте за конкретен файл
Прегледайте обяснението му
Непознати модели могат да предизвикат предупреждение

Регистрационни файлове (Logs)

Видими в шлюза

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

Потвърдете, че променливите на средата са активни и командата е налична, след което изпълнете една реална заявка.

Чести грешки

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

Официални справки

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

Заменете всяка плейсхолдер стойност със стойности от вашата собствена конфигурация на OmniProxy. Никога не публикувайте истински ключ.

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

Официални източници · Aider ↗