Подключение Roo Code

Используйте QCode.cc в расширении Roo Code для VS Code: выберите провайдер Anthropic, включите пользовательский base URL — и Claude заработает

Обновлено 2026-10-15

Нужен API-ключ? Зарегистрироваться →Эндпоинты и Base URL →

Содержание

⚠️ Проект в архиве: репозиторий RooCodeInc/Roo-Code архивирован (только чтение) с 2026-05-15 — обновлений и исправлений больше не будет. Описанная ниже настройка по-прежнему работает на уже установленных копиях и годится как справочник; если нужна активно поддерживаемая замена — переходите на Kilo Code или Cline.

Последняя проверка: 2026-10-15 · 📄 По официальной документации (статус архива проверен через GitHub API; релизы Roo Code больше не выпускаются)

Кратко

Параметр Описание
Доступные модели Claude ✅ (провайдер Anthropic + кастомный base URL) · GPT ✅ · китайские модели ✅ (OpenAI Compatible) · Gemini ❌
Протокол и Base URL Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1
Где настраивается Панель настроек расширения VS Code (выбор API Provider + чекбокс кастомного base URL)
Официальная документация репозиторий Roo Code

Roo Code — открытое расширение VS Code для AI-программирования, форк Cline; от него, в свою очередь, отделился Kilo Code. У всех трёх почти одинаковые экраны настроек, поэтому эта страница подходит и для них.

Какой протокол выбрать

Нужная модель API Provider Base URL
Claude Anthropic https://api.qcode.cc/api
GPT / четыре китайских семейства OpenAI Compatible https://api.qcode.cc/openai/v1

🔴 Не пытайтесь получить Claude через OpenAI Compatible — точка OpenAI у QCode отклонит запрос с model_not_available_on_endpoint. См. Точки доступа и форматы API.

Установка

Найдите Roo Code в магазине расширений VS Code либо следуйте инструкциям в репозитории проекта.

Настройка Claude (провайдер Anthropic)

  1. Откройте Настройки (значок шестерёнки) на панели Roo Code
  2. В API Provider выберите Anthropic
  3. В API Key укажите ключ QCode (начинается с cr_)
  4. Отметьте Use custom base URL и введите https://api.qcode.cc/api
  5. В списке моделей выберите claude-sonnet-5 (или другой актуальный id)
  6. Сохраните и отправьте сообщение в чат для проверки

Из материкового Китая замените хост на https://asia.qcode.cc/api (азиатский узел: Корея / Тайвань / Гонконг); ключ тот же. Без слеша в конце base URL — расширение само добавляет /v1/messages, а лишний слеш даёт 404.

Настройка GPT и китайских моделей (OpenAI Compatible)

  1. В API Provider выберите OpenAI Compatible
  2. Base URL: https://api.qcode.cc/openai/v1
  3. API Key: тот же ключ cr_
  4. Model ID: gpt-6-sol, gpt-5.6-terra либо китайский id, например glm-5.2

Проверка связи

Сначала проверьте точку и ключ через curl — так вы поймёте, нужно ли разбираться с интерфейсом расширения:

KEY="cr_ваш_ключ_QCode"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

JSON с полем content означает, что со стороны точки всё в порядке; если расширение всё равно не работает, дело в его настройках.

Диагностика

Симптом Причина Решение
model_not_available_on_endpoint Claude запрашивается через OpenAI Compatible Переключитесь на провайдер Anthropic и /api
Invalid API key Неверный ключ или пробелы Проверьте префикс cr_ и уберите пробелы
404 Слеш в конце base URL или неверный путь Сверьтесь с таблицей выше
Нужного id нет в списке моделей Его нет во встроенном списке расширения Введите его в поле пользовательского model id

Описание настроек

Параметр (интерфейс Roo Code) Что указать Пояснение
API Provider Anthropic (Claude) или OpenAI Compatible (GPT, китайские модели) Определяет протокол; неверный выбор сразу отклоняется
API Key Ключ QCode, начинающийся с cr_ Один и тот же ключ подходит для обоих provider
Use custom base URL Включите и укажите https://api.qcode.cc/api Нужно только для provider Anthropic; из материкового Китая — asia.qcode.cc
Base URL (OpenAI Compatible) https://api.qcode.cc/openai/v1 Без косой черты в конце
Model / Model ID Например claude-sonnet-5, gpt-6-sol, glm-5.2 Если модели нет во встроенном списке, введите её в поле для своего ID

Дополнительная диагностика

Сначала определите, где проблема: на стороне эндпоинта или в настройках интерфейса. Если curl из раздела «Проверка связи» возвращает ответ, со стороны QCode всё в порядке. Дальше по порядку:

  1. Сначала исключите мелочи: пробел вокруг ключа и косая черта в конце Base URL — две самые частые причины; исправьте, сохраните и отправьте тестовое сообщение.
  2. Перепутаны настройки Anthropic и OpenAI Compatible: после смены provider перепроверьте Base URL и ключ.
  3. Нужная модель отклоняется: Claude работает только через provider Anthropic, GPT и китайские модели — только через OpenAI Compatible; сверьтесь с эталонной таблицей в Эндпоинты и форматы API.
  4. Запросов не видно на стороне QCode: введите ключ на probe.qcode.cc и посмотрите, доходят ли запросы; если записей нет, запрос не отправлялся — проверьте Base URL в расширении.

Часто задаваемые вопросы

Roo Code в архиве. Можно ли им пользоваться?

Можно, но обновлений и исправлений больше не будет. По состоянию на 2026-10-15 GitHub API показывает репозиторий RooCodeInc/Roo-Code как архивный (только чтение), последний push — 2026-05-15. Существующие установки по-прежнему подключаются к QCode по настройкам с этой страницы; для поддерживаемого инструмента перейдите на Kilo Code или Cline — настройка почти такая же.

Можно ли использовать GPT в Roo Code?

Да. Выберите API Provider OpenAI Compatible, укажите Base URL https://api.qcode.cc/openai/v1, а в Model ID — gpt-6-sol или gpt-5.6-terra.

Почему Claude нельзя использовать через OpenAI Compatible?

OpenAI-эндпоинт QCode не принимает модели Claude и возвращает model_not_available_on_endpoint. Эта проверка выполняется до аутентификации, поэтому она означает выбор не того протокола, а не проблему с ключом. Для Claude используйте provider Anthropic.

Какой домен использовать из материкового Китая?

Рекомендуется asia.qcode.cc (для provider Anthropic — https://asia.qcode.cc/api); при нестабильности вернитесь на api.qcode.cc. Все три домена работают с одним ключом.

Чем настройка отличается от Cline и Kilo Code?

Интерфейсы очень похожи: Roo Code — форк Cline, а Kilo Code — форк Roo Code. Протокол, Base URL и ключ вводятся одинаково, различаются лишь некоторые подписи в меню.

Смежные документы

Начните с QCode

Один API-ключ для Claude Code, Codex и других инструментов; тарификация по токенам, цены каждой модели — на qcode.cc/models

Enterprise →