JetBrains AI Assistant + Heli: провайдер OpenAI-compatible

JetBrains AI Assistant — встроенный ассистент IntelliJ IDEA, PyCharm, WebStorm, GoLand и других IDE: чат по проекту, генерация кода, объяснение ошибок, сообщения коммитов. Помимо моделей JetBrains, он умеет работать со сторонними провайдерами, в том числе с любым OpenAI-совместимым endpoint. Так к IDE подключается Heli — с ключом sk-heli-… и оплатой в рублях.

Что поддерживается

В актуальных версиях AI Assistant есть раздел Third-party AI providers с вариантом OpenAI-compatible — это режим «свой ключ» (BYOK): чат и агентные функции работают на моделях выбранного провайдера. Часть функций JetBrains может по-прежнему требовать собственные модели или подписку — список меняется от версии к версии, сверяйтесь с документацией AI Assistant для вашей IDE. Если пункта OpenAI-compatible нет, обновите IDE и плагин AI Assistant.

Настройка

  1. Зарегистрируйтесь на getheli.ru (почта с подтверждением или Google / Яндекс ID) и создайте ключ на вкладке «Ключи» кабинета.
  2. Откройте Settings | Tools | AI Assistant | Providers & API keys.
  3. В блоке Third-party AI providers выберите Provider OpenAI-compatible.
  4. URL: https://getheli.ru/v1, API Key: sk-heli-….
  5. Включите Tool calling, если планируете MCP-инструменты, и нажмите Test Connection — IDE запросит список моделей через /v1/models.
  6. Нажмите Apply и выберите модель Heli в селекторе моделей AI Chat. Для автодополнения в том же разделе есть отдельный блок AI Completion: Provider OpenAI Compatible, Base URL, API key и Model.

Итоговые значения полей:

code
Provider:  OpenAI-compatible
URL:       https://getheli.ru/v1
API Key:   sk-heli-ВАШ_КЛЮЧ
Model:     anthropic/claude-sonnet-5   # слаг из каталога Heli

# Проверка ключа вне IDE
curl https://getheli.ru/v1/models -H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ"

Какие модели выбрать

Для чата по большому Java/Kotlin-проекту и рефакторинга подойдут Claude Sonnet 5 или GPT-5.5. Для автодополнения важна скорость, а не глубина — берите быструю модель вроде GPT-5.4 mini. Слаг указывается целиком, с префиксом вендора.

Частые ошибки

  • Test Connection не проходит — проверьте, что URL заканчивается на /v1 без лишнего слеша. Некоторые сборки AI Assistant сами подставляют /v1; если в логе видны запросы к /v1/v1/…, укажите https://getheli.ru.
  • 401 — неверный или отозванный ключ; создайте новый в кабинете.
  • 402 — закончился баланс, пополните его в кабинете («Пополнить»).
  • Модель не найдена — слаг без префикса вендора или с опечаткой; сверьте с /v1/models.
  • Долгие ответы — уменьшите контекст (меньше файлов в чате) или выберите более быструю модель.

Справка по API — в документации, оплата — в разделе «Оплата». Если AI Assistant недоступен, в IDE JetBrains можно поставить Continue с теми же base URL и ключом.

Попробуйте Heli

Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.

Документация API · Модели и цены

Читайте также