Roo Code
Подключение Roo Code — AI-агента для VS Code с режимами Architect / Code / Ask / Debug — к Hubris.
Roo Code больше не развивается. 15 мая 2026 года авторы перевели репозиторий проекта в режим «только чтение»; последняя версия — 3.54.0, исправлений больше не будет. Сами авторы советуют переходить на Cline или на ZooCode — форк Roo Code от сообщества.
В свежих версиях VS Code Roo Code не работает. В VS Code 1.137 и 1.138 изменилось расположение встроенной утилиты поиска ripgrep, и Roo Code 3.54.0 её не находит: любая задача зависает на строке «API Request...», а в журнале расширения появляется ошибка Could not find ripgrep binary. Для новых установок берите Cline или Kilo Code — оба подключаются к Hubris так же.
Roo Code — расширение для VS Code (форк Cline), которое умеет работать в нескольких режимах: Architect для проектирования, Code для написания и правок, Ask для вопросов, Debug для отладки. Каждому режиму можно назначить свою модель — например, более мощную для Architect и более дешёвую для рутинных правок в Code.
Требования
- VS Code 1.84+ (в 1.137 и 1.138 не работает — см. предупреждение выше)
- Аккаунт на hubris.pw и API-ключ
Установка Roo Code
- Откройте панель расширений в VS Code (
Ctrl+Shift+X). - Найдите Roo Code (издатель — RooVeterinaryInc).
- Нажмите Install.
- После установки в боковой панели появится иконка Roo Code.
Подключение к Hubris
При первом открытии Roo Code показывает экран Welcome to Roo Code! — нажмите Get Started, откроется форма Choose your provider. Если Roo Code уже настроен, те же поля находятся в настройках: шестерёнка в верхней части панели → вкладка Providers.
- В выпадающем списке API Provider выберите OpenAI Compatible (в списке работает поиск).
- Заполните поля:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| API Key | ваш ключ из личного кабинета |
| Model | например anthropic/claude-haiku-4.5 |
Список в поле Model Roo Code загружает у Hubris, когда заполнены адрес и ключ, — начните вводить ID и выберите модель. Если нужного ID в списке нет, выберите пункт Use custom: … с введённым текстом.
- Нажмите Finish (при первом запуске) или Save в правом верхнем углу настроек.
На экране первого запуска форма выровнена по центру, и в невысоком окне её верхняя часть (API Provider, Base URL) может оказаться за краем панели без прокрутки. Тогда щёлкните в поле API Key и перейдите к Base URL клавишами Shift+Tab.
Разные модели для разных режимов
Главная особенность Roo Code — разные модели на каждый режим. Это удобно: тяжёлая модель только там, где она реально нужна. Учтите, что новая задача по умолчанию открывается в режиме Architect — режим переключается в строке под полем ввода.
Делается это через Configuration Profile — именованный набор «провайдер + модель + параметры» в верхней части вкладки Providers. Создайте по профилю на каждую модель Hubris (у всех один Base URL и ключ, разная модель), затем на вкладке Modes откройте нужный режим и в поле API Configuration выберите его профиль. Типовая раскладка:
| Режим | Что делает | Какая модель уместна |
|---|---|---|
| Architect | проектирует архитектуру, разбивает задачу на шаги | мощная — Claude Opus / Sonnet |
| Code | пишет и правит код по чёткому плану | средняя или быстрая — Claude Sonnet, GPT-4o |
| Ask | отвечает на вопросы о коде | быстрая и дешёвая — Haiku, GPT-4o-mini |
| Debug | анализирует логи, ищет причины ошибок | средняя — Claude Sonnet |
Полный актуальный список моделей — в каталоге. Режим без назначенного профиля использует текущий активный.
Что обычно ставят
| ID | Когда уместна |
|---|---|
anthropic/claude-haiku-4.5 | быстрая работа, недорого |
openai/gpt-4o-mini | универсальный недорогой выбор |
google/gemini-3.7-flash | мультимодальные сценарии, быстро |
Для тяжёлых режимов (Architect, сложный Code) подойдёт более крупная Claude или GPT — посмотрите каталог с фильтром по поддержке tool calling.
Решение проблем
Задача висит на «API Request...»
Если строка «API Request...» не меняется минутами, откройте журнал расширений: Ctrl+Shift+P → Developer: Show Logs... → Extension Host. Ошибка Could not find ripgrep binary означает несовместимость Roo Code с вашей версией VS Code (см. предупреждение в начале страницы) — перейдите на Cline или Kilo Code.
«OpenAI completion error: 401 Неверный API-ключ»
- Перепроверьте ключ в поле API Key: он начинается с
sk-gw-, без пробелов по краям. - При неверном ключе список в поле Model остаётся пустым, отдельного сообщения Roo Code не показывает.
«OpenAI completion error: 404 Модель не найдена: …»
- Нужен полный ID с вендором:
openai/gpt-4o-mini, а неgpt-4o-mini. Проще всего выбрать модель из загруженного списка.
«OpenAI completion error: Request timed out.»
- Roo Code не дождался ответа сервера — проверьте соединение и нажмите Retry.
Модель отвечает «не вижу инструментов» или зацикливается
- Не все модели одинаково хорошо справляются с агентными сценариями Roo Code. Попробуйте модель, у которой в каталоге явно указана поддержка tool calling.
- Уменьшите контекст: закройте лишние открытые файлы — Roo передаёт активные вкладки в каждый запрос.
Сессия Architect вдруг очень дорогая
- Architect-режим часто пишет длинные планы — это много
completion_tokens. Используйте модель попроще для Code и Ask, а Architect зовите только когда правда нужен.
Дневной лимит ключа сработал в середине задачи
- В настройках ключа можно увеличить лимит. Альтернатива — заведите отдельный ключ под Roo Code и для каждого проекта.
Что дальше
- Каталог моделей — подобрать модели под каждый из четырёх режимов.
- Управление API-ключами — отдельный ключ под Roo Code с лимитом.
- Расходы — детализация запросов.
- Cline — родитель Roo Code, простой одиночный режим.
Обновлено: