К содержимому

Roo Code API: подключение и настройка моделей

Roo Code подключается так же, как Cline: провайдер OpenAI Compatible с адресом /v1 или Anthropic со своим адресом. Репозиторий github.com/RooCodeInc/Roo-Code заархивирован владельцем 15 мая 2026 года и доступен только для чтения, а в его README сказано, что расширение закрыто 15 мая.

  • Тип: Редактор и IDE
  • Протокол: OpenAI Chat Completions, Anthropic Messages
  • Статус: Работает
Сверено частично, 2026-10-02: в документации клиента есть пробел или источники расходятся. Не проверено вручную. Что проверить пробой, описано в разделе «Ловушки».

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовЧастичноНужны нативные вызовы инструментов.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте настройки Roo Code и выберите провайдера OpenAI Compatible.
  2. Введите адрес https://relay-llm.ru/v1, ключ и модель из каталога. В примере это gpt-5.6-luna.
  3. Для моделей Claude выберите провайдера Anthropic, включите свой адрес https://relay-llm.ru без /v1 и укажите модель вроде claude-haiku-5-5.

Провайдер OpenAI Compatible

text
API Provider: OpenAI Compatible
Base URL: https://relay-llm.ru/v1
API Key: YOUR_API_KEY
Model: gpt-5.6-luna

Провайдер Anthropic

text
API Provider: Anthropic
Use custom base URL: on
Base URL: https://relay-llm.ru
Anthropic API Key: YOUR_API_KEY
Model: claude-haiku-5-5

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Отправьте в Roo Code задачу «ответь одним словом: ping». Ответ пришёл, запрос виден в журнале кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Anthropic Messages

Работают модели, которые принимают этот протокол. Модели GPT по пути /v1/messages недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /v1.

Ловушки

  • Репозиторий заархивирован, и README называет расширение закрытым (источник: github.com/RooCodeInc/Roo-Code). Для новой установки лучше взять Cline или Kilo Code: схема настройки та же.
  • Работают только нативные вызовы инструментов. Резервного режима без них нет: модель без поддержки инструментов не заработает совсем.
  • Правило с /v1 для чужих адресов в документации не описано. Если запрос получает 404, уберите или добавьте /v1.
  • Некоторые «совместимые» провайдеры реализуют API частично. У шлюза поддерживаемые методы перечислены в разделе API.

Официальная документация: Roo Code API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key