Roo Code — настройка OpenAI Compatible в VS Code
Roo Code — агент для VS Code с режимами Code, Architect, Ask и Debug, подключённый к AITUNNEL
Roo Code — расширение для VS Code, которое превращает редактор в автономного агента: он читает проект, правит файлы, запускает команды и работает в нескольких режимах — Code, Architect, Ask, Debug и Orchestrator. Roo подключается к любому OpenAI-совместимому API, в том числе к AITUNNEL.
> Статус проекта. 15 мая 2026 года команда Roo Code прекратила развитие расширения, репозиторий переведён в архив. Последняя версия 3.54.0 продолжает работать и подключается к AITUNNEL по инструкции ниже, но обновлений больше не будет. Если начинаете с нуля, посмотрите Kilo Code или Cline — оба продолжают развиваться и тоже работают с AITUNNEL.
API-ключ для Roo Code
Roo Code обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.ru и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
Roo хранит ключ в защищённом хранилище секретов VS Code, а не в settings.json, поэтому он не уходит вместе с синхронизацией настроек. Ключ привязан к профилю конфигурации: в каждом профиле его нужно ввести заново, но можно использовать один и тот же.
Тот же ключ подходит для трёх мест в Roo: провайдера OpenAI Compatible, поля Anthropic API Key в режиме Anthropic и индексации кода (эмбеддинги). Учтите, что экспорт настроек сохраняет ключи в открытом виде (см. «Перенос настроек»).
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- VS Code (или Cursor, VSCodium) с установленным расширением Roo Code
- Ключ AITUNNEL
sk-aitunnel-...из личного кабинета - Положительный баланс (от 500₽)
Подключение через OpenAI Compatible
- Откройте панель 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 и выберите из списка
- Нажмите Save.
Дополнительные параметры
Под основными полями есть настройки, которые стоит проверить:
| Параметр | Что поставить |
|---|---|
| Enable streaming | Включено (по умолчанию) |
| Include max output tokens | Включено — AITUNNEL принимает max_completion_tokens |
| Use Azure | Выключено |
| Enable R1 model parameters | Включайте только для моделей с рассуждением, которые падают с ошибкой 400 на системном промпте |
| Enable Reasoning Effort | Для моделей с рассуждением: low — быстрее и дешевле, high — для сложных задач |
Параметры модели
Roo не знает лимиты сторонних моделей, поэтому задайте их вручную в блоке информации о модели:
- Context Window Size — размер контекста. Для
claude-sonnet-5.5разумно поставить 200000: полный 1M токенов работает, но каждый шаг агента с огромным контекстом стоит дорого - Max Output Tokens — 32000, или
-1, чтобы лимит выбирал сервер - Image Support — включите для моделей со зрением (Claude, GPT, Gemini, Kimi), чтобы прикладывать скриншоты
- Input Price / Output Price — необязательно. Если заполнить, Roo будет показывать примерную стоимость задачи. Точный расход в рублях всегда виден в личном кабинете AITUNNEL
Claude через провайдер Anthropic
Для моделей Claude можно использовать провайдер Anthropic с собственным адресом — тогда работает родное кэширование промптов, и длинные задачи обходятся дешевле:
- API Provider → Anthropic
- Anthropic API Key:
sk-aitunnel-xxx - Включите Use custom base URL и укажите
https://api.aitunnel.ru— без/v1, путь/v1/messagesдобавится автоматически - Выберите модель Claude из списка
Профили и модели для режимов
Roo хранит настройки провайдера в профилях. Удобно завести несколько профилей с разными моделями и назначить их режимам:
- Settings → Providers → Configuration Profile → кнопка +
- Создайте, например, три профиля:
- AITUNNEL Sonnet — claude-sonnet-5.5 - AITUNNEL Opus — claude-opus-5.5 - AITUNNEL DeepSeek — deepseek-v4.1-flash
- Переключите режим (Code, Architect, Ask...) и выберите нужный профиль в выпадающем списке под полем ввода чата.
Roo запоминает последний профиль для каждого режима («sticky models»). Типичная схема:
| Режим | Профиль | Почему |
|---|---|---|
| Architect | Opus или gpt-6.1-sol | Планирование требует лучших рассуждений |
| Code | Sonnet или kimi-k2.7-code | Баланс качества и цены |
| Ask | DeepSeek или gpt-6-luna | Вопросы по коду — дешёвая модель справится |
| Debug | Sonnet | Нужна внимательность к деталям |
Подзадачи Orchestrator наследуют профиль родительской задачи.
Индексация кода (семантический поиск)
Roo умеет индексировать проект и искать по смыслу, а не по точному совпадению. Для этого нужны модель эмбеддингов (её даёт AITUNNEL) и векторная база Qdrant.
Шаг 1: запустите Qdrant
docker run -d -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrantШаг 2: настройте индексацию
Нажмите значок базы данных в правом нижнем углу поля ввода чата и заполните:
- Embedder Provider:
OpenAI Compatible - Base URL:
https://api.aitunnel.ru/v1 - API Key:
sk-aitunnel-xxx - Model:
text-embedding-3-small - Embedding Dimension:
1536 - Qdrant URL:
http://localhost:6333
Нажмите Start Indexing. Индексация большого проекта стоит копейки: эмбеддинги в десятки раз дешевле чат-моделей. Подробнее о моделях — в документации по эмбеддингам.
Если позже смените модель эмбеддингов, нажмите Clear Index Data и проиндексируйте проект заново — векторы разных моделей несовместимы.
Перенос настроек
Settings → About Roo Code → Manage Settings → Export сохраняет все профили в roo-code-settings.json. Файл можно импортировать на другом компьютере. Внутри — ключи API в открытом виде, не публикуйте его.
Какую модель выбрать
| Задача | Модель |
|---|---|
| Основная работа | claude-sonnet-5.5 |
| Сложные задачи и планирование | claude-opus-5.5, gpt-6.1-sol |
| Специализированная модель для кода | kimi-k2.7-code |
| Экономия | deepseek-v4.1-flash, glm-5.3 |
| Open-source | qwen3-coder-next |
Roo работает через нативный tool calling, поэтому модели без поддержки инструментов не подойдут.
Устранение неполадок
Ошибка 404
Base URL должен заканчиваться на /v1: https://api.aitunnel.ru/v1. Для провайдера Anthropic — наоборот, без /v1.
Ошибка 400 на моделях с рассуждением
Включите Enable R1 model parameters в настройках профиля. Если ошибка о параметре max_completion_tokens — снимите галочку Include max output tokens.
Агент «зацикливается» или обрезает ответы
Увеличьте Max Output Tokens и проверьте Context Window Size: если он меньше реального, Roo слишком рано сжимает историю.
Индексация не стартует
Проверьте, что Qdrant запущен (curl http://localhost:6333), а Embedding Dimension совпадает с моделью: 1536 для text-embedding-3-small, 3072 для text-embedding-3-large.
Почему это выгодно
- Без VPN — российский endpoint
api.aitunnel.ru - Один ключ для чата, режимов и эмбеддингов
- Оплата в рублях — карты МИР, СБП, от 500₽
- Расходы по каждому запросу — в личном кабинете
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- Провайдер OpenAI Compatible с автозагрузкой моделей
- Claude через провайдер Anthropic с кэшированием
- Отдельные профили и модели для режимов
- Семантическая индексация кода на эмбеддингах AITUNNEL
- Экспорт и импорт настроек
- Без VPN, оплата в рублях
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.