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 в каталоге инструментов.

Быстрый старт

  1. Провайдер

    Откройте панель 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.

  2. Параметры модели

    Лимиты сторонних моделей 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.

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 наследуют профиль родителя.

РежимМодель
Architectclaude-opus-5.5, gpt-6.1-sol
Codeclaude-sonnet-5.5, kimi-k2.7-code
Askdeepseek-v4.1-flash, gpt-6-luna
Debugclaude-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 сжимает историю слишком рано.

Смотрите также