Aider: что это за ИИ-ассистент для кода и как он работает с git

Если вы искали «aider что это», коротко: Aider — это программа для терминала, в которой вы ставите задачу обычным текстом, а языковая модель правит файлы вашего репозитория. Каждое изменение сразу попадает в git-коммит, поэтому любой шаг можно посмотреть и откатить. Ниже — как это устроено, чем Aider отличается от агентов вроде Claude Code и во сколько обходится работа, если подключить его к API-шлюзу.

Aider ai: что именно делает программа

В документации проект описан как парное программирование с ИИ в терминале. Вы запускаете aider в папке с git-репозиторием, указываете файлы, которые нужно менять, и пишете запрос на приглашении >. Aider отправляет модели ваш запрос, содержимое выбранных файлов и «карту» остального кода, получает правки и применяет их к файлам на диске.

Это не плагин для редактора и не облачный сервис: сама программа работает локально, а за генерацию отвечает модель, которую вы подключили по API. Какую взять — решаете вы. Документация говорит, что Aider умеет работать почти с любой моделью, включая локальные, и предлагает переключаться между ними прямо в чате командой /model.

Как Aider работает с git

Работа с git — главная особенность программы. По документации:

• если запустить Aider в папке без репозитория, он предложит его создать;
• после каждой правки он делает коммит с описательным сообщением, по умолчанию в стиле Conventional Commits;
• если в файле есть ваши незакоммиченные изменения, Aider сначала фиксирует их отдельным коммитом, чтобы ваши правки не смешались с машинными;
• к имени автора или коммитера в таких коммитах добавляется пометка (aider), так что в истории видно, что сделала программа.

Для управления есть команды внутри чата: /diff показывает изменения с прошлого сообщения, /undo отменяет последнюю правку, /commit фиксирует то, что вы поменяли руками, /git запускает произвольную git-команду. Автокоммиты можно выключить флагом --no-auto-commits, но разработчики этого не рекомендуют.

Практический вывод: Aider удобно пускать в отдельную ветку. Сделал не то — /undo или git reset, и вы снова в исходной точке.

Карта репозитория и файлы в чате

Файлы, которые Aider может менять, нужно «добавить в чат»: указать при запуске или командой /add. Документация советует добавлять только те файлы, которые нужны для задачи: чем их больше, тем легче запутать модель и тем больше токенов уходит.

Чтобы модель понимала остальной код, Aider строит карту репозитория: список файлов с ключевыми классами и функциями и их сигнатурами. Карта уходит модели вместе с каждым запросом. Если нужен код из файла, которого нет в чате, модель может его запросить, и Aider предложит добавить файл. Бюджет карты задаётся флагом --map-tokens (по умолчанию около 1 000 токенов), а Aider подстраивает размер карты под состояние чата.

Карта — это входные токены в каждом запросе. Отсюда два следствия для бюджета: большая карта и много файлов в чате заметно удорожают сессию, а команда /drop помогает освободить контекст.

Режимы работы

В Aider четыре режима:

Документация рекомендует чередовать /ask и /code: сначала обсудить план без изменений, потом коротко написать «делай» в режиме code. Это дешевле, чем исправлять неудачную правку. Режим architect использует две модели (основную и --editor-model), поэтому расходы считайте по обеим.

Установка

Для Python 3.8–3.13 документация предлагает такой путь:

python -m pip install aider-install
aider-install

Есть и однострочные установщики для macOS, Linux и Windows, а также установка через uv. Актуальные команды смотрите на странице установки aider.chat: они меняются.

Aider cli и свой ключ: подключение к шлюзу

Aider умеет работать с любым OpenAI-совместимым эндпоинтом. По документации, нужно задать переменные OPENAI_API_BASE и OPENAI_API_KEY, а имя модели начинать с префикса openai/. Для Zukko это выглядит так:

export OPENAI_API_BASE=https://api.zukko.pro/v1
export OPENAI_API_KEY=fetch_ваш_ключ

cd /путь/к/проекту
aider --model openai/gpt-6.1-sol --weak-model openai/deepseek-v4.1-flash

Адрес с /v1 на конце, потому что это OpenAI-формат. Флаг --weak-model задаёт дешёвую модель для служебных задач: по документации, именно она пишет сообщения коммитов. Если Aider не знает модель, он выведет предупреждение о ней: это нормально для моделей не из его встроенного списка, а раздел «Model warnings» объясняет, что оно значит. Актуальный перечень моделей и цен — в GET https://api.zukko.pro/v1/models или на странице «Модели» в кабинете. Подробный пошаговый разбор подключения есть в статье Aider: подключение к шлюзу↗.

Одно ограничение стоит знать заранее. Для Claude скидку за кэш промптов шлюз применяет только в Anthropic-формате, а Aider в этой связке ходит в /v1/chat/completions, поэтому весь вход у Claude считается по цене входа. У моделей GPT чтение кэша видно в обоих форматах.

Сколько стоит сессия: пример с формулой

Допустим, за сессию вы отправили 20 запросов, и в каждом было около 12 000 входных токенов (карта, файлы и история) и 800 токенов ответа. Итого 240 000 токенов входа и 16 000 выхода. Цены на 18 октября 2026, $ за 1M токенов:

Для сравнения, по официальным ценам gpt-6.1-sol (2 / 10) та же сессия стоила бы 0.24 × 2 + 0.016 × 10 = $0.64. Цифры в таблице — пример при заданных допущениях, не измерение: реальный расход зависит от размера репозитория и числа файлов в чате. Список и цены моделей меняются, ориентируйтесь на GET /v1/models.

Когда Aider подходит, а когда нет

Aider хорош, когда вам важны чистая история git, контроль над тем, какие файлы видит модель, и свобода выбора модели. Он менее удобен, если нужен агент, который сам ходит по проекту и подолгу работает сериями шагов без вашего участия: для этого смотрите сравнение Claude Code и Aider↗. Какая модель справится с вашими задачами лучше, заранее не скажет никто: проверьте две-три на своём репозитории. Ориентиры — цена, контекст и индекс силы из таблицы моделей.

Чтобы попробовать, создайте ключ в кабинете↗ и подставьте его в OPENAI_API_KEY. Пополнение от $1; оплата доступна через СБП (платёжная страница добавляет 8,5% сверху), криптовалюту или карты MasterCard. Формат запросов описан в справке по chat completions↗.

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

Aider — это бесплатно?

Сама программа бесплатная, она распространяется как открытый проект. Платить нужно за токены выбранной модели, а если взять локальную модель, то только за своё железо.

Aider изменит файлы без моего ведома?

Он правит только файлы, добавленные в чат, и делает коммит после каждой правки. Смотрите изменения командой /diff, откатывайте /undo. Для порядка запускайте его в отдельной ветке.

Чем Aider отличается от Cursor или Claude Code?

Aider работает в терминале и построен вокруг git: правка, коммит, откат. Cursor — это редактор, Claude Code — агент, который сам исследует проект и запускает команды. Что удобнее, зависит от привычек и задач.

Какую модель выбрать для Aider?

Начните с недорогой модели вроде deepseek-v4.1-flash для рутины и сравните с более сильной на тех же задачах. Не опирайтесь на чужие оценки: прогоните свои три-пять типичных запросов и сравните результат и стоимость.