Aider: установка и настройка AI coding assistant в терминале

Что такое Aider и зачем он нужен

Aider — это AI-ассистент для программирования, который работает прямо в терминале. Вы даёте ему задачу текстом, он читает ваш код, вносит правки и автоматически создаёт git-коммит. Никаких IDE-расширений, никаких копипастов из ChatGPT — всё внутри файловой системы.

Проект разрабатывает Paul Gauthier (экс-CTO Matterport) под лицензией Apache 2.0. С 2024 года набрал 46 776 звёзд GitHub и 4 658 форков — это одна из крупнейших open-source кодовых баз среди AI coding assistants.

Ключевые возможности:

Автоматическое редактирование файлов — Aider не предлагает изменения, а применяет их. Работает с любыми языками (Python, JavaScript, Go, Rust, TypeScript — tree-sitter для 20+). Взаимодействие через терминал — никакого веб-интерфейса, только `aider <файлы>`. Git-интеграция — каждый раунд правок заканчивается коммитом с осмысленным сообщением. Repo Map — автоматически строит карту зависимостей репозитория, чтобы LLM понимала архитектуру проекта целиком, а не только открытые файлы.

Aider принципиально отличается от веб-инструментов вроде ChatGPT: он оперирует с реальным кодом в вашем репозитории, видит структуру проекта и не теряет контекст между сессиями.

Установка Aider

Самый быстрый способ — однострочный скрипт. Он устанавливает Python 3.12 (если его нет) и Aider в изолированное окружение:

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

Для Windows:

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

После установки Aider будет доступен как команда aider. Проверьте:

aider --version

Установка через pip

Если предпочитаете классическую установку:

python -m pip install aider-chat

Требуется Python 3.8–3.13. Рекомендуется делать это в виртуальном окружении или через pipx:

pipx install aider-chat

Установка через uv тоже работает:

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

Настройка API-ключа

После установки укажите API-ключ от вашей модели LLM. Самый простой способ — через переменные окружения или конфиг-файл ~/.aider.conf.yml:

# .bashrc или .zshrc
export ANTHROPIC_API_KEY=sk-ant-...
# или
export OPENAI_API_KEY=sk-...
# или
export DEEPSEEK_API_KEY=sk-...

Либо передавайте ключ в командной строке (небезопасно для production):

aider --model sonnet --api-key anthropic=sk-ant-...

Для DeepSeek:

aider --model deepseek --api-key deepseek=sk-...

Подключение моделей: Claude, DeepSeek, GPT, Ollama

Aider поддерживает большинство популярных LLM. Выбор модели — ключевое решение: от него зависит качество правок и скорость работы.

Для максимального качества используйте --model sonnet с Claude 3.7 Sonnet — Aider показывает на нём лучшие результаты. Для экономии при простых задачах — DeepSeek даёт 95% качества при 10% цены, что подтверждают независимые бенчмарки open-source AI coding assistants. Для офлайн-работы — Qwen 2.5 Coder через Ollama (потеря качества, но полная приватность).

Подключение Ollama:

# Установите модель
ollama pull qwen2.5-coder:7b

# Запустите Aider с локальной моделью
aider --model ollama/qwen2.5-coder:7b

