> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roo Code в России: как подключить Claude, DeepSeek и GPT через RuAPI

> Пошаговая настройка Roo Code в VS Code с RuAPI: Claude через провайдера Anthropic с кэшированием промптов, DeepSeek, GPT и Gemini через OpenAI Compatible, отдельный профиль для каждого режима. Без VPN, оплата в USDT.

[Roo Code](https://roocode.com) — ИИ-агент для разработки в VS Code: он пишет и редактирует код сразу в нескольких файлах, выполняет команды и работает в разных режимах — Architect, Code, Debug и других. Модель он берёт у провайдера, которого вы укажете в настройках. RuAPI даёт доступ к Claude, GPT, Gemini, DeepSeek, GLM, Qwen и Kimi по одному ключу и работает из России без VPN. Баланс пополняется в USDT, карта иностранного банка не нужна.

## Какой способ подключения выбрать

| Модели | API Provider | Адрес | Зачем |
| - | - | - | - |
| Claude: `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5` | **Anthropic** | `https://www.ruapi.ai` | Работает кэширование промптов: повторно отправляемый контекст обходится минимум в 10 раз дешевле |
| DeepSeek, GPT, Gemini, GLM, Qwen, Kimi и другие | **OpenAI Compatible** | `https://www.ruapi.ai/v1` | Один адрес для всех остальных моделей |

<Warning>
  Claude можно подключить и через **OpenAI Compatible**, но тогда кэширование не работает, и длинные задачи обходятся в несколько раз дороже. Для Claude выбирайте **Anthropic**.
</Warning>

Roo Code хранит настройки подключения в **профилях конфигурации**. Удобно завести два профиля — например, `RuAPI Claude` и `RuAPI DeepSeek` — и переключаться между ними прямо в чате.

## Что понадобится

<Steps>
  <Step title="Ключ RuAPI">
    Зарегистрируйтесь на [www.ruapi.ai](https://www.ruapi.ai/?utm_source=docs\&utm_campaign=ru-roo-code) и пополните баланс ([как пополнить](/ru/topup)). Затем откройте Консоль → **API-ключи** и нажмите **Создать ключ**. Ключ начинается с `sk-`.
  </Step>

  <Step title="Актуальная версия Roo Code">
    Установите Roo Code из VS Code Marketplace (по запросу «Roo Code») или обновите его до последней версии.
  </Step>
</Steps>

<Tip>
  Банковская карта не нужна: баланс пополняется в USDT. Если USDT у вас ещё нет, купить его за рубли поможет [пошаговая инструкция](/ru/buy-usdt). Карты иностранных банков тоже принимаются.
</Tip>

<Note>
  Если интерфейс Roo Code у вас на русском, названия полей будут переведены, но их порядок и назначение те же.
</Note>

## Профиль для Claude (провайдер Anthropic)

<Steps>
  <Step title="Создайте профиль">
    Откройте Roo Code на боковой панели → ⚙️ → **Providers**. Нажмите **+** рядом со списком профилей и задайте имя, например, `RuAPI Claude`.
  </Step>

  <Step title="Заполните поля">
    | Поле | Значение |
    | - | - |
    | **API Provider** | `Anthropic` |
    | **Anthropic API Key** | ваш ключ RuAPI `sk-...` |
    | **Use custom base URL** | отметьте флажок и укажите `https://www.ruapi.ai` — **без** `/v1` на конце |
    | **Model** | `claude-sonnet-5-5` для повседневной работы или `claude-opus-5-5` для сложных задач |
  </Step>

  <Step title="Сохраните профиль">
    Нажмите **Save**.
  </Step>
</Steps>

<Note>
  Если нужной модели нет в списке **Model**, обновите Roo Code: список моделей Anthropic встроен в расширение и обновляется с выходом новых версий.
</Note>

## Профиль для DeepSeek, GPT и других моделей (OpenAI Compatible)

<Steps>
  <Step title="Создайте ещё один профиль">
    ⚙️ → **Providers** → **+** и задайте имя, например, `RuAPI DeepSeek`.
  </Step>

  <Step title="Заполните поля">
    | Поле | Значение |
    | - | - |
    | **API Provider** | `OpenAI Compatible` |
    | **Base URL** | `https://www.ruapi.ai/v1` — **с** `/v1` на конце |
    | **API Key** | ваш ключ RuAPI `sk-...` |
    | **Model** | точное имя модели, например, `deepseek-flash`, `deepseek-v4-pro`, `gpt-5.4` или `glm-5.3` |
  </Step>

  <Step title="Проверьте параметры модели">
    В блоке параметров модели:

    * **Image Support** — включите для GPT, Gemini и `deepseek-flash`. `deepseek-v4-pro` изображения не принимает.
    * **Context Window** — размер контекстного окна модели. Не указывайте больше, чем поддерживает модель: иначе длинная задача завершится ошибкой о превышении контекста.
    * **Input Price / Output Price** — необязательные поля. Если указать здесь цены за 1 млн токенов (см. [страницу цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-roo-code)), Roo Code будет показывать примерную стоимость каждой задачи.
  </Step>

  <Step title="Сохраните профиль">
    Нажмите **Save**.
  </Step>
</Steps>

Точные имена всех моделей приведены на [странице цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-roo-code). Имя указывается в точности — с префиксом и с учётом регистра (например, `kimi/kimi-k3`).

<Note>
  Roo Code работает только с моделями, которые поддерживают вызов инструментов (tool calling). Основные текстовые модели RuAPI — Claude, GPT, Gemini, DeepSeek, GLM, Qwen, Kimi — его поддерживают; модели для генерации изображений и видео для Roo Code не подходят.
</Note>

## Своя модель для каждого режима

В Roo Code есть несколько режимов: **Architect** (проектирование и планирование), **Code** (написание и правка кода), **Ask** (вопросы по коду), **Debug** (поиск ошибок) и **Orchestrator** (разбиение большой задачи на подзадачи). Каждому режиму можно назначить свой профиль. Roo Code запоминает, какой профиль вы выбрали в каждом режиме, а закрепить профиль за режимом можно на вкладке **Prompts** в настройках.

Удачные сочетания:

| Режим | Профиль и модель |
| - | - |
| Architect, Orchestrator | `RuAPI Claude` с `claude-opus-5-5` |
| Code, Debug | `RuAPI Claude` с `claude-sonnet-5-5` или `RuAPI DeepSeek` с `deepseek-flash` |
| Ask | `RuAPI DeepSeek` с `deepseek-flash` — дёшево и быстро |

## Первая задача и проверка

Откройте папку проекта, выберите режим **Code** и поставьте задачу, например:

```
Добавь обработку ошибок в функцию parseConfig в файле config.ts
```

Чтобы убедиться, что запросы идут через RuAPI, откройте Консоль → **Журнал запросов**: там появятся записи с моделью и стоимостью каждого запроса. Если Claude подключён через Anthropic, начиная со второго-третьего шага в подробностях записи видно, сколько токенов прочитано из кэша.

## Как не тратить лишнего

* **Новая тема — новая задача.** Контекст растёт с каждым шагом и каждый раз отправляется целиком.
* **Сильная модель — только там, где она нужна.** Opus — для планирования, а рутинные правки и вопросы — для более дешёвых моделей.
* **Отдельный ключ с лимитом.** Создайте для Roo Code отдельный ключ и задайте ему лимит в разделе **API-ключи** Консоли.

## Решение проблем

<AccordionGroup>
  <Accordion title="401 / Invalid API Key">
    * Проверьте, что ключ RuAPI `sk-...` вставлен целиком, без лишних пробелов.
    * Для провайдера **Anthropic** адрес — `https://www.ruapi.ai` **без** `/v1`, для **OpenAI Compatible** — `https://www.ruapi.ai/v1` **с** `/v1`.
  </Accordion>

  <Accordion title="Model Not Found / 404 / 503">
    Имя модели должно в точности совпадать с именем на RuAPI — скопируйте его со [страницы цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-roo-code).
  </Accordion>

  <Accordion title="400: «enabled» is not supported for this model">
    Новые модели Claude (Opus 4.7 и новее, а также все модели пятого поколения) поддерживают только адаптивный режим рассуждений (adaptive thinking). Если старая версия Roo Code включает для такой модели рассуждения с бюджетом токенов, запрос отклоняется. Обновите Roo Code или отключите рассуждения в настройках модели.
  </Accordion>

  <Accordion title="Ошибки при вызове инструментов">
    Убедитесь, что выбрана текстовая модель, а не модель для генерации изображений или видео. Если ошибка повторяется на одной и той же модели, попробуйте другую — например, `claude-sonnet-5-5` или `deepseek-flash`.
  </Accordion>

  <Accordion title="400: The reasoning_content in the thinking mode must be passed back">
    Такое случается у DeepSeek в режиме рассуждений, если сменить модель или профиль посреди задачи. В большинстве случаев RuAPI сам повторяет запрос в исправленном виде. Если ошибка не исчезла, начните новую задачу.
  </Accordion>
</AccordionGroup>

## Что дальше

* [Cline](/ru/integrations/cline) и [Kilo Code](/ru/integrations/kilo-code) — похожие агенты для VS Code.
* [Claude Code](/ru/integrations/claude-code) — официальный консольный агент Anthropic.
* [Модели и цены](/ru/models) — список доступных моделей.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.