> ## 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.

# JetBrains AI Assistant со своим ключом: Claude, DeepSeek и GPT через RuAPI

> Как подключить AI Assistant в IntelliJ IDEA, PyCharm, WebStorm и других IDE JetBrains к RuAPI через OpenAI-совместимого провайдера: свой ключ, без подписки JetBrains AI. Без VPN, оплата в USDT.

**AI Assistant** — встроенный ИИ-помощник в IDE JetBrains: IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Rider и других. С декабря 2025 года к нему можно подключить собственный ключ стороннего провайдера (BYOK) — в том числе OpenAI-совместимого, такого как RuAPI. Тогда чат и функции AI Assistant работают на моделях Claude, GPT, Gemini, DeepSeek и других, а платите вы только за использованные токены. RuAPI работает из России без VPN, баланс пополняется в USDT, карта иностранного банка не нужна.

<Note>
  По документации JetBrains, для подключения стороннего провайдера подписка JetBrains AI не требуется. Без неё часть фирменных функций JetBrains может быть недоступна, но чат и основные функции работают на подключённых моделях.
</Note>

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

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

  <Step title="Актуальная версия IDE">
    Обновите IDE JetBrains и плагин AI Assistant до последней версии: подключение собственных ключей появилось в декабре 2025 года.
  </Step>
</Steps>

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

## Настройка

<Steps>
  <Step title="Откройте настройки провайдеров">
    **Settings** → **Tools** → **AI Assistant** → **Providers & API keys**.
  </Step>

  <Step title="Добавьте RuAPI как OpenAI-совместимого провайдера">
    В разделе **Third-party AI providers** заполните поля:

    | Поле | Значение |
    | - | - |
    | **Provider** | `OpenAI-compatible` |
    | **URL** | `https://www.ruapi.ai/v1` — **с** `/v1` на конце |
    | **API Key** | ваш ключ RuAPI `sk-...` |
    | **Tool calling** | включите — модели RuAPI для текста и кода поддерживают вызов инструментов |
  </Step>

  <Step title="Проверьте подключение">
    Нажмите **Test Connection**, дождитесь сообщения об успешном подключении и нажмите **Apply**.
  </Step>

  <Step title="Назначьте модели функциям">
    В разделе **Models Assignment** выберите модели:

    * **Core features** — основная модель: чат по умолчанию, генерация кода в редакторе, сообщения коммитов. Подойдёт `claude-sonnet-5-5` или `deepseek-flash`.
    * **Instant helpers** — быстрая модель для мелких задач: сбор контекста, заголовки чатов, подсказки имён. Подойдёт `deepseek-flash` или `gpt-5.4-mini`.
    * **Context window** — по умолчанию 64 000 токенов. Для больших файлов и длинных диалогов его можно увеличить, но не больше, чем поддерживает модель.

    Нажмите **Apply**.
  </Step>
</Steps>

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

## Проверка

Откройте окно **AI Chat**, выберите в списке моделей одну из моделей RuAPI и задайте вопрос по своему коду. Затем откройте Консоль RuAPI → **Журнал запросов**: там появится запись с моделью и стоимостью запроса.

## Ограничения

* **Автодополнение кода** (inline completion) настраивается отдельно, в разделе **AI Completion**, и требует специальных моделей с поддержкой FIM (Fill-in-the-Middle). Обычные чат-модели для этого не подходят — используйте RuAPI для чата и генерации кода.
* **Кэширование для Claude.** Через OpenAI-совместимого провайдера запросы к Claude идут без кэширования промптов. Для обычного чата это некритично; если вы много работаете с длинным контекстом, выбирайте для основных функций DeepSeek — у него кэширование включается автоматически. Для агентной работы с Claude удобнее [Claude Code](/ru/integrations/claude-code): он подключается к RuAPI в родном формате Claude, с кэшированием.

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

<AccordionGroup>
  <Accordion title="Test Connection не проходит">
    * Проверьте, что в поле **URL** указано `https://www.ruapi.ai/v1`, с `/v1` на конце.
    * Проверьте, что ключ RuAPI `sk-...` вставлен целиком, без лишних пробелов.
  </Accordion>

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

  <Accordion title="Модель не вызывает инструменты">
    Убедитесь, что у провайдера включён флажок **Tool calling** и выбрана текстовая модель, а не модель для генерации изображений или видео.
  </Accordion>

  <Accordion title="Раздела Providers & API keys нет">
    Обновите IDE и плагин AI Assistant до последней версии. Если IDE управляется организацией, администратор мог запретить сторонние ключи.
  </Accordion>
</AccordionGroup>

## Что дальше

* [Continue](/ru/integrations/continue) — открытый ассистент, который тоже работает в IDE JetBrains и поддерживает кэширование для Claude.
* [Переход с Cursor](/ru/integrations/cursor-alternatives) — сравнение агентов и пошаговая инструкция.
* [Модели и цены](/ru/models) — список доступных моделей.


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