# Aider в России: парное программирование в терминале

> Aider работает с любым OpenAI-совместимым API: достаточно задать адрес, ключ и модель с префиксом openai/. Через Polza.ai это Claude, GPT, DeepSeek и ещё 400 моделей — с оплатой картой РФ, без VPN и туннелей.

- Две переменные окружения
- Работает из РФ напрямую
- Карта РФ и СБП
- 400+ моделей одним ключом

Aider — инструмент с открытым исходным кодом для парного программирования с ИИ в терминале. Вы добавляете в чат нужные файлы и описываете задачу словами, Aider вносит правки и сразу коммитит их в git.

Он строит карту репозитория, поэтому модель видит структуру всего проекта, а не только открытые файлы. Есть режим вопросов без правок и режим architect, где решение продумывает одна модель, а правки оформляет другая.

Модели Aider берёт у внешнего провайдера через библиотеку LiteLLM и поддерживает любой OpenAI-совместимый API. Поэтому из России его достаточно направить на адрес Polza.ai — без VPN, туннелей и зарубежной карты.

## Почему Aider не отвечает из России

Сам Aider ставится за минуту. Упирается всё в провайдера, к которому он обращается за моделью.

- **Провайдеры не отвечают.** Штатные API Anthropic и OpenAI не обслуживают российские адреса: Aider запускается, но падает на первом запросе. Решение: Адрес Polza.ai отвечает из РФ напрямую.
- **Картой не оплатить.** Ключи Anthropic, OpenAI и OpenRouter пополняются зарубежной картой, российская на привязке отклоняется. Решение: Карта РФ, СБП или счёт для юрлица.
- **Туннель ради одного API.** Чтобы достучаться до зарубежного API, Aider заворачивают в VPN или туннель — лишняя настройка, которая ломается в неподходящий момент. Решение: Прямое подключение без прокси.
- **Ключ на каждого вендора.** Режим architect удобно собирать из моделей разных вендоров, а это два ключа и два баланса. Решение: Один ключ на весь каталог.
- **Юрлицу не провести оплату.** Оплату зарубежному сервису не примет бухгалтерия, закрывающих документов нет. Решение: Договор, счёт, УПД и НДС.
- **Цена сессии неизвестна.** Стоимость Aider считает только для знакомых ему моделей, для остальных цену сессии он не покажет. Решение: Точный расход по ключам и моделям в кабинете.

## Как подключить Aider к Polza.ai

Нужны Python и проект в git. Вся настройка — две переменные окружения и имя модели.

Что нужно:

- **Python 3.8–3.13.** Для установщика aider-install. Сам Aider при необходимости получит отдельный Python 3.12 — установщик и скрипты ставят его сами.
- **Проект в git.** Aider коммитит каждую правку, поэтому работает в репозитории. Если его нет, Aider предложит создать.
- **Ключ Polza.ai.** Создаётся в кабинете за минуту. Лучше завести отдельный под Aider, чтобы видеть его расход.

### 1. Установите Aider

Рекомендуемый способ из документации — установщик `aider-install`. На macOS и Linux можно поставить одной командой, на Windows есть аналог для PowerShell:

Терминал · установка:

```
$ python -m pip install aider-install
$ aider-install

# или одной командой (macOS, Linux):
$ curl -LsSf https://aider.chat/install.sh | sh
```

### 2. Задайте адрес и ключ

OpenAI-совместимый провайдер Aider берёт из переменных `OPENAI_API_BASE` и `OPENAI_API_KEY`. На Windows задайте их через `setx` и откройте новое окно терминала:

macOS / Linux:

```
$ export OPENAI_API_BASE=https://polza.ai/api/v1
$ export OPENAI_API_KEY=ваш-api-ключ
```

Windows:

```
> setx OPENAI_API_BASE https://polza.ai/api/v1
> setx OPENAI_API_KEY ваш-api-ключ
```

### 3. Запустите с префиксом openai/

Перед ID модели из каталога добавьте `openai/`. По префиксу Aider понимает, что модель нужно запросить у OpenAI-совместимого API по адресу из переменной, а при отправке префикс отрезается: Polza.ai получает `anthropic/claude-sonnet-5.5` — ровно ID из каталога.

Терминал · запуск:

```
$ cd ~/project
$ aider --model openai/anthropic/claude-sonnet-5.5
```

### 4. Сохраните настройки в конфиг

Чтобы не набирать флаги каждый раз, положите `.aider.conf.yml` в корень репозитория или в домашний каталог. Ключ оставьте в переменной окружения, а для коммитов и сводок задайте дешёвую `weak-model`:

.aider.conf.yml:

```
openai-api-base: https://polza.ai/api/v1
model: openai/anthropic/claude-sonnet-5.5
weak-model: openai/deepseek/deepseek-v4.1-flash
```

**Предупреждение о незнакомой модели — это нормально.** На моделях с префиксом `openai/` Aider пишет, что не знает размер контекста и цену модели, и подставляет значения по умолчанию. На работу это не влияет: предупреждение отключается флагом `--no-show-model-warnings`, а параметры модели можно описать в `.aider.model.metadata.json`. Учтите только, что стоимость сессии Aider в этом случае не посчитает — точный расход смотрите в кабинете Polza.ai. [Открыть каталог моделей](https://polza.ai/models)

## Что умеет Aider

Терминальный инструмент для парного программирования: вы говорите, что изменить, он правит файлы и коммитит.

- **Правки в нескольких файлах.** Добавьте файлы в чат командой `/add` и опишите задачу — Aider внесёт согласованные изменения во все сразу.
- **Коммиты в git.** Каждую правку Aider коммитит с осмысленным сообщением, а `/undo` откатывает последнюю.
- **Карта репозитория.** Aider строит карту кода и передаёт модели контекст из всего проекта, а не только из добавленных файлов.
- **Вопросы без правок.** Команда `/ask` отвечает по коду, ничего не меняя. Режим насовсем переключается через `/chat-mode`.
- **Линтеры и тесты.** После правки Aider может прогнать линтер и тесты и сам исправить найденные ошибки.
- **Работа из любого редактора.** С флагом `--watch-files` Aider подхватывает инструкции, которые вы оставляете в комментариях к коду в своём редакторе.

- **Одна модель.** Обычный режим: одна модель и думает, и правит. Claude Sonnet 5.5 или GPT-6.1 Sol справляются с большинством задач.
- **Architect плюс editor.** Сильная модель продумывает решение, вторая оформляет правки: `--architect --model openai/anthropic/claude-opus-5.5 --editor-model openai/anthropic/claude-sonnet-5.5`. Обе идут через один ключ Polza.ai.

## Aider, OpenCode или Claude Code

Три терминальных инструмента для работы с кодом. Разница в том, сколько решений агент принимает сам.

- **Aider.** Парное программирование: вы выбираете файлы, он правит и коммитит. Предсказуемо и прозрачно для истории git.
- **OpenCode.** Агент с TUI, который сам ищет файлы и запускает команды. Под него есть отдельная страница.
- **Claude Code.** Агент Anthropic в терминале, тоже подключается к Polza.ai. Под него есть отдельная страница.

## Напрямую или через Polza

| Из России | Зарубежный провайдер | Aider через Polza.ai |
| --- | --- | --- |
| Оплата | Зарубежная карта, в валюте | Карта РФ, СБП, счёт для юрлиц |
| Доступ к API | Через VPN или туннель | Работает из РФ напрямую |
| Настройка | Ключ и переменные под каждого вендора | Две переменные на всё |
| Выбор моделей | Один вендор | Claude, GPT, DeepSeek и ещё 400 |
| Architect из разных вендоров | Два ключа и два баланса | Один ключ |
| Документы | Нет | Договор, счёт, УПД, НДС |
| Расходы | В кабинете провайдера | Статистика по ключам и моделям |

## Сколько стоит Aider

Aider бесплатный и с открытым кодом. Polza.ai списывает с баланса только токены моделей по ценам каталога, в рублях.

- **Режим architect.** Claude Opus 5.5 продумывает решение, Claude Sonnet 5.5 вносит правки.
- **Ежедневная работа.** Claude Sonnet 5.5, GPT-6.1 Sol и Kimi K3.1 Pro — правки, рефакторинг, тесты.
- **Экономичный режим.** DeepSeek V4 Pro для задач посложнее и DeepSeek V4.1 Flash как weak-model для коммитов и сводок — в разы дешевле.

- [anthropic/claude-sonnet-5.5](https://polza.ai/models/anthropic/claude-sonnet-5.5.md) — основная модель для правок
- [anthropic/claude-opus-5.5](https://polza.ai/models/anthropic/claude-opus-5.5.md) — architect для сложных задач
- [openai/gpt-6.1-sol](https://polza.ai/models/openai/gpt-6.1-sol.md) — универсальная
- [moonshotai/kimi-k3.1-pro](https://polza.ai/models/moonshotai/kimi-k3.1-pro.md) — работа с кодом
- [deepseek/deepseek-v4-pro](https://polza.ai/models/deepseek/deepseek-v4-pro.md) — сильная и недорогая
- [deepseek/deepseek-v4.1-flash](https://polza.ai/models/deepseek/deepseek-v4.1-flash.md) — weak-model для коммитов

## Если Aider не подключился

Четыре причины, на которые приходится почти вся переписка с поддержкой.

- **Ошибка авторизации или 401.** Ключ не дошёл: проверьте `OPENAI_API_KEY` в текущем терминале и баланс. На Windows после `setx` переменные видны только в новом окне.
- **Модель не найдена.** Нет префикса `openai/` или опечатка в ID. Нужно `openai/` плюс ID из каталога целиком: `openai/anthropic/claude-sonnet-5.5`.
- **Запрос уходит не туда.** Не задана `OPENAI_API_BASE` или в ней лишний путь. Нужно ровно https://polza.ai/api/v1 — `/chat/completions` Aider допишет сам.
- **Модель ломает формат правок.** Не все модели строго соблюдают формат правок Aider. Возьмите модель посильнее или задайте формат флагом `--edit-format whole`.

## Частые вопросы

### Что такое Aider?

Инструмент с открытым кодом для парного программирования с ИИ в терминале. Правит файлы проекта по вашим запросам и коммитит каждое изменение в git.

### Как установить Aider?

Командами python -m pip install aider-install и aider-install. На macOS и Linux есть установка одной командой через curl, на Windows — через PowerShell. Для установщика нужен Python 3.8–3.13.

### Зачем префикс openai/ перед ID модели?

По нему Aider через библиотеку LiteLLM понимает, что модель надо запросить у OpenAI-совместимого API по адресу OPENAI_API_BASE. Префикс отрезается до отправки: openai/anthropic/claude-sonnet-5.5 превращается в anthropic/claude-sonnet-5.5, как в каталоге Polza.ai.

### Можно ли без переменных окружения?

Да: флагами --openai-api-base https://polza.ai/api/v1 и --openai-api-key или строками openai-api-base и model в .aider.conf.yml.

### Aider пишет Unknown context window size and costs

Это предупреждение, а не ошибка: модель Aider незнакома, и он берёт значения по умолчанию. Отключается флагом --no-show-model-warnings.

### Нужен ли туннель или VPN, как для OpenRouter?

С Polza.ai нет: API отвечает из России напрямую, а Claude, GPT, Gemini и DeepSeek доступны в каталоге под одним ключом.

### Aider или OpenCode?

Aider — парное программирование: вы сами добавляете файлы в чат, он правит и коммитит каждое изменение. OpenCode — агент, который сам ищет файлы и запускает команды. Оба подключаются к Polza.ai.

### Работает ли Aider с Ollama?

Да, для локальных моделей у Aider есть префикс ollama_chat/. Когда локальной модели не хватает, облачную через Polza.ai подключают теми же двумя переменными.

## Читать дальше

- [API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей](https://polza.ai/blog/api-neyrosetei.md)
- [Российский API нейросетей без VPN](https://polza.ai/blog/rossiyskiy-api-dlya-neyrosetey-bez-vpn-polnyy-gayd-2026.md)
- [Claude Sonnet 5: обзор модели — цены и бенчмарки](https://polza.ai/blog/claude-sonnet-5.md)

## Ссылки

- Быстрый старт: https://polza.ai/docs/glavnoe/quickstart
- Страница: https://polza.ai/integrations/aider
- Обновлено: 2026-11-05