Roo Code + NeuroAPI: API-ключ, Base URL и модели
Как подключить Roo Code к NeuroAPI и разнести модели по режимам, не переплачивая за простые задачи.
Короткий ответ
Краткий ответ
Настройка Roo Code с NeuroAPI: провайдер OpenAI Compatible, base_url https://neuroapi.host/v1, ключ и Model ID. Режимы клиента, ошибки и ограничения моделей.
OpenAI Compatible
Roo Code подключается к NeuroAPI как OpenAI-совместимый провайдер — без отдельного коннектора.
Режимы — свойство клиента
Code, Architect, Ask и другие режимы Roo Code — это поведение расширения, а не отдельные API-эндпоинты.
Model ID из каталога
Для режимов можно выбрать разные модели: точные имена берутся из карточек /price.
Контроль расходов
Отдельный ключ на Roo Code и тариф Смарт/Оптимальный упрощают контроль стоимости агентных задач.
Подготовьте ключ и модель
Создайте API-ключ в разделе «Токены» личного кабинета NeuroAPI и выберите тариф при создании. Скопируйте ключ: он вводится в настройках Roo Code один раз.
Откройте /price и выберите модель под задачу. Для агентной работы важны поддержка инструментов, размер контекста и стоимость; для архитектурных обсуждений подойдёт более сильная модель, для быстрых правок — более дешёвая.
- Отдельный ключ под Roo Code помогает видеть расходы по клиенту.
- Сверьте поддержку tools и vision в карточке модели.
- Проверьте доступность модели на выбранном тарифе.
Настройте провайдера и модели
В настройках Roo Code выберите API Provider → OpenAI Compatible. Укажите Base URL https://neuroapi.host/v1, вставьте ключ NeuroAPI и добавьте модель: введите точный Model ID из каталога.
Roo Code позволяет назначить отдельные модели под разные режимы. Это удобно, чтобы не тратить самую дорогую модель на простые вопросы: например, отдельная модель для Ask и более сильная для Code/Architect.
- API Provider: OpenAI Compatible
- Base URL: https://neuroapi.host/v1
- API Key: ключ NeuroAPI
- Model ID: точное имя из /price
- При необходимости — отдельные модели на разные режимы клиента.
Проверка и первые задачи
Начните с вопроса в режиме Ask — так проверяются ключ, адрес и модель без изменения файлов. Затем перейдите в Code и дайте небольшую задачу с одним-двумя файлами.
Если модель отвечает, но не предлагает инструменты, скорее всего она не поддерживает function calling в нужном объёме. Проверьте карточку модели и переключитесь на модель с поддержкой инструментов.
- Ask — проверка ключа и модели.
- Code — проверка инструментов и контекста.
- Architect — проверка длинных рассуждений и лимитов.
Ошибки и ограничения
401 — ключ неверен или отозван. 404 — неверный Model ID или модель недоступна на тарифе. 429 — превышены лимиты, повторите позже. Эти правила одинаковы для всех OpenAI-совместимых клиентов.
Режимы Roo Code не гарантируют качество само по себе: результат зависит от выбранной модели, контекста и постановки задачи. Не ожидайте, что режим Architect исправит ограничения модели.
- 401/404/429 — те же причины, что и в других клиентах.
- Не смешивайте ключи разных сервисов в одном профиле.
- Проверяйте лимиты и поведение повторов в документации.
Стоимость, лимиты и безопасность
Roo Code, как и другие агентные клиенты, расходует токены на каждый шаг: чтение файлов, рассуждения, правки. Длинная цепочка действий с большим контекстом стоит заметно дороже одного вопроса, поэтому стоимость зависит не только от модели, но и от постановки задачи.
Для контроля используйте отдельный ключ и лимиты, а сильные модели подключайте только к режимам, где они действительно нужны. Не храните ключ в настройках общей машины без ограничения доступа: при компрометации его нужно сразу отозвать в кабинете.
- Следите за числом шагов и размером контекста.
- Разделяйте ключи для личных и командных задач.
- Проверяйте расход в кабинете и настраивайте лимиты.
- Отзывайте ключ при смене машины или уходе сотрудника.