Гайды

Aider CLI: установка, модели и расход токенов

10 сентября 2026 · 13 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Установку и замеры расхода токенов мы сделали на своей машине 10 сентября 2026 года, документацию и репозиторий вендора сняли в тот же день. Обновлено: сентябрь 2026.

Aider CLI — консольный ИИ-агент парного программирования. Он живёт в терминале, строит карту git-репозитория, правит файлы на диске и коммитит каждую правку сам. Инструмент открыт под лицензией Apache-2.0 и бесплатен, деньги уходят провайдеру модели за токены. Ставится питоном, но коридор поддерживаемых версий уже, чем написано на сайте: на Python 3.14 свежий пакет не встаёт.

Главное:

• Пакет называется aider-chat, последняя версия на PyPI — 0.86.2, ей нужен Python не ниже 3.10 и строго ниже 3.13.
• На Python 3.14 pip install aider-chat молча берёт релиз 0.16.0 от октября 2023 года и падает на его зависимостях.
• Запрос, который ещё ничего не сделал, стоит 1 953–2 071 токена: столько занимает системный промпт Aider.
• Автокоммит включён по умолчанию, отключается ключом --no-auto-commits, откатывается командой /undo.
• Графический интерфейс есть в двух видах, и оба ставятся отдельно от основного пакета.

Что такое Aider CLI и за что в нём платят

Aider — открытый консольный агент для работы с кодом, репозиторий на GitHub называется Aider-AI/aider, лицензия Apache-2.0. Формулировка вендора: «AI pair programming in your terminal». Отличие от чата: Aider CLI применяет правку к файлу в вашем репозитории и сразу фиксирует её коммитом.

Счётчики на главной вендора: 44K звёзд, 6.8M установок, 15B токенов в неделю, 88% «Singularity» — доли кода, написанной самим Aider. Живой ответ GitHub API 10 сентября 2026 года даёт 48 868 звёзд: счётчик на сайте отстал.

Платит пользователь провайдеру модели. Aider подключается к API OpenAI, Anthropic, Google, DeepSeek, xAI, Azure, Amazon Bedrock, OpenRouter и GitHub Copilot, а также к локальным моделям через Ollama. Устройство соседнего агента разобрано в тексте про Claude Code, ключ к дешёвым моделям — в разборе OpenRouter.

Мини-вывод: сам Aider CLI бесплатен, счёт приходит от провайдера модели.

Как скачать Aider: способы установки и версии Python

Вендор Aider описывает шесть способов установки — мы пересчитали разделы на странице install.html. Рекомендованный — пакет-установщик: python -m pip install aider-install, затем aider-install; он разворачивает агента в отдельном окружении и при необходимости ставит отдельный Python 3.12. Однострочники на базе uv: curl -LsSf https://aider.chat/install.sh | sh для Mac и Linux, для Windows — PowerShell. Через uv напрямую — uv tool install --force --python python3.12 --with pip aider-chat@latest. Через pipx — python -m pip install pipx, затем pipx install aider-chat. Пятый способ — обычный pip install aider-chat в виртуальное окружение. Шестой, системные пакетные менеджеры, вендор не советует: «they often install aider with incorrect dependencies».

Коридор версий Python на этой же странице назван четыре раза, а значений в нём два: «python 3.8-3.13» у aider-install и у uv, «python versions 3.9-3.12» у pipx и у pip. Метаданные пакета на PyPI дают третий ответ: у версии 0.86.2 поле requires_python равно <3.13,>=3.10. Русские страницы топа повторяют сайт: n202.ru — «Требуется Python 3.8–3.13», vibecoding.ru — то же.

Проверять пришлось прогоном. На Python 3.14.3 команда pip install aider-chat про версию не ругается: pip молча берёт aider_chat-0.16.0 от 29 октября 2023 года, потому что версии от 0.16.1 до 0.86.2 закрыты ограничением Requires-Python. До конца установка при этом не доходит — спотыкается на древней зависимости этого релиза, numpy==1.24.3:

$ venv314/Scripts/python.exe -m pip install aider-chat
Collecting aider-chat
  Using cached aider_chat-0.16.0-py3-none-any.whl.metadata (11 kB)
...
Collecting numpy==1.24.3 (from aider-chat)
  Using cached numpy-1.24.3.tar.gz (10.9 MB)
...
ERROR: Exception:
Traceback (most recent call last):
...
pip._vendor.pyproject_hooks._impl.BackendUnavailable: Cannot import 'setuptools.build_meta'

Откуда взялась 0.16.0, объясняет просьба поставить конкретную версию:

$ python -m pip install --dry-run "aider-chat==0.86.2"
ERROR: Could not find a version that satisfies the requirement aider-chat==0.86.2
       (from versions: 0.13.0, 0.14.0, 0.14.1, 0.14.2, 0.15.0, 0.16.0)
ERROR: No matching distribution found for aider-chat==0.86.2

Вместо понятного «версия Python не поддерживается» человек получает падение внутри чужого пакета.

Мини-вывод: перед установкой Aider проверьте python -V — рабочий коридор это 3.10, 3.11 и 3.12.

Наш прогон установки Aider: версия, зависимости, вес

Aider мы поставили в чистое окружение на Python 3.11.9 под Windows.

$ venv/Scripts/python.exe -m pip install aider-chat
Successfully installed aider-chat-0.86.2 aiohappyeyeballs-2.6.1 aiohttp-3.13.3
  ... ещё 103 пакета ... wcwidth-0.6.0 yarl-1.22.0 zipp-3.23.0

$ venv/Scripts/aider.exe --version
aider 0.86.2

Три числа из прогона, которых нет в документации. Вместе с агентом приезжает 108 зависимостей — среди них litellm, tiktoken, tree-sitter-language-pack и numpy. Готовое окружение занимает 624 МБ. Ставится сборка от 12 февраля 2026 года: тогда версия 0.86.2 попала на PyPI, предыдущая 0.86.1 лежит там с 13 августа 2025 года.

Мини-вывод: рабочая установка Aider — 109 пакетов и 624 МБ.

Какие модели подключаются к Aider и как они называются

Страница подключения моделей Aider в сентябре 2026 года рекомендует Gemini 2.5 Pro, DeepSeek R1 и V3, Claude 3.7 Sonnet, OpenAI o3, o4-mini и GPT-4.1. Список отстал от кода: короткие имена зашиты в пакет, и мы распечатали их из установленного aider 0.86.2.

Всего в словаре MODEL_ALIASES двадцать коротких имён. Ключ передаётся при запуске: aider --model sonnet --api-key anthropic=<key>. Локальные модели подключаются через Ollama или любой OpenAI-совместимый эндпоинт, бесплатный доступ к части облачных — через OpenRouter с суточным ограничением. Про локальный запуск консольного агента есть отдельный разбор: Claude Code локально.

Мини-вывод: словарь алиасов в пакете Aider свежее списка моделей на сайте.

Сколько токенов съедает Aider на пустой запрос

Расход токенов Aider показывает встроенной командой /tokens: она разбирает контекст по строкам и оценивает цену. Ни одна из двадцати страниц топ-10 Яндекса по запросам кластера её не упоминает, поэтому стартовую таксу мы сняли сами: пустой git-репозиторий с одним файлом и /tokens до всякой работы.

Approximate context window usage for gpt-4o, in tokens:

$ 0.0051    2,024 system messages
$ 0.0002       75 repository map  use --map-tokens to resize
==================
$ 0.0052    2,099 tokens total
          125,901 tokens remaining in context window
          128,000 tokens max context window size

Две тысячи токенов инструкций едут к модели раньше вашей первой буквы. Замер на том же репозитории с выключенной картой (--map-tokens 0):

Один и тот же пустой запрос стоит в двадцать раз дороже на claude-opus-4-6, чем на deepseek-chat. Вторая ручка — формат правки. Замер на gpt-4o с выключенной картой: ask 116 токенов, whole 547, udiff 874, diff 2 024, diff-fenced 2 025. Между ask и diff разница в семнадцать раз, и она умножается на каждое сообщение сессии.

Долларовые суммы посчитал сам Aider по встроенной таблице цен litellm: во всех прогонах стоял заведомо неверный ключ, платных обращений к API не было. Вендор в разделе про лимиты предупреждает: «Aider never enforces token limits, it only reports token limit errors from the API provider. The token counts that aider reports are estimates».

Мини-вывод: стартовая такса сессии Aider — около двух тысяч токенов, режим ask режет её в семнадцать раз.

Как работает автокоммит Aider в git и как его выключить

Автокоммит несёт в Aider основную нагрузку. Документация вендора описывает поведение так: «Whenever aider edits a file, it commits those changes with a descriptive commit message». Текст сообщения генерирует вспомогательная модель, которой Aider отправляет диффы и историю чата, формат следует соглашению Conventional Commits. Ваши несохранённые правки Aider сначала фиксирует отдельным коммитом, чтобы чужая работа не смешалась с его собственной.

Свои коммиты Aider помечает: к имени автора и коммиттера дописывается «(aider)», снимают подпись ключи --no-attribute-author и --no-attribute-committer, а --attribute-co-authored-by заменяет её трейлером Co-authored-by. Деталь для команд с хуками: Aider коммитит с флагом --no-verify, то есть pre-commit хуки пропускает; вернёт их ключ --git-commit-verify.

Выключается автокоммит тремя ключами. --no-auto-commits оставляет правки без коммитов. --no-dirty-commits запрещает фиксировать чужие несохранённые изменения перед правкой. --no-git отключает git целиком, и вендор предупреждает, что тогда бэкапы на вас. Внутри чата работают команды /undo, /diff, /commit и /git.

Мини-вывод: git в Aider работает как система отмены через /undo.

Карта репозитория Aider: зачем она и для скольких языков работает

Карта репозитория — выжимка проекта, которую Aider отправляет модели с каждым запросом: файлы и ключевые символы в них, с сигнатурами классов и функций. Строит её графовое ранжирование, где узлы — файлы, а рёбра — зависимости.