Aider автоматически определяет API-базу Ollama через переменную OLLAMA_API_BASE (по умолчанию http://localhost:11434).

Режимы чата: Code, Ask, Architect

Aider предлагает три режима работы, и умение переключаться между ними — основа продуктивной работы.

Code — редактирование кода

Режим по умолчанию. Aider получает задачу, анализирует открытые файлы + карту репозитория и вносит изменения. Пример сессии:

$ aider factorial.py

Aider v0.75.0
Models: gpt-4o with diff edit format, weak model gpt-3.5-turbo
Git repo: .git with 258 files
Repo-map: using 1024 tokens

> Сделай программу, которая запрашивает число и выводит его факториал

Aider написал код, применил diff и создал коммит:
"added factorial function with user input"

Режим Code работает в формате diff-edit: LLM генерирует diff, Aider применяет его к файлу. Это безопаснее, чем полная перезапись файла — риск потерять данные минимален.

Ask — вопросы о коде

Режим только для чтения. Aider отвечает на вопросы, но ничего не редактирует. Полезен для исследования чужого кода, поиска багов, ревью архитектуры:

ask> Почему этот запрос выполняется 30 секунд?
ask> Какая архитектура у проекта? Нарисуй диаграмму зависимостей.
ask> Найди потенциальные race conditions в модуле auth.

В режиме Ask можно быстро разобраться в незнакомой кодовой базе — Aider видит весь контекст через Repo Map, но не рискует ничего сломать.

Architect — планирование + исполнение

Двухэтапный режим: сначала сильная модель (например, Claude Opus 4) составляет план изменений, затем более лёгкая модель (DeepSeek или GPT-4o-mini) исполняет план как code-задачи. Подходит для сложных рефакторингов, где нужно подумать перед тем как писать код.

Пример рабочего процесса:

architect> Перепиши систему аутентификации с JWT на session-cookie

[Claude Opus 4 анализирует текущий код, предлагает:
  1. Добавить middleware для cookie-сессий
  2. Обновить API-эндпоинты login/logout
  3. Написать тесты]

[DeepSeek исполняет каждую задачу последовательно, применяя правки]

Чтобы запустить Aider в режиме Architect:

aider --architect
# или
aider --chat-mode architect

Команды /code, /ask и /architect в чате переключают режим для одного сообщения. Команда /chat-mode переключает режим постоянно.

Repo Map и контекст проекта

Repo Map — ключевая технология Aider, отличающая его от простых AI-помощников. При старте сессии Aider сканирует весь репозиторий и строит сжатое представление: файловая структура, иерархия классов, функции, импорты.

Без Repo Map LLM видит только те файлы, которые вы явно передали. Aider же автоматически подтягивает контекст: если вы просите изменить API-эндпоинт, он знает, какие модели данных и middleware с ним связаны. Размер карты настраивается параметром --repo-map (по умолчанию 1024 токенов, можно увеличить до 8192).

На практике это означает, что вы можете редактировать сложный проект с 10 000+ файлов, передав Aider всего 2–3 файла, которые надо изменить. Остальное он найдёт сам.

Repo Map особенно полезен при рефакторинге: LLM видит все места, которые нужно обновить, и не пропускает зависимости.

Лучшие практики и рабочие процессы

За несколько лет использования Aider в индустрии сложился набор приёмов, которые повышают продуктивность.

Ask → Code цикл

Рекомендуемый рабочий процесс, описанный в официальной документации: начинайте с /ask, обсудите задачу и подход, затем переключитесь на /code с короткой командой «go ahead». Предыдущий диалог сохраняется, и Aider точно понимает, что нужно сделать.

Не добавляйте лишние файлы

Aider эффективнее, когда в чате только файлы, которые нужно редактировать. Лишние файлы раздувают контекст, увеличивают стоимость токенов и сбивают LLM с толку. Repo Map обеспечит понимание всего проекта.

Используйте .aider.conf.yml

Создайте конфигурационный файл в корне проекта:

# .aider.conf.yml
model: sonnet
weak-model: deepseek
repo-map: 2048
auto-commits: true
git: true
edit-format: diff
lint: true
test-cmd: pytest

Это избавит от необходимости передавать длинные флаги при каждом запуске.

Архитектор для сложных задач

Для изменений, затрагивающих несколько модулей или слоёв архитектуры, всегда используйте Architect-режим. План, составленный сильной моделью, снижает риск регрессии. В анонсе Architect-режима в сентябре 2024 разработчик Aider Paul Gauthier показал, что архитектор-подход даёт на 30-40% меньше ошибок при рефакторинге.

Держите git-историю чистой

Aider автоматически создаёт коммиты после каждого раунда правок. Если коммиты кажутся слишком частыми — используйте --no-auto-commits и делайте коммиты вручную после серии изменений.

Aider vs другие AI coding инструменты

Aider — не единственный инструмент в своей категории. Сравним его с основными альтернативами.

Claude Code — прямой конкурент от Anthropic с теми же идеями (терминал, git-интеграция, редактирование файлов). Но Claude Code работает только с моделями Claude, требует $100–200/мес за Claude Max, в то время как Aider мультимодельный (DeepSeek, GPT, Ollama) и бесплатный (платите только за токены API). Ещё одно отличие: Aider не поддерживает исполнение терминальных команд — он только редактирует файлы.

Codex CLI от OpenAI — лёгкий Rust-клиент с собственным терминальным бенчмарком Term-Bench (83.4%). Ключевое отличие: Codex CLI выполняет команды в терминале (запускает тесты, устанавливает пакеты), а не только редактирует файлы. Но Codex CLI привязан к моделям OpenAI и стоит $20–200/мес.

Cline — VS Code / JetBrains плагин с 63.8K звёзд. Основная разница: Cline — это IDE-расширение с графическим интерфейсом, Aider — терминальный инструмент. Cline поддерживает MCP-серверы и может выполнять терминальные команды, что даёт ему больше возможностей, но требует установки IDE.

Aider выигрывает простотой: pip install aider-chat — и вы в терминале. Не нужна IDE, не нужен GUI, не нужна подписка. Для команд, привыкших работать в Vim/Neovim/VS Code из терминала, Aider — естественный выбор.

Коротко

Aider — самый простой способ добавить AI-ассистента в терминал. Устанавливается за 30 секунд, работает с любой моделью (Claude, DeepSeek, GPT, локальные Ollama), автоматически создаёт git-коммиты и понимает архитектуру проекта через Repo Map. Главные ограничения: не умеет запускать терминальные команды (только редактирует файлы) и не поддерживает MCP-расширения. Но для ежедневного coding-a — это основной инструмент.

Что ещё важно знать