Roo Code (VS Code)
Инструкция по настройке популярного расширения Roo Code для VS Code. Гибкая настройка ролей (Code, Architect, Ask), поддержка протокола MCP и визуализация разницы в коде перед сохранением.
Расширение Roo Code для VS Code развивает идеи автономного кодинга, предоставляя специализированные режимы работы (Code, Architect, Ask) и нативную интеграцию с инструментами Model Context Protocol (MCP). Визуальный diff-интерфейс позволяет контролировать каждую строчку изменений до сохранения файлов на диск.
1. Подготовка и получение ключа
Перед началом настройки убедитесь, что у вас есть активный аккаунт и действующий ключ авторизации:
- Перейдите в личный кабинет Api Router и пополните рублевый баланс (от 1 ₽).
- В разделе Ключи управления API создайте новый ключ (формат:
sk-or-v1-...). - Скопируйте ключ. Он понадобится для указания в поле
API Keyвашего редактора.
2. Конфигурация в Roo Code
Откройте панель настроек редактора по пути: Настройки Roo Code → Provider: OpenAI Compatible. Укажите следующие параметры подключения:
| Параметр настройки | Значение для Api Router | Описание |
|---|---|---|
| Base URL / Endpoint | https://api-router.velar.plus/v1 | Единая точка входа для всех запросов |
| API Key | sk-or-v1-ваш-ключ | Ваш секретный токен из кабинета |
| Provider Type | OpenAI Compatible | Стандартный протокол эмуляции |
3. Рекомендуемые модели для работы с кодом
В Roo Code вы можете вручную указать идентификаторы моделей, оптимизированных для архитектурных рассуждений, поиска багов и автодополнения. Ознакомиться с полным списком и ценами за токен можно в разделе Модели нейросетей:
anthropic/claude-sonnetopenai/gpt-minigoogle/gemini-flash
4. Основные сценарии и горячие клавиши
После сохранения настроек шлюз мгновенно начинает маршрутизировать запросы на генерацию кода:
| Комбинация клавиш | Функциональное действие |
|---|---|
| Режим Architect | Построение плана работ и проверка архитектурных ограничений перед правками |
| Режим Code | Непосредственная реализация логики и исправление обнаруженных ошибок |
| Режим Ask | Консультации по кодовой базе в формате вопрос-ответ без модификации файлов |
5. Проверка подключения и диагностика
Если редактор сообщает об ошибке соединения, проверьте следующие моменты:
- Проверка баланса: Убедитесь в личном кабинете или через GET /v1/credits, что на балансе есть средства.
- Формат Base URL: Убедитесь, что в конце адреса указан путь
/v1без лишнего слеша в конце:https://api-router.velar.plus/v1. - Резервирование: Для критических задач настройте резервные модели, чтобы избежать прерывания сессии при временной недоступности апстрима.
- Лимиты ключа: Проверьте, не исчерпан ли лимит расходов в настройках ключа (контроль расходов).
Связанные разделы документации
Рекомендуем также изучить смежные технические руководства и спецификации: