Интеграция · AiderAider в России: парное программирование в терминале
Aider работает с любым OpenAI-совместимым API: достаточно задать адрес, ключ и модель с префиксом openai/. Через Polza.ai это Claude, GPT, DeepSeek и ещё 400 моделей — с оплатой картой РФ, без VPN и туннелей.
- Две переменные окружения
- Работает из РФ напрямую
- Карта РФ и СБП
- 400+ моделей одним ключом
$ export OPENAI_API_BASE=https://polza.ai/api/v1
$ export OPENAI_API_KEY=pza_••••••••••••
$ aider --model openai/anthropic/claude-sonnet-5.5
# openai/ — маршрут, в Polza уйдёт anthropic/claude-sonnet-5.5
Что такое Aider
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.ymlopenai-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.
Что умеет 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.
Агент с TUI, который сам ищет файлы и запускает команды. Под него есть отдельная страница.
Агент 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
anthropic/claude-sonnet-5.5
основная модель для правок
Anthropic: Claude Opus 5.5
anthropic/claude-opus-5.5
architect для сложных задач
OpenAI: GPT-6.1 Sol
openai/gpt-6.1-sol
универсальная
MoonshotAI: Kimi K3.1 Pro
moonshotai/kimi-k3.1-pro
работа с кодом
DeepSeek: DeepSeek V4 Pro
deepseek/deepseek-v4-pro
сильная и недорогая
DeepSeek: DeepSeek V4.1 Flash
deepseek/deepseek-v4.1-flash
weak-model для коммитов
Актуальные цены за 1M токенов — в каталоге моделей.
Если 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.
Для команд и юрлиц
Счёт, УПД и НДС
Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.
Ключ на сотрудника
Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.
Контроль бюджета
Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.
Помощь с переездом
Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.
Вопросы и ответы
Что такое 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 подключают теми же двумя переменными.
Другие интеграции
Тот же ключ работает в остальных инструментах: меняется только место, куда вписать Base URL.
Редакторы и агенты в коде
Ставятся в редактор или запускаются в терминале. Читают проект, правят файлы, гоняют тесты.
Cursor
GitHub Copilot
Cline
Roo Code
Kilo Code
Codex CLI
Qwen Code CLI
Gemini CLI
Zed
Polza IDEДесктоп-клиенты
Обычные приложения с окном чата: поставили, вписали ключ и работаете.
Claude Desktop
Cherry Studio
OpenClaw Desktop
Hermes Desktop
Jan
SillyTavernСвой чат для команды
Веб-интерфейс на своём сервере: общий доступ для коллег, история, документы. Рядом с локальными моделями работают облачные через тот же ключ.
Open WebUI
LibreChat
AnythingLLMАвтоматизация и фреймворки
Сценарии, боты и собственные сервисы — там, где модель вызывается из кода или из ноды.
n8n
Dify
LangChainЧто почитать
Кто проверял эту инструкцию
Руководитель техподдержки · редакция Polza.AI
Собрал и проверил подключение Aider на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если инструмент обновится и инструкция разойдётся с реальностью — правим страницу.
Обновлено · Как работает редакция · Нашли неточность? Напишите нам
Подключите Aider за пять минут
Две переменные и префикс openai/ — дальше Aider работает на любых моделях каталога, из России и за рубли.
Остались вопросы? Быстрый старт, поддержка в Telegram или support@polza.ai
Инструкцию проверила редакция Polza.AI, обновлено . Цены и список моделей меняются — актуальные смотрите в каталоге.