Настройка Roo Code
Подключите Roo Code к GonkaGate.
Подключите Roo Code к GonkaGate через OpenAI-compatible provider и проверьте сетап в два шага: один текстовый ответ и одна read-only задача по workspace.
Заполните настройки провайдера
Откройте настройки Roo Code и укажите:
- API Provider:
OpenAI Compatible - Base URL:
https://api.gonkagate.com/v1 - API Key:
gp-your-api-key - Model ID: используйте модель из GET /v1/models
Если Roo предлагает advanced model configuration, воспринимайте это как Roo-specific tuning. Сначала добейтесь рабочего model ID, а уже потом меняйте опциональные параметры.
Перед началом
- Roo Code уже установлен.
- У вас уже есть API-ключ GonkaGate в формате
gp-.... - Вам нужен узкий путь через провайдера именно для Roo, а не более широкий гайд по миграции или raw SDK.
- Для реальных Roo-сценариев вы отдельно проверите пару модель/провайдер, которая справляется с tool-driven задачами.
Проверьте базовое подключение
Отправьте в Roo Code короткий запрос:
Reply with exactly: Roo Code connected to GonkaGate
Так вы проверите, что base URL, API key и model ID подключены корректно.
Проверьте один read-only workspace task
В реальных coding-сессиях Roo Code использует native tool calling. Перед тем как доверять сетапу для настоящих правок, запустите один read-only prompt, например:
List the files in the current workspace and summarize the repo root without changing anything.
Воспринимайте это как первый canary-check перед реальной coding-сессией, а не как универсальную гарантию для любой модели и любого tool-heavy workflow.
Правила именно для Roo Code
GET /v1/modelsдаёт валидные GonkaGate model IDs, но сам по себе не является контрактом по tool support.- Простой текстовый ответ подтверждает путь подключения, но не доказывает, что tool-driven workflow в Roo уже готов.
- Если Roo нужен для реальных задач по workspace, сначала проверьте модель через живой каталог моделей и гайд по Tool Calling, а уже потом обвиняйте provider setup.
Частые первые ошибки
| Если видите | Обычно это значит | Что делать |
|---|---|---|
401 invalid_api_key | Ключ отсутствует, неверный или вставлен не в тот provider profile | Перепроверьте ключ и страницу Аутентификация и API-ключи |
404 или model not found | Model ID не совпадает с текущей моделью GonkaGate из GET /v1/models | Обновите model ID, прежде чем считать provider setup сломанным |
429 insufficient_quota | На предоплаченном USD-балансе не хватает средств для этого запроса | Проверьте Pricing перед повторной попыткой |
429 rate_limit_exceeded | Запрос уперся в throttling | Повторяйте запрос с bounded backoff и используйте Обработка rate limits для полной политики |
| Текстовые запросы работают, а задачи по workspace ломаются | Путь подключения работает, но выбранная пара модель/провайдер не готова к tool-driven задачам Roo | Проверьте модель по живому каталогу моделей и Вызов инструментов (Function Calling), прежде чем винить provider setup |
Официальные источники
Последняя проверка: 13.03.2026 по официальной документации Roo Code для OpenAI-compatible provider.
См. также
- Гайды по фреймворкам и инструментам для другого пути через фреймворк или инструмент
- Аутентификация и API-ключи для хранения ключей, ротации и проблем с auth
- GET /v1/models — Получить список моделей чтобы проверить точный live model ID для Roo
- Вызов инструментов (Function Calling) чтобы проверить, подходит ли выбранная пара модель/провайдер для Roo workspace tasks
