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

> **⚠️ Проект в архиве**: репозиторий [RooCodeInc/Roo-Code](https://github.com/RooCodeInc/Roo-Code) **архивирован (только чтение) с 2026-05-15** — обновлений и исправлений больше не будет. Описанная ниже настройка по-прежнему работает на уже установленных копиях и годится как справочник; если нужна активно поддерживаемая замена — переходите на [Kilo Code](/docs/ide/kilo-code) или [Cline](/docs/ide/cline).

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (статус архива проверен через 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](https://github.com/RooCodeInc/Roo-Code) |

[Roo Code](https://github.com/RooCodeInc/Roo-Code) — открытое расширение VS Code для AI-программирования, форк [Cline](/docs/ide/cline); от него, в свою очередь, отделился [Kilo Code](/docs/ide/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](/docs/getting-started/endpoints-and-api-paths).

## Установка

Найдите **Roo Code** в магазине расширений VS Code либо следуйте инструкциям в [репозитории проекта](https://github.com/RooCodeInc/Roo-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](/docs/usage/cn-models), например `glm-5.2`

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

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

```bash
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 |

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

- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths) — таблица «протокол × семейство моделей»
- [Подключение Kilo Code](/docs/ide/kilo-code) — нижестоящий форк, настройка почти та же
- [Интеграция с Cline](/docs/ide/cline) — вышестоящий проект
- [Китайские модели](/docs/usage/cn-models)