JetBrains AI Assistant: подключение в IntelliJ и PyCharm

JetBrains AI Assistant работает во всех IDE на платформе IntelliJ — IntelliJ IDEA, PyCharm, WebStorm, GoLand и так далее — и настройки провайдера у них общие. Сторонний ключ подключается через раздел кастомных OpenAI-совместимых провайдеров, а не через основной аккаунт JetBrains AI.

Где искать настройки

Settings / Preferences → Tools → AI Assistant → Models. В этом разделе есть возможность добавить сторонний OpenAI-совместимый эндпоинт отдельно от основного провайдера JetBrains. Добавьте новую запись и заполните три поля: URL, ключ, модель.

Что вписывать

• Base URL / API endpoint: https://api.zukko.pro/v1 — JetBrains AI Assistant работает через OpenAI-совместимый протокол, поэтому суффикс /v1 обязателен, в отличие от Anthropic-режима у других инструментов.
• API Key: ваш ключ вида fetch_... из https://zukko.pro/app/api-keys↗. Ключ показывается один раз при создании.
• Model: точный id из каталога, например gpt-5.6-sol, gpt-5.6-luna, claude-sonnet-5, claude-opus-5-5 или glm-5.3 (актуальный список — GET https://api.zukko.pro/v1/models). Поле обычно текстовое, а не выпадающий список — опечатка здесь не подсветится заранее, её покажет только ответ сервера.

Если в вашей версии IDE такого раздела нет — обновите плагин AI Assistant до последней версии, поддержка кастомных провайдеров добавлялась постепенно и в старых сборках может отсутствовать.

Проверка ключа до того, как открывать IDE

Быстрее один раз проверить ключ через curl, чем перезапускать IDE после каждой правки настроек:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"ping"}]}'

Если curl получил ответ, а AI Assistant в IDE — нет, дело почти всегда в одном из двух: суффикс /v1 пропущен в поле URL, или IDE закэшировала старые настройки провайдера (в этом случае помогает перезапуск IDE, а не повторное сохранение тех же настроек).

Список моделей и цены

Актуальный каталог доступен без ключа:

curl https://api.zukko.pro/v1/models

А если нужны ещё лимиты и цены за токен — расширенная версия:

curl https://api.zukko.pro/v1/models/info

Полезно свериться перед тем, как вписывать id модели в настройки IDE вручную — опечатка в версии (например, gpt5.6-sol без дефиса) даст 404 model_not_found, а не подсказку с автодополнением.

Разбор ошибок

• 401 — ключ не принят: {"error":{"message":"Invalid API key. Use Authorization: Bearer fetch_*","type":"authentication_error"}}. Проверьте, что при копировании из кабинета не прилип пробел или перенос строки.
• 402 — баланс пуст: {"error":{"message":"Недостаточно средств на балансе","code":"insufficient_balance"}}. Списание проверяется до похода к модели, так что неудачная попытка бесплатна.
• 404 model_not_found — опечатка в имени модели, регистр и точки в версии значимы.
• 400 model_retired — модель снята с обслуживания, замена указана прямо в тексте ошибки.
• 503 model_disabled — модель выключена в каталоге; впишите в настройки одну из актуальных.
• 429 — от Zukko это только лимит конкретного ключа (key_daily_limit_reached со сбросом в 00:00 UTC / key_monthly_limit_reached), если он настроен на странице ключа в кабинете; общего rate limit на шлюзе нет, прочие 429 приходят от провайдера модели.
• 403 model_not_allowed_for_key — на ключ в кабинете настроен список разрешённых моделей, и текущая модель туда не входит.

Особенности работы внутри IDE

JetBrains AI Assistant использует модель и для чата, и для инлайн-подсказок в редакторе, и оба сценария считаются как обычные запросы к /v1/chat/completions — отдельного бесплатного режима для автодополнения нет. Если хочется сэкономить на частых однотипных подсказках, для них логично попробовать дешёвую модель, например glm-5.3-flash ($0.04 за 1M токенов), а для сложных задач в чате — claude-opus-5-5 ($0.30, контекст 1,000,000 токенов); какая модель справится лучше, проверьте на своих задачах.

Модели Claude и GPT поддерживают vision, так что если в диалог с AI Assistant добавить скриншот ошибки или диаграммы, они смогут его прочитать; glm-5.3 и glm-5.3-flash изображения не принимают.

Лимиты и оплата

На странице ключа в кабинете https://zukko.pro/app/api-keys↗ можно задать дневной или месячный лимит расхода в долларах и ограничить список разрешённых моделей — стоит сделать, если ключ вписан в общие настройки IDE на рабочей машине. В обычных (не потоковых) ответах API есть заголовки X-Zukko-Cost-Micros (стоимость запроса в микродолларах, 1,000,000 = $1) и X-Fetch-Balance-Cents (остаток после списания, тоже в микродолларах); у потоковых ответов их нет, а в самой IDE они не видны — расход удобнее смотреть в кабинете или через GET /v1/usage (история по всему аккаунту, с курсорной пагинацией).

Пополнение — СБП, карта через PayPear, крипта, иностранная карта Mastercard EU через Fride (комиссия около 13%, суммы $2–$594); минимум — $1. Разово начисляется $0.50 за подписку на Telegram-канал @zukkopro↗ — привяжите Telegram в кабинете, подпишитесь и нажмите «Проверить» (один раз на Telegram-аккаунт). Стартового баланса при обычной регистрации нет.

Поддержка — https://t.me/zukkopro?direct↗.

Бесплатный подсчёт токенов перед большим запросом

Если собираетесь вставить в чат AI Assistant объёмный файл или лог ошибки целиком, можно заранее узнать его вес в токенах, не тратя баланс — эндпоинт /v1/messages/count_tokens только считает:

curl https://api.zukko.pro/v1/messages/count_tokens \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"текст запроса"}]}'

Это работает и для Anthropic-модели напрямую, независимо от того, что сам AI Assistant обращается к каталогу через OpenAI-совместимый протокол.