Размер ограничен ключом --map-tokens, по умолчанию 1000 токенов. На практике бюджет плавает: наш прогон в репозитории из одного файла напечатал «Repo-map: using 4096 tokens, auto refresh», потому что в чат не добавлено ни одного файла и карта расширяется под весь проект. Как только файл попадает в чат командой /add, карта уходит: в замере с добавленным файлом строка repository map пропала, вместо неё встала строка файла на 33 токена.

Языков в таблице поддержки Aider 204 строки и 150 уникальных названий. Линтер отмечен у всех 204 строк, карта репозитория строится только для 39 языков: python, javascript, typescript, go, rust, java, cpp, csharp, php, swift, ruby и ещё 28. Для остальных Aider работает без карты, опираясь на добавленные руками файлы.

Мини-вывод: карта репозитория Aider покрывает 39 языков из 150.

Есть ли у Aider графический интерфейс: браузер и AiderDesk

Графических поверхностей у Aider две, и обе ставятся отдельно. Первая — встроенный браузерный режим, который вендор называет экспериментальным и запускает ключом --browser. Обычный pip install aider-chat его не привозит: в нашем окружении с версией aider 0.86.2 запуск aider --browser напечатал «You need to install the aider browser feature» и предложил доустановить экстру aider-chat[browser].

Вторая поверхность — AiderDesk, десктопное приложение из запроса «aider desktop». Это отдельный open-source проект компании hotovo, репозиторий hotovo/aider-desk: TypeScript, Electron, лицензия Apache-2.0, 1 422 звезды. Он оборачивает aider в окно и добавляет режим агента с подтверждением инструментов, изолированные git-worktree и просмотр диффов. Темп у AiderDesk свой: релиз v0.82.0 вышел 7 сентября 2026 года, репозиторий обновлялся 10 сентября.

Мини-вывод: терминал у Aider основной, браузер ставится экстрой aider-chat[browser], десктоп делает hotovo.

Aider на GitHub: лицензия, звёзды и темп проекта

Репозиторий Aider на GitHub — Aider-AI/aider, лицензия Apache-2.0, создан 9 мая 2023 года. Ответ GitHub API 10 сентября 2026 года: 48 868 звёзд, 4 943 форка, 1 859 открытых issue. Последняя запись в репозиторий датирована 22 мая 2026 года, последний оформленный релиз — v0.86.0 от 9 августа 2025 года.

Даты стоит сложить вместе. Последний тег в репозитории — v0.86.0 от августа 2025 года, а на PyPI лежит более свежая 0.86.2 от февраля 2026 года: релизные заметки за пакетом не поспевают. Верхний блок истории озаглавлен «main branch» и перечисляет поддержку Claude 4.5 и 4.6, моделей Gemini 3, семейства GPT-5, команду /ok и строку «Aider wrote 62% of the code in this release» — часть этого уже стоит в пакете 0.86.2, что видно по словарю алиасов выше.

Мини-вывод: темп релизов Aider в 2026 году низкий — версию проверяйте на PyPI.

Насколько Aider агент: режимы, скрипты и телеметрия

Агентность у Aider ограниченная и предсказуемая. Он сам строит карту репозитория, применяет правки и коммитит, но файлы в контекст берёт по вашему указанию: /add добавляет файл, /read-only — справку без права правки, /drop убирает.

Режимов чата четыре: code правит файлы, ask отвечает без правок, architect работает двумя моделями (одна предлагает план, вторая переводит его в правки), help отвечает про сам Aider. Переключают их слэш-команды или ключ --chat-mode, для архитектора есть ярлык --architect. Рекомендованный вендором цикл — обсудить в ask, затем коротко скомандовать в code. Сравнение терминала с редактором — в тексте про Claude Code и Cursor.

Из скрипта Aider запускается одним сообщением: aider --message "add docstrings" file.py выполняет задачу и выходит. Для автоматизации есть --yes, --dry-run и --commit.

Телеметрия собирается по согласию: аналитика включается только с opt-in и «never collects your code, chat messages, keys or personal info», уходят имена моделей, объёмы токенов, форматы правки и ошибки. Согласиться предлагают случайной части пользователей, выключает сбор команда aider --analytics-disable.

Мини-вывод: Aider — агент под присмотром: контекст набираете вы.

Чек-лист перед установкой Aider

• Проверьте python -V: рабочие версии для Aider 0.86.2 — 3.10, 3.11 и 3.12, на 3.14 pip уйдёт в сборку 0.16.0 и упадёт.
• Ставьте в отдельное окружение или через aider-install: 109 пакетов и 624 МБ в системный Python не нужны.
• Сверьте версию сразу после установки командой aider --version.
• Заложите около 2 000 токенов стартовой таксы на сообщение, снижайте её режимом ask и следите за /tokens.
• Решите заранее судьбу автокоммита: --no-auto-commits оставит правки без коммитов, /undo откатит последнюю.
• Если в репозитории настроены pre-commit хуки, добавьте --git-commit-verify.
• Нужен оконный интерфейс — ставьте aider-chat[browser] или отдельный AiderDesk от hotovo.
• Не хотите отдавать статистику — выполните aider --analytics-disable.