Roo Code
Агент для VS Code с режимами Code, Architect, Ask, Debug и Orchestrator. Подключается к AITUNNEL через провайдер OpenAI Compatible.
Roo Code — расширение для VS Code, которое читает проект, правит файлы и запускает команды в нескольких режимах. Работает с любым OpenAI-совместимым API.
Понадобятся VS Code (или Cursor, VSCodium) с расширением Roo Code и ключ из панели.
Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Roo Code в каталоге инструментов.
Быстрый старт
Провайдер
Откройте панель Roo Code → шестерёнка → Providers. В поле API Provider выберите OpenAI Compatible и заполните:
- Base URL:
https://api.aitunnel.ru/v1, именно с/v1: Roo сразу добавляет/chat/completions - API Key:
sk-aitunnel-xxx - Model: Roo загрузит список, начните вводить
claude-sonnet-5.5
Ключ хранится в защищённом хранилище секретов VS Code, а не в
settings.json.- Base URL:
Параметры модели
Лимиты сторонних моделей Roo не знает, задайте их в блоке информации о модели:
- Context Window Size — для
claude-sonnet-5.5разумно 200000: полный 1M работает, но каждый шаг агента с огромным контекстом дорогой - Max Output Tokens — 32000 или
-1, чтобы лимит выбирал сервер - Image Support — включите для Claude, GPT, Gemini, Kimi
Enable streaming и Include max output tokens оставьте включёнными, Use Azure — выключенным. Нажмите Save.
- Context Window Size — для
Claude через провайдер Anthropic
С провайдером Anthropic работает родное кэширование промптов, длинные задачи обходятся дешевле:
- API Provider → Anthropic
- Anthropic API Key:
sk-aitunnel-xxx - Use custom base URL:
https://api.aitunnel.ru, без/v1
Профили для режимов
В Configuration Profile кнопкой + заведите профили с разными моделями и выберите нужный под полем ввода чата для каждого режима. Roo запоминает последний профиль режима, подзадачи Orchestrator наследуют профиль родителя.
| Режим | Модель |
|---|---|
| Architect | claude-opus-5.5, gpt-6.1-sol |
| Code | claude-sonnet-5.5, kimi-k2.7-code |
| Ask | deepseek-v4.1-flash, gpt-6-luna |
| Debug | claude-sonnet-5.5 |
Roo работает через нативный tool calling: модели без поддержки инструментов не подойдут.
Устранение неполадок
Ошибка 404
Для OpenAI Compatible Base URL — https://api.aitunnel.ru/v1, с /v1. Для провайдера Anthropic наоборот, без /v1.
Ошибка 400 на моделях с рассуждением
Включите Enable R1 model parameters в профиле. Если ошибка про max_completion_tokens, снимите галочку Include max output tokens.
Агент обрезает ответы или рано сжимает историю
Увеличьте Max Output Tokens и проверьте Context Window Size: если он меньше реального, Roo сжимает историю слишком рано.