Aider: агент для кода в терминале и подключение своих моделей

Данные на 26.10.2026

Aider это агент для программирования в терминале: он правит файлы проекта и делает коммиты в git. Модель подключается по API: задайте OPENAI_API_BASE и OPENAI_API_KEY и запустите aider --model openai/<модель>. AIShlyuz — один ключ ко всем моделям: base URL https://aishlyuz.ru/v1.

Факты ниже по документации Aider на 26.10.2026. Через наш ключ мы проверили Aider 0.86.2 с openai/deepseek-v4-pro и openai/claude-sonnet-5-5: правка файла и коммит прошли. Другие модели мы пока не проверяли.

Что такое Aider

Aider это харнесс, а не модель: он даёт модели доступ к файлам и git, а думает подключённая модель. Правки Aider делает коммитами в git, откат это обычный git. Aider open-source, лицензия Apache-2.0, репозиторий Aider-AI/aider.

Как установить Aider

Мы советуем Python 3.12: у нас Aider встал на 3.12, а на 3.13 не встал. По инструкции по установке способ aider-install ставит Aider в отдельное окружение и при необходимости сам ставит Python 3.12:

bash
python -m pip install aider-install
aider-install

Одной командой, Python 3.12 поставится сам, если нужно:

bash
# macOS и Linux
curl -LsSf https://aider.chat/install.sh | sh
powershell
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Есть ещё установка через uv и pipx, команды на той же странице.

Как подключить модели через OpenAI-совместимый API

macOS и Linux:

bash
export OPENAI_API_BASE=https://aishlyuz.ru/v1
export OPENAI_API_KEY=sk-ais-…
cd /путь/к/проекту
aider --model openai/deepseek-v4-pro

Windows:

powershell
setx OPENAI_API_BASE https://aishlyuz.ru/v1
setx OPENAI_API_KEY sk-ais-…

После setx перезапустите терминал, иначе переменные не подхватятся. Префикс openai/ перед именем модели обязателен: так Aider понимает, что модель идёт через OpenAI-совместимого провайдера. Id модели берите из /modeli или GET /v1/models. Ключ проверяется служебной моделью ais-test-1: она платную модель не вызывает, но баланс должен быть ненулевым (Подключение).

Предупреждения о незнакомых моделях

Если Aider не знает модель, он пишет «Unknown context window size and costs, using sane defaults» и использует значения по умолчанию. С нашими моделями это предупреждение появляется при запуске, на работу у нас оно не повлияло. Скрыть его можно флагом --no-show-model-warnings. По документации Aider это обычно не мешает работе. Если ошиблись в имени, Aider подскажет похожие. Убрать предупреждение можно через расширенные настройки модели Aider.

Какую модель взять

Модель под задачу, без привязки к одной: разбор в статье нейросеть для кода, цены на /modeli. Возможности моделей через наш ключ разные, смотрите карточку модели на /ceny.

Aider, Cline, OpenCode, Codex, Claude Code: чем отличаются

Частые вопросы

Что такое Aider?

Консольный агент для кода, который работает с git. Модели подключаются по API.

Как подключить Aider к своему API?

Задать OPENAI_API_BASE и OPENAI_API_KEY, затем aider --model openai/<модель>. Через нас адрес https://aishlyuz.ru/v1, так у нас работали openai/deepseek-v4-pro и openai/claude-sonnet-5-5.

Зачем префикс openai/ в имени модели?

Так Aider понимает, что модель идёт через OpenAI-совместимого провайдера.

Почему Aider пишет предупреждение о модели?

Aider не знает параметры этой модели и берёт значения по умолчанию. У нас это на работу не повлияло, скрыть можно флагом --no-show-model-warnings, детали в документации Aider.

Aider бесплатный?

Программа бесплатная, open-source под Apache-2.0. Запросы к моделям оплачиваются у провайдера, у нас по токенам, цены на /modeli.