Как установить и использовать Aider: pip/uv, ключ, первая правка

Установить Aider через pip или uv, подключить API-ключ, затем сделать первую правку в настоящем Git-репозитории.

Нужен агент парного программирования, который читает локальный Git-репозиторий, предлагает diff и правит файлы — не выходя из терминала.

Этот разбор — как установить и использовать Aider: поставить aider-chat через pip, pipx или uv, подключить API-ключ и сделать первую правку в настоящем репозитории. Шаги по aider.chat/docs/install.html и aider.chat/docs/usage.html.

Кому это подходит

Aider работает с локальным Git-репозиторием: смотрит файлы, предлагает патчи, пишет после подтверждения, может коммитить. Это не веб-чат, расширение IDE не обязательно. Папка уже должна быть Git-проектом.

Установка, ключ, первая правка

1. 1

   Установить aider-chat

   Имя на PyPI — aider-chat, не голый пакет aider. Типично: python3 -m pip install aider-chat. Изолированно: pipx install aider-chat или uv tool install --python python3.12 aider-chat. Проверка: aider --help.

2. 2

   Подключить API-ключ

   В оболочке export OPENAI_API_KEY=… или export ANTHROPIC_API_KEY=…. Для повторных сессий те же имена в корневой .env и gitignore. aider --list-models показывает распознанных провайдеров. ID моделей: aider.chat/docs/llms.html.

3. 3

   Первая правка в репозитории

   Зайдите в репозиторий и запустите aider README.md. Попросите одну сфокусированную правку, например строку в README. Прочитайте diff, затем примите. Автокоммит отключайте по официальному Usage — не доставайте ключ из истории потом.

python3 -m pip install aider-chat
# pipx install aider-chat
# uv tool install --python python3.12 aider-chat

export OPENAI_API_KEY=sk-...
# export ANTHROPIC_API_KEY=sk-ant-...

cd ~/code/your-repo
aider README.md
# Add a one-line note to the README that this repo uses Aider for local edits

Что обычно ломает первый запуск

Сначала нужен Git

Aider опирается на Git для контекста и коммитов. В пустой папке: git init и хотя бы один коммит до первой сессии. Не проверяйте неверсионированный каталог.

.env как пароль

Не коммитьте и не вставляйте в тикеты. Если файл уже на удалённом, смените ключ в консоли поставщика — стереть сообщение коммита недостаточно.

Автокоммит уносит грязное дерево

Перед принятием смотрите область индекса. Ключи, локальные перекрытия и крупные артефакты уже должны быть в ignore. Ручные коммиты: отключите auto-commit по документации.

Официальное напоминание: вызовы API тарифицируются поставщиком. Сначала дешёвая модель с коротким контекстом, чтобы выучить цикл, затем та, за которую вы реально хотите платить.

Когда diff нужно обсудить

После правок агента часто не хватает одной схемы: что изменилось и почему можно сливать. Отдельный переговорный пакет не нужен. Откройте короткое пространство на tidemeet или смотрите как создать пространство. Холст: основы общей доски. Другой терминальный агент на этом сайте: Codex CLI.

Вопросы