Roo Code + Heli: агент в VS Code через OpenAI Compatible

Roo Code — агент для VS Code с режимами работы (Code, Architect, Ask, Debug и собственные), который читает и меняет файлы, запускает команды и ведёт задачу по шагам. Модели он берёт у провайдера, которого вы настроите. Вариант «OpenAI Compatible» подходит для Heli: один ключ sk-heli-…, модели разных вендоров, оплата в рублях.

Настройка

  1. Зарегистрируйтесь на getheli.ru (почта с подтверждением или Google / Яндекс ID) и создайте ключ на вкладке «Ключи».
  2. Установите расширение Roo Code и откройте его настройки (значок шестерёнки).
  3. API Provider — OpenAI Compatible.
  4. Base URL — https://getheli.ru/v1, API Key — sk-heli-….
  5. Model — слаг модели Heli, например anthropic/claude-sonnet-5.
  6. В Model Configuration укажите Context Window и Max Output Tokens. Поля Input/Output Price можно оставить пустыми: фактическое списание всё равно идёт по тарифам Heli, их видно в кабинете.
code
API Provider: OpenAI Compatible
Base URL:     https://getheli.ru/v1
API Key:      sk-heli-ВАШ_КЛЮЧ
Model:        anthropic/claude-sonnet-5

# Быстрая проверка ключа и слага
curl https://getheli.ru/v1/models -H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ"

Профили под разные режимы

Roo Code позволяет сохранить несколько профилей конфигурации и закрепить их за режимами. Удобная схема: для Architect — сильная модель, для Code и Debug — модель подешевле. Все профили используют один и тот же base URL и ключ Heli, отличается только Model. В режиме Orchestrator задача делится на подзадачи, и каждая уходит в режим со своим профилем — так дорогая модель тратится только на планирование, а рутинные правки делает дешёвая.

Какие модели выбрать

Roo Code вызывает инструменты только через нативный tool calling: модель без поддержки tools с ним работать не будет. Надёжные варианты — Claude Sonnet 5, GPT-5.5 и для экономии Qwen3 Coder Next. Агентные задачи расходуют много токенов на контекст, поэтому для команды полезно задать лимиты расходов в разделе «Лимиты» кабинета и смотреть расход по каждому ключу на вкладке «Ключи».

Частые ошибки

  • Invalid API Key / 401 — ключ неверный или отозван; создайте новый в кабинете.
  • 402 — недостаточно средств, пополните баланс («Пополнить»).
  • Model Not Found — опечатка или нет префикса вендора; скопируйте слаг из /v1/models.
  • Ошибки tool calling — выбранная модель не поддерживает инструменты; переключитесь на одну из моделей выше.
  • Таймауты — сократите контекст задачи или выберите более быструю модель.

Справка по API — в документации, пополнение — в разделе «Оплата». Похожий агент — Cline.

Попробуйте Heli

Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.

Документация API · Модели и цены

Читайте также