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

## Aider

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

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

## Статус проекта: перед установкой {#status}

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`), не ждите исправлений и посмотрите [альтернативы](#alternativy), если нужен активно развиваемый проект.

## Требования

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

## Установка

Рекомендуемый способ из [документации](https://aider.chat/docs/install.html) — пакет `aider-install`. Он ставит Aider в отдельное окружение и при необходимости скачивает собственный Python 3.12, так что системная версия Python не мешает:

```bash
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. Чтобы закрепить версию, укажите её явно:

```bash
pipx install aider-chat==0.86.2
```

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

```bash
aider --version
```

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

Для OpenAI-совместимого эндпоинта Aider читает переменные `OPENAI_API_BASE` и `OPENAI_API_KEY` ([документация](https://aider.chat/docs/llms/openai-compat.html)).

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

```bash
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 ...`, затем перезапустите терминал.

![Терминал: экспорт OPENAI_API_BASE=https://routerai.ru/api/v1 и OPENAI_API_KEY с ключом-заглушкой, затем aider --version с выводом aider 0.86.2](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/0fa55ac6511d0a6f900d9920a515af77.png)

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

```bash
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` ([документация](https://aider.chat/docs/config/aider_conf.html)). Aider читает его из домашней папки, корня git-репозитория и текущей папки; файлы, загруженные позже, перекрывают предыдущие:

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

### Через .env

Ключи удобнее хранить в `.env` ([документация](https://aider.chat/docs/config/dotenv.html)) — Aider ищет его в тех же трёх местах:

```bash
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` делит работу между двумя моделями ([документация по режимам](https://aider.chat/docs/usage/modes.html)). Переключаться можно командами `/ask`, `/code`, `/architect` или `/chat-mode <режим>`. Рекомендуемый порядок работы — сначала обсудить задачу в `/ask`, потом перейти в `/code`.

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

```bash
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 ([документация](https://aider.chat/docs/git.html)): каждая правка файла сразу коммитится с описательным сообщением, а если в файле уже были ваши незакоммиченные изменения, Aider сначала фиксирует их отдельным коммитом. Команды `/diff` (что изменилось), `/undo` (откатить последнюю правку) и `/commit` работают прямо в чате; `--no-auto-commits` отключает автокоммиты.

![Сессия aider: модель openai/anthropic/claude-sonnet-5.5 через RouterAI, запрос на русском, diff с новой функцией overdueInvoices в invoices.js](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/3a17ebc18b8fd3a933062ad8a80a50dd.png)

![История git после сессии aider: коммит feat: add overdue command to CLI и строка Co-authored-by: aider (openai/anthropic/claude-sonnet-5.5)](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/e5973a205040a3ecc35389a07ec96723.png)

## Выбор модели

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

| Модель | Для чего |
| --- | --- |
| `anthropic/claude-sonnet-5.5` | Основная модель для кода: фичи, отладка, рефакторинг среднего размера |
| `openai/gpt-5.6-sol` | Сложные задачи; альтернатива Claude от OpenAI |
| `deepseek/deepseek-v4.1-flash-1017` | Дешёвые массовые правки и роль editor-модели в `architect` |
| `z-ai/glm-5.3-flash` | Дешёвые быстрые правки |
| `anthropic/claude-haiku-5.5` | `--weak-model`: коммиты и сжатие истории |

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

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

```bash
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`) и то, что ключ скопирован из [личного кабинета](/settings/keys) целиком. Проверьте также, нет ли в проекте `.env` или `.aider.conf.yml` со старым ключом: файлы из текущей папки перекрывают домашние.

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

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

### 402 Payment Required

Недостаточно средств на балансе — пополните его в разделе [Биллинг](/settings/billing).

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

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

## Альтернативы {#alternativy}

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

- [Crush](/pages/vibe-coding-crush) — терминальный агент Charm с TUI, LSP и MCP;
- [CodeCompanion](https://github.com/olimorris/codecompanion.nvim) — плагин для Neovim, подключается к OpenAI-совместимым API;
- [Forge](https://github.com/tailcallhq/forgecode) — терминальный coding-агент с открытым кодом;
- cecli — форк Aider, который продолжает разработку (по данным [обзора AICoderScope](https://aicoderscope.com/blog/aider-2026-stalled-what-happened-alternatives/)).

## Что дальше

- [Каталог моделей](/models) — подберите модель под задачу
- [Аутентификация](/docs/guides/overview/authentication) — управление API-ключами
- [Вайб-кодинг в Crush](/pages/vibe-coding-crush), [Вайб-кодинг в Codex](/pages/vibe-coding-codex) и [Вайб-кодинг в Pi](/pages/vibe-coding-pi) — другие CLI-агенты через RouterAI
- [Документация Aider](https://aider.chat/docs/) — полный список опций и команд