JetBrains AI Assistant не работает: причины и обходные пути

AI Assistant не активируется, молчит или недоступен в отдельных файлах. Разбираем причины по документации JetBrains и подключаем свои модели через шлюз.

6 мин · · IDE · ошибки

Запрос «jetbrains ai assistant не работает» объединяет несколько разных проблем: плагин не активируется, чат молчит, функции пропали в одном проекте или модель из вашего API не появляется в списке. Ниже разобраны причины, которые описаны в документации JetBrains AI Assistant (редакция 2026.2, страницы обновлены в октябре 2026), и два выхода: починить встроенный сервис или подключить свои модели через OpenAI-совместимый API. Названия пунктов меню мы берём из документации; в вашей версии IDE они могут немного отличаться, поэтому сверяйтесь с экраном.

JetBrains AI Assistant не работает: семь причин

Что видитеВероятная причинаЧто проверить
Нет значка AI в заголовке окна, нет вкладки AI ChatПлагин отключён или удалён, либо виджет убран с панелиSettings → Plugins → Installed, поиск по AI Assistant; виджет возвращается через Customize Toolbar
В одном проекте все функции серые, в других работаютAI отключён для проекта или в корне лежит файл .noaiМеню виджета JetBrains AI; корневая папка проекта
Отказ только на некоторых файлахФайл или папка попали в .aiignoreSettings → Tools → AI Assistant → Project Settings
Чат «думает», но ответа нет, ошибка соединенияСеть блокирует адреса сервиса JetBrains AIПрокси, файрвол, DNS
AI Assistant установлен, но не активированНе выбран способ активацииПодписка JetBrains AI или свои ключи провайдеров
Параметры серые или недоступныОрганизация управляет ИИ централизованноАдминистратор JetBrains IDE Services или Central
Свои модели подключены, но часть функций недоступнаМодели не назначены на функцииProviders & API keys, блок Models Assignment

1. Плагин или виджет

Документация описывает два уровня отключения: для проекта (пункт «Disable for This Project» в виджете JetBrains AI) и для всей IDE через плагин. Если значка нет, проверьте список установленных плагинов. Виджет и вкладка AI Chat без плагина остаются как приглашение его установить, они не дают доступа к коду.

2. Файл .noai

Пустой файл .noai в корне проекта полностью отключает функции AI Assistant, даже если проект откроют в другой IDE. Такой файл часто тянется вместе с репозиторием из команды, где ИИ запрещён. Он не влияет на сторонние плагины с ИИ.

3. Файл .aiignore

Если сбой только на части файлов, смотрите .aiignore. Синтаксис как у .gitignore. Файлы .cursorignore, .codeiumignore и .aiexclude в корне проекта AI Assistant тоже учитывает, поэтому правило может прийти из другого инструмента.

4. Сеть

Документация перечисляет базовые адреса сервиса, которые можно заблокировать на уровне сети: https://api.jetbrains.ai/ и https://api.app.prod.grazie.aws.intellij.net/. Если корпоративный файрвол, прокси или DNS режут эти адреса, чат не ответит. Проверьте, открываются ли они из той же сети, где запущена IDE.

5. Активация

Документация описывает несколько вариантов активации, среди них подписка JetBrains AI и собственные API-ключи сторонних провайдеров; полный актуальный список смотрите в разделе об активации. Если не выбран ни один, работать нечему.

6. Управление организацией

Если ИИ в организации настраивается централизованно (JetBrains IDE Services или Central), администратор может задать провайдера и запретить подключение своих моделей. Тогда выбор будет ограничен или недоступен, и это решается только на стороне администратора.

7. Свои модели без назначения

Самая частая ловушка для тех, кто уже подключил ключ. По документации модели от провайдеров Anthropic, Google и OpenAI назначаются на функции автоматически, но только если модель есть в предопределённом списке функции. Иначе функция недоступна. Модели из OpenAI-совместимого эндпоинта вручную назначаются в блоке Models Assignment, а до этого работают только в AI Chat.

JetBrains AI в России

Доступность встроенного сервиса JetBrains AI и способы оплаты подписки зависят от региона и условий JetBrains, поэтому смотрите актуальные условия на сайте JetBrains: мы их не комментируем. Если встроенный сервис вам недоступен, рабочий вариант не требует его вовсе: IDE умеет работать со сторонними моделями по вашему ключу. Из России к моделям можно подключиться через шлюз и оплатить баланс через СБП, картой MasterCard или криптой.

Как подключить свои модели через Zukko

Шаги по документации AI Assistant:

  1. Откройте Settings | Tools | AI Assistant | Providers & API keys.
  2. В блоке Third-party AI providers выберите провайдера, совместимого с OpenAI API (конкретное название пункта сверьте в списке вашей IDE).
  3. В поле URL укажите https://api.zukko.pro/v1.
  4. В поле API Key вставьте ключ fetch_... из кабинета Zukko.
  5. Если модель должна вызывать инструменты MCP-серверов, включите Tool calling.
  6. Нажмите Test Connection, затем Apply.
  7. Откройте AI Chat: модели провайдера появятся в отдельной секции селектора.
  8. В блоке Models Assignment назначьте модели на Core features и Instant helpers.

Если Test Connection отвечает ошибкой, начните с ключа (401 означает неверный ключ, 402 нехватку баланса) и адреса. Нужен ли /v1 в поле URL именно в вашей версии IDE, проверьте по этому тесту: для клиентов на OpenAI-формате Zukko использует базу с /v1. Подробнее о формате: chat/completions.

Какие модели назначить

  • Core features (генерация в редакторе, сообщения коммитов, модель по умолчанию в AI Chat): claude-sonnet-5-5 или gpt-6.1-sol. Это ориентир по цене и индексу силы (48 и 52), а подойдёт ли модель, проверьте на своём коде.
  • Instant helpers (названия чатов, подсказки имён, сбор контекста): дешёвая модель, например deepseek-v4.1-flash ($0.013 / $0.038 за 1M) или glm-5.3-flash ($0.04 / $0.04).

Что не заменить

По документации inline-автодополнение и next edit suggestions не используют модели из этого блока. Для автодополнения можно отдельно подключить OpenAI-совместимую модель, но она должна быть создана для дополнения кода (с поддержкой fill-in-the-middle), а универсальные чат-модели для этого обычно не подходят. Так что чат и генерация кода через шлюз работают, а быстрое подчёркивание «на лету» остаётся на встроенных моделях JetBrains. Чтобы были доступны все функции, документация советует использовать свои модели вместе с подпиской JetBrains AI.

Сколько это стоит

Цены на 18 октября 2026. Пусть (условные объёмы) вы делаете 20 запросов в чат в день, в каждом 6 000 входных и 800 выходных токенов (с вложенными файлами). Формула: 6000 × цена входа / 1M + 800 × цена выхода / 1M.

МодельЦена вход / выход, $ за 1MОдин запросДень (20)Месяц (22 дня)
claude-sonnet-5-50.4 / 20.0024 + 0.0016 = $0.0040$0.08$1.76
gpt-6.1-sol0.27 / 1.320.00162 + 0.001056 = $0.002676$0.0535$1.18

Для Claude через OpenAI-формат весь вход идёт по цене входа, скидка за кэш там не применяется. В AI Assistant есть порог обрезки сообщений: вложения, занявшие больше заданной доли контекстного окна, обрезаются, чтобы запрос поместился в модель. Это не инструмент экономии: расход контролируйте лимитом ключа. Актуальные цены: GET https://api.zukko.pro/v1/models.

См. также подробную инструкцию по IDE: JetBrains AI Assistant: подключение в IntelliJ и PyCharm.

Частые вопросы

Ключ работает, а в AI Chat моделей нет. Почему?

Проверьте, нажали ли вы Apply после Test Connection и открыли ли селектор моделей: модели провайдера показываются в отдельной секции. Если секции нет, проверьте, не ограничил ли подключение своих моделей администратор организации.

Нужна ли подписка JetBrains AI, чтобы использовать свои модели?

Для части функций нет, но документация прямо советует сочетать свои модели с подпиской, чтобы все функции работали. Условия подписки смотрите на сайте JetBrains.

Почему не работает автодополнение с моей моделью?

Автодополнение настраивается отдельно в разделе AI Completion и требует модели для дополнения кода. Чат-модель из блока Third-party providers для этого не используется.

Как быстро ограничить расход, пока я настраиваю?

Создайте отдельный ключ для IDE с дневным лимитом в долларах и списком разрешённых моделей. Если лимит исчерпан, API вернёт 429 с кодом key_daily_limit_reached, а не спишет лишнее.

Создайте ключ в кабинете, поставьте ему лимит и подключите по шагам выше.

zukko

Платите в 25×
меньше

за Claude Code & ChatGPT

Один ключ fetch_* и base URL api.zukko.pro — в Cursor, Claude Code, Codex и любом SDK.