Настройка Aider
Подключите Aider к GonkaGate в локальном репозитории.
Подключите Aider к GonkaGate, экспортировав OPENAI_API_KEY, указав base URL GonkaGate и модель в формате openai/<model-id>.
Сначала запустите одну сессию или сохраните те же значения в .aider.conf.yml, затем проверьте подключение перед реальными правками.
Запустите одну сессию Aider
Экспортируйте ключ GonkaGate через OPENAI_API_KEY, затем запустите Aider с base URL GonkaGate и значением модели в формате openai/<model-id>.
export OPENAI_API_KEY="gp-your-api-key"
cd /path/to/your/repo
aider \
--openai-api-base https://api.gonkagate.com/v1 \
--model openai/qwen/qwen3-235b-a22b-instruct-2507-fp8Замените пример модели на актуальный ID из GET /v1/models.
Перед началом
- Aider уже установлен.
- Вы работаете в локальной директории проекта или git-репозитории.
- У вас уже есть API-ключ GonkaGate в формате
gp-.... - Вам нужен узкий путь настройки именно для Aider, а не более широкий гайд по миграции или SDK.
Сохраните настройку в репозитории
Используйте конфиг в репозитории, если один и тот же проект должен всегда запускать Aider через GonkaGate.
Создайте .aider.conf.yml в корне репозитория:
model: openai/qwen/qwen3-235b-a22b-instruct-2507-fp8
openai-api-base: https://api.gonkagate.com/v1Затем запускайте Aider из этого репозитория:
export OPENAI_API_KEY="gp-your-api-key"
cd /path/to/your/repo
aiderAider может читать конфиг из текущей директории, из корня репозитория или из домашней директории. Для GonkaGate лучше использовать repo-local конфиг, если эти настройки нужны только одному проекту.
Правила именно для Aider
- В имени модели для Aider нужно сохранять префикс
openai/. - Часть после
openai/должна совпадать с актуальным GonkaGate model ID. - Aider читает API-ключ из
OPENAI_API_KEY, поэтому ключ должен быть доступен в том shell, из которого вы запускаете Aider.
Проверка внутри репозитория
Запустите Aider из репозитория, с которым будете работать, и отправьте в чат:
Reply with exactly: Aider connected to GonkaGate
Так вы проверите endpoint, API key и model path до реальных изменений файлов.
Частые первые ошибки
| Если видите | Обычно это значит | Что делать |
|---|---|---|
model not found | Не хватает префикса openai/ или model ID устарел | Сохраните префикс openai/ и проверьте model ID в GET /v1/models |
| Предупреждения про unknown context window или token costs | Aider ещё не знает метаданные этой модели | Endpoint при этом может работать, но модель стоит перепроверить перед реальными правками |
401 invalid_api_key | Ключ отсутствует, неверный или загружен не в тот shell | Перепроверьте OPENAI_API_KEY и страницу Аутентификация и API-ключи |
429 insufficient_quota | На предоплаченном USD-балансе не хватает средств для запроса | Проверьте Pricing перед повторной попыткой |
429 rate_limit_exceeded | Запрос уперся в throttling | Повторяйте запрос с bounded backoff и используйте Обработка rate limits для полной политики |
Официальные источники
Последняя проверка: 13.03.2026 по официальной документации Aider для OpenAI-compatible APIs и конфигурации.
См. также
- Гайды по фреймворкам и инструментам для другого пути через wrapper или coding tool
- Аутентификация и API-ключи для хранения ключей, ротации и проблем с auth
- Выбор моделей для выбора модели до фиксации в Aider
- GET /v1/models — Получить список моделей чтобы проверить точный live model ID для Aider
