Подключение Roo Code
Используйте QCode.cc в расширении Roo Code для VS Code: выберите провайдер Anthropic, включите пользовательский base URL — и Claude заработает
Нужен 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)¶
- Откройте Настройки (значок шестерёнки) на панели Roo Code
- В API Provider выберите Anthropic
- В API Key укажите ключ QCode (начинается с
cr_) - Отметьте Use custom base URL и введите
https://api.qcode.cc/api - В списке моделей выберите
claude-sonnet-5(или другой актуальный id) - Сохраните и отправьте сообщение в чат для проверки
Из материкового Китая замените хост на
https://asia.qcode.cc/api(азиатский узел: Корея / Тайвань / Гонконг); ключ тот же. Без слеша в конце base URL — расширение само добавляет/v1/messages, а лишний слеш даёт 404.
Настройка GPT и китайских моделей (OpenAI Compatible)¶
- В API Provider выберите OpenAI Compatible
- Base URL:
https://api.qcode.cc/openai/v1 - API Key: тот же ключ
cr_ - 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 всё в порядке. Дальше по порядку:
- Сначала исключите мелочи: пробел вокруг ключа и косая черта в конце Base URL — две самые частые причины; исправьте, сохраните и отправьте тестовое сообщение.
- Перепутаны настройки Anthropic и OpenAI Compatible: после смены provider перепроверьте Base URL и ключ.
- Нужная модель отклоняется: Claude работает только через provider Anthropic, GPT и китайские модели — только через OpenAI Compatible; сверьтесь с эталонной таблицей в Эндпоинты и форматы API.
- Запросов не видно на стороне 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 и ключ вводятся одинаково, различаются лишь некоторые подписи в меню.
Смежные документы¶
- Точки доступа и форматы API — таблица «протокол × семейство моделей»
- Подключение Kilo Code — нижестоящий форк, настройка почти та же
- Интеграция с Cline — проект, на основе которого создан Roo Code
- Китайские модели
Начните с QCode
Один API-ключ для Claude Code, Codex и других инструментов; тарификация по токенам, цены каждой модели — на qcode.cc/models