Вайб-кодинг в Aider: настройка через RouterAI (Claude, GPT-6, DeepSeek) и статус проекта

Aider

Aider (Aider-AI/aider) — «AI pair programming in your terminal»: консольный помощник, который правит файлы вашего проекта по запросу на естественном языке и каждую правку фиксирует отдельным git-коммитом. Он строит карту репозитория (repo map), поэтому модель видит структуру проекта, а не только добавленные в чат файлы. Любую правку можно откатить командой /undo.

Aider работает с любым OpenAI-совместимым API, поэтому RouterAI подключается двумя переменными окружения. В одном инструменте вы получаете Claude, GPT, DeepSeek и GLM из каталога моделей, работу из России без VPN и оплату в рублях.

Статус проекта: перед установкой

Aider развивается очень медленно. По данным GitHub API и PyPI на 26 октября 2026 года:

• последний коммит в main — 22 мая 2026 года (добавление новых названий моделей Anthropic);
• последний релиз на GitHub — v0.86.0 от 9 августа 2025 года; на PyPI актуальна версия 0.86.2;
• открыто более 500 pull request'ов и около 1,4 тыс. issues; у репозитория около 50 тысяч звёзд;
• репозиторий не архивирован, и публичного заявления о паузе от мейнтейнеров мы не нашли.

Это не значит, что инструмент сломан: установленная версия работает, и мы проверили её с RouterAI (ниже). Но встроенный список моделей остановился на мае 2026 года: для новых моделей, например claude-sonnet-5.5, Aider не знает размер контекста и цену и выбирает формат правок по умолчанию (в нашей проверке — whole). Поэтому зафиксируйте версию (aider-chat==0.86.2), не ждите исправлений и посмотрите альтернативы, если нужен активно развиваемый проект.

Требования

• macOS, Linux или Windows; рабочая папка под git (если репозитория нет, Aider предложит его создать)
• Python 3.10–3.12: в метаданных aider-chat на PyPI указано <3.13,>=3.10, на Python 3.13 и новее прямая установка через pip не работает
• API-ключ из личного кабинета

Установка

Рекомендуемый способ из документации — пакет aider-install. Он ставит Aider в отдельное окружение и при необходимости скачивает собственный Python 3.12, так что системная версия Python не мешает:

python -m pip install aider-install
aider-install

Альтернативы: один скрипт (curl -LsSf https://aider.chat/install.sh | sh для macOS и Linux) или pipx install aider-chat на Python 3.12. Чтобы закрепить версию, укажите её явно:

pipx install aider-chat==0.86.2

Проверьте установку:

aider --version

Подключение к RouterAI

Для OpenAI-совместимого эндпоинта Aider читает переменные OPENAI_API_BASE и OPENAI_API_KEY (документация).

1. Экспортируйте адрес RouterAI и ключ (macOS и Linux):

export OPENAI_API_BASE=https://routerai.ru/api/v1
export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

В Windows используйте setx OPENAI_API_BASE https://routerai.ru/api/v1 и setx OPENAI_API_KEY ..., затем перезапустите терминал.

1. Перейдите в проект и запустите Aider, добавив к id модели префикс openai/:

cd /path/to/your/project
aider --model openai/anthropic/claude-sonnet-5.5

Префикс openai/ обязателен: он говорит Aider, что модель доступна через OpenAI-совместимый API по адресу из OPENAI_API_BASE. Остальная часть — это id модели из каталога RouterAI как есть, поэтому получается openai/anthropic/claude-sonnet-5.5. Без префикса Aider не поймёт, куда слать запрос, и отправит его в сам OpenAI.

На незнакомых Aider моделях он выводит предупреждение «Unknown context window size and costs, using sane defaults» и подсказывает похожие названия — это нормально. Чтобы убрать его, добавьте --no-show-model-warnings.

Через .aider.conf.yml

Чтобы не экспортировать переменные каждый раз, положите в корень репозитория или в домашнюю папку файл .aider.conf.yml (документация). Aider читает его из домашней папки, корня git-репозитория и текущей папки; файлы, загруженные позже, перекрывают предыдущие:

model: openai/anthropic/claude-sonnet-5.5
openai-api-base: https://routerai.ru/api/v1
openai-api-key: sk-xxxxxxxxxxxxxxxx

Через .env

Ключи удобнее хранить в .env (документация) — Aider ищет его в тех же трёх местах:

OPENAI_API_BASE=https://routerai.ru/api/v1
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
AIDER_MODEL=openai/anthropic/claude-sonnet-5.5

Aider сам добавляет в .gitignore только файлы .aider*. Ключ в .env или .aider.conf.yml внутри репозитория не должен попасть в git: добавьте .env в .gitignore вручную или храните файлы в домашней папке.

Режимы и git

Aider запускается в режиме code: он меняет файлы и коммитит правки. Режим ask только обсуждает код и ничего не меняет, architect делит работу между двумя моделями (документация по режимам). Переключаться можно командами /ask, /code, /architect или /chat-mode <режим>. Рекомендуемый порядок работы — сначала обсудить задачу в /ask, потом перейти в /code.

В режиме architect одна модель предлагает решение, другая превращает его в правки файлов. С RouterAI это удобно: сильная модель думает, дешёвая пишет код:

aider --architect \
  --model openai/anthropic/claude-sonnet-5.5 \
  --editor-model openai/deepseek/deepseek-v4.1-flash-1017

Для служебных задач (сообщения коммитов, сжатие истории) можно задать --weak-model, например openai/anthropic/claude-haiku-5.5.

Про git (документация): каждая правка файла сразу коммитится с описательным сообщением, а если в файле уже были ваши незакоммиченные изменения, Aider сначала фиксирует их отдельным коммитом. Команды /diff (что изменилось), /undo (откатить последнюю правку) и /commit работают прямо в чате; --no-auto-commits отключает автокоммиты.

Выбор модели

Идентификаторы проверены по каталогу RouterAI на момент написания; цены и актуальный список смотрите в каталоге. Во всех примерах перед id нужен префикс openai/.

Проверка подключения

Проще всего дать Aider короткое задание без интерактива:

aider --model openai/anthropic/claude-sonnet-5.5 --message "Добавь в invoices.js функцию overdueInvoices" invoices.js

В ответе будут diff, строка Tokens: … sent, … received и коммит Commit …. Если всё так, подключение работает; проверьте и git log. В интерактивном режиме aider без --message ждёт ваших запросов, выход — /exit.

Решение проблем

Запрос уходит в OpenAI, ошибка «Country, region, or territory not supported»

Aider не увидел OPENAI_API_BASE и отправил запрос в сам OpenAI. Проверьте, что переменная экспортирована в том же терминале, где запущен aider (echo $OPENAI_API_BASE), а в Windows после setx перезапущен терминал. Аналогичная картина — если забыли префикс openai/ у модели.

401 Unauthorized

Ключ не передан или неверный. Проверьте OPENAI_API_KEY (echo $OPENAI_API_KEY) и то, что ключ скопирован из личного кабинета целиком. Проверьте также, нет ли в проекте .env или .aider.conf.yml со старым ключом: файлы из текущей папки перекрывают домашние.

Модель не найдена

Проверьте, что id есть в каталоге и совпадает точно, а перед ним стоит openai/: openai/anthropic/claude-sonnet-5.5, а не anthropic/claude-sonnet-5.5.

402 Payment Required

Недостаточно средств на балансе — пополните его в разделе Биллинг.

Установка не проходит на Python 3.13+

Используйте aider-install (он ставит собственный Python 3.12) либо pipx install aider-chat --python python3.12.

Альтернативы

Если вам нужен активно развиваемый инструмент, а не замороженная версия, посмотрите:

• Crush — терминальный агент Charm с TUI, LSP и MCP;
• CodeCompanion — плагин для Neovim, подключается к OpenAI-совместимым API;
• Forge — терминальный coding-агент с открытым кодом;
• cecli — форк Aider, который продолжает разработку (по данным обзора AICoderScope).

Что дальше

• Каталог моделей — подберите модель под задачу
• Аутентификация — управление API-ключами
• Вайб-кодинг в Crush, Вайб-кодинг в Codex и Вайб-кодинг в Pi — другие CLI-агенты через RouterAI
• Документация Aider — полный список опций и команд