Aider через AI Gateway — настройка окружения
Парный кодинг-агент в терминале: правит файлы и делает коммиты по git
Aider — терминальный агент для парного программирования: правит файлы прямо в репозитории, сам делает git-коммиты и держит контекст проекта. Aider умеет ходить в OpenAI-совместимые эндпоинты, поэтому через AI Gateway достаточно двух переменных окружения — а модель вы указываете при запуске кодом из каталога. Работает по обычному интернету, без VPN и валютной карты.
Установка
python -m pip install aider-install && aider-installПодключение к AI Gateway
- Создайте API-ключ
В кабинете AI Gateway создайте ключ — формат
sk-aigate-…. Отдельный ключ на проект упрощает контроль расхода. - Задайте переменные окружения
Добавьте в
~/.bashrc/~/.zshrcадрес шлюза и ключ. Aider читает их как OpenAI-совместимый эндпоинт:export OPENAI_API_BASE="https://ai-gatewey.ru/v1" export OPENAI_API_KEY="sk-aigate-ваш_ключ" - Запустите с нужной моделью
Укажите модель с префиксом
openai/— он говорит Aider использовать OpenAI-совместимый эндпоинт (то есть AI Gateway), а дальше идёт код модели из каталога:aider --model openai/anthropic/claude-sonnet-5 - Проверьте подключение
Aider откроет сессию в каталоге репозитория. Отправьте первый запрос — если агент правит файлы и отвечает, расход уже виден в кабинете AI Gateway в реальном времени.
openai/ перед кодом модели обязателен — он переключает Aider на OpenAI-совместимый маршрут. Итоговое имя выглядит как openai/<код-каталога>, например openai/openai/gpt-5.3-codex для GPT.Какие модели выбрать
Aider хорошо работает с сильными кодинг-моделями. Для повседневной работы берите модели среднего класса, для сложных правок — флагманы, а deepseek-chat заметно экономит на объёмных задачах:
| Модель | Ввод, ₽/1М | Вывод, ₽/1М | Контекст |
|---|---|---|---|
| Anthropic: Claude Sonnet 5 | 314 | 1 568 | 1M |
| OpenAI: GPT-5.3-Codex | 274 | 2 195 | 400K |
| DeepSeek: DeepSeek V3 | 31 | 125 | 128K |
Частые вопросы
Почему в --model префикс openai/ стоит дважды?
Первый openai/ — это указание Aider использовать OpenAI-совместимый маршрут (AI Gateway), а дальше идёт полный код каталога, у которого свой префикс провайдера. Для GPT это openai/openai/gpt-5.3-codex, для Claude — openai/anthropic/claude-sonnet-5.
Aider пишет об ошибке авторизации — что проверить?
Проверьте, что OPENAI_API_BASE указан с /v1 на конце, ключ действителен (кабинет → Ключи), а в окружении не осталось OPENAI_API_KEY от прямой подписки OpenAI.
Как контролировать расход агента?
Задайте ключу месячную квоту и лимит RPM в кабинете AI Gateway — при превышении запросы остановятся, а не спишут лишнее.
Aider с оплатой в рублях — ключ после регистрации
Получить ключ