Что такое Ру-код?
Roo Code — это агент кодирования VS Code с открытым исходным кодом, который может использовать OpenAI-совместимые поставщики, редактировать файлы и запускать утвержденные инструменты.
В этом руководстве по коду Roo добавляется TokenHub через настройки поставщика, совместимого с OpenAI. Сначала протестируйте задачу, доступную только для чтения, затем проверьте вызов собственного инструмента, прежде чем разрешать редактирование файлов или команды терминала. Roo Code может читать файлы, предлагать изменения и запускать инструменты терминала из VS Code, поэтому возможность подключения провайдера и возможности агента необходимо тестировать отдельно. Отключите автоматическое одобрение при первом запуске, используйте одноразовый репозиторий и проверяйте каждое запрошенное действие, пока выбранная модель не окажется надежной с помощью вызовов собственных инструментов.
Roo Code может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/chat/completions.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Roo Code для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
# open the tool, then open its model or provider settingsПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible или Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | gpt-4.1 или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| Provider settings | Roo Code provider settings or configuration profile |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
Если schema принадлежит extension, сначала используйте UI настроек. Он сохранит те же значения на уровне пользователя и не требует угадывать внутренние ключи, которые могут меняться.
Use a model that supports OpenAI tool calling for Code mode tasks.
Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.
Временные переменные только для диагностики
Если schema принадлежит extension, сначала используйте UI настроек. Он сохранит те же значения на уровне пользователя и не требует угадывать внутренние ключи, которые могут меняться.
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы о поставщике API Roo Code
Какого поставщика API мне следует выбрать в Roo Code?
Выберите «Совместимость с OpenAI», затем введите базовый URL-адрес TokenHub, ключ API и точный идентификатор модели.
Что, если чат работает, но вызовы инструментов не работают?
Сначала переключитесь на модель кодирования или агента, которая явно поддерживает вызов собственных инструментов, затем проверьте разрешения Roo Code и режим утверждения.
Как я могу снизить риск во время первого теста Roo Code?
Используйте тестовый репозиторий, начните с объяснения, доступного только для чтения, отключите автоматическое одобрение, а затем постепенно проверяйте изменения и команды терминала.
Как устранить неполадку с кодом Roo 401?
Проверьте ключ API на наличие пропущенных символов или пробелов и убедитесь, что он сохранен в активном профиле. Повторите короткий запрос и проверьте журналы TokenHub.
Как устранить неполадку с кодом Roo 404?
Используйте корень API TokenHub, заканчивающийся на /v1, избегайте дублирования пути /chat/completions и подтвердите существование идентификатора модели.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。
