Roo Code
Подключение Roo Code — AI-агента для VS Code с режимами Architect / Code / Ask / Debug — к Hubris.
Roo Code — расширение для VS Code (форк Cline), которое умеет работать в нескольких режимах: Architect для проектирования, Code для написания и правок, Ask для вопросов, Debug для отладки. Каждому режиму можно назначить свою модель — например, более мощную для Architect и более дешёвую для рутинных правок в Code.
Требования
- VS Code 1.85+
- Аккаунт на hubris.pw и API-ключ
Установка Roo Code
- Откройте панель расширений в VS Code (
Ctrl+Shift+X). - Найдите Roo Code (издатель — RooVeterinaryInc).
- Нажмите Install.
- После установки в боковой панели появится иконка Roo Code.
Подключение к Hubris
- Откройте параметры расширения через иконку шестерёнки в боковой панели Roo Code.
- Перейдите на вкладку Providers.
- В выпадающем меню провайдера выберите OpenAI Compatible.
- Заполните поля:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| API Key | ваш ключ из личного кабинета |
| Model | например anthropic/claude-haiku-4.5 |
- Сохраните настройки (кнопка Save в правом верхнем углу).
Разные модели для разных режимов
Главная фишка Roo Code — разные модели на каждый режим. Это удобно: тяжёлая модель только там, где она реально нужна.
В тех же настройках провайдера у Roo Code есть отдельные слоты для каждого режима. Типовая раскладка:
| Режим | Что делает | Какая модель уместна |
|---|---|---|
| Architect | проектирует архитектуру, разбивает задачу на шаги | мощная — Claude Opus / Sonnet |
| Code | пишет и правит код по чёткому плану | средняя или быстрая — Claude Sonnet, GPT-4o |
| Ask | отвечает на вопросы о коде | быстрая и дешёвая — Haiku, GPT-4o-mini |
| Debug | анализирует логи, ищет причины ошибок | средняя — Claude Sonnet |
Полный актуальный список моделей — в каталоге. В коде режим называется apiModelId, конкретное значение зависит от модели в нашем каталоге.
Что обычно ставят
| ID | Когда уместна |
|---|---|
anthropic/claude-haiku-4.5 | быстрая работа, недорого |
openai/gpt-4o-mini | универсальный недорогой выбор |
google/gemini-2.0-flash | мультимодальные сценарии, быстро |
Для тяжёлых режимов (Architect, сложный Code) подойдёт более крупная Claude или GPT — посмотрите каталог с фильтром по поддержке tool calling.
Решение проблем
Failed to fetch models или 401 при первом подключении
- Перепроверьте ключ: должен начинаться с
sk-gw-, без пробелов. - В Roo Code иногда нужно полностью перезагрузить окно VS Code (
Ctrl+Shift+P→ Developer: Reload Window) после первой настройки.
Модель отвечает «не вижу инструментов» или зацикливается
- Не все модели одинаково хорошо справляются с tool-агентами Roo Code. Попробуйте модель, у которой в каталоге явно указана поддержка tool calling.
- Уменьшите контекст: закройте лишние открытые файлы — Roo передаёт активные вкладки в каждый запрос.
Сессия Architect вдруг очень дорогая
- Architect-режим часто пишет длинные планы — это много
completion_tokens. Используйте модель попроще для Code и Ask, а Architect зовите только когда правда нужен.
Дневной лимит ключа сработал в середине задачи
- В настройках ключа можно увеличить лимит. Альтернатива — заведите отдельный ключ под Roo Code и для каждого проекта.
Что дальше
- Каталог моделей — подобрать модели под каждый из четырёх режимов.
- Управление API-ключами — отдельный ключ под Roo Code с лимитом.
- Расходы — детализация запросов.
- Cline — родитель Roo Code, простой одиночный режим.
Обновлено: