Claude Code в JetBrains: IntelliJ IDEA и PyCharm на своём ключе

Если вы работаете в IntelliJ IDEA, PyCharm или WebStorm, то Claude Code в JetBrains можно подключить без переезда в другой редактор. Плагин показывает изменения в штатном окне сравнения и передаёт агенту выделенный код, а модели при этом вызываются по вашему ключу шлюза. Ниже: что именно ставится, как прописать адрес и ключ так, чтобы IDE их увидела, и что делать, если плагин не находит команду claude.

Как устроен Claude Code в JetBrains

Важная деталь, которую часто пропускают: плагин не содержит собственной копии агента. По документации Anthropic, он запускает команду claude во встроенном терминале IDE и подключается к ней. Поэтому ставить нужно два компонента: консольный Claude Code и плагин из JetBrains Marketplace.

Что даёт плагин поверх обычного терминала:

• быстрый запуск по Cmd+Esc (macOS) или Ctrl+Esc (Windows и Linux);
• просмотр правок в окне diff самой IDE, а не в терминале;
• автоматическая передача текущего выделения и открытой вкладки;
• вставка ссылок на файлы вида @src/auth.ts#L1-99 по Cmd+Option+K или Alt+Ctrl+K;
• доступ к диагностике IDE (ошибки линтера и синтаксиса), которую агент читает через инструмент getDiagnostics.

Список поддерживаемых сред включает IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm и GoLand.

Установка шаг за шагом

1. Установите консольный Claude Code. Для macOS и Linux официальный установщик выглядит так:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Если команда claude --version печатает номер версии, агент установлен. В документации Zukko↗ есть сводка по подключению Claude Code к шлюзу.

1. В IDE откройте Marketplace, найдите плагин Claude Code (в списке он помечен как Beta) и перезапустите среду.
2. Откройте проект, запустите claude во встроенном терминале или нажмите Cmd+Esc / Ctrl+Esc.

Если claude лежит там, где IDE его не находит, укажите полный путь в настройках плагина: Settings → Tools → Claude Code [Beta], поле Claude command. Там же допустим вариант npx @anthropic-ai/claude-code.

Подключаем ключ шлюза Zukko

Консольный Claude Code по умолчанию просит войти в аккаунт Anthropic. Чтобы работать через шлюз, нужны две переменные: адрес и токен. Для Claude Code адрес пишется без /v1, потому что клиент сам добавляет этот суффикс, а токен передаётся именно как ANTHROPIC_AUTH_TOKEN.

Здесь легко промахнуться. Переменные, которые вы экспортировали в ~/.zshrc, видны терминалу, но IDE, запущенная из Dock или из меню «Пуск», может их не получить. Самый надёжный способ — блок env в файле ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Ключ создаётся в кабинете↗: полный ключ показывается один раз, так что сразу сохраните его. Не кладите токен в .claude/settings.json внутри репозитория: этот файл обычно коммитят и он уходит всей команде. Для проектных значений есть .claude/settings.local.json, но его нужно добавить в .gitignore.

Проверка занимает минуту. Запустите claude во встроенном терминале и выполните /status: команда показывает, какой способ входа сейчас активен и какой адрес API используется. Там должны быть адрес шлюза и ANTHROPIC_AUTH_TOKEN. Если показан вход через аккаунт, значит переменные не дошли до процесса. По документации Anthropic, ANTHROPIC_AUTH_TOKEN стоит в порядке выбора выше сохранённого входа по подписке, так что /logout обычно не нужен.

Цены на 18 октября 2026: claude-sonnet-5-5 стоит у Zukko $0.4 за 1M токенов входа и $2 за 1M токенов выхода. Для примера возьмём задачу с 600 000 токенов свежего входа и 40 000 токенов выхода: 0.6 × 0.4 + 0.04 × 2 = 0.24 + 0.08 = $0.32. В Anthropic-формате, которым пользуется Claude Code, часть входа читается из кэша и оплачивается по цене чтения, так что реальный счёт обычно ниже. Актуальные цены смотрите через GET https://api.zukko.pro/v1/models или на странице «Модели» в кабинете.

Диффы в IDE и контекст выделения

Если правки открываются в терминале, а не в окне сравнения IDE, проверьте настройку:

1. запустите claude во встроенном терминале;
2. выполните /config;
3. выставьте Diff tool в значение auto, чтобы показывать diff в IDE, либо terminal, чтобы оставить его в консоли.

Пункт Diff tool появляется только тогда, когда Claude Code подключён к IDE. Если вы запустили агента во внешнем терминале, сначала выполните /ide: команда найдёт запущенную среду и свяжет сессию с ней. Для этого запускайте claude из корня того же проекта.

Про выделение стоит помнить: плагин по умолчанию отправляет модели текущую выделенную часть и путь к открытому файлу. Чтобы секреты из .env не попадали в запросы, добавьте правило запрета чтения для этого пути в настройках разрешений. По документации Anthropic, такое правило блокирует и выделенный текст, и уведомление об открытом файле.

Типичные проблемы

«Cannot launch Claude Code» или «command not found». claude не найден в PATH для IDE. Проверьте claude --version в обычном терминале и пропишите полный путь в поле Claude command.

«No available IDEs detected» после /ide. Убедитесь, что плагин включён, и полностью перезапустите IDE (иногда нужно сделать это несколько раз). В WSL2 причиной часто бывает сетевая схема NAT или брандмауэр Windows: в документации Anthropic описаны правило брандмауэра и режим mirrored networking.

Escape не прерывает агента. В Settings → Tools → Terminal снимите флажок «Move focus to the editor with Escape» либо удалите сочетание «Switch focus to Editor».

JetBrains Remote Development. Плагин нужно ставить на удалённый хост, а не на локальный клиент.

Ошибки шлюза. 401 означает неверный ключ (проверьте, что токен задан именно в ANTHROPIC_AUTH_TOKEN), 402 — не хватает баланса, 403 с кодом model_not_allowed_for_key — модель не входит в список разрешённых для ключа. Разбор по порядку есть в статье про 401, 402 и model not found↗.

Безопасность в IDE

Anthropic отдельно предупреждает: в режиме acceptEdits агент в JetBrains способен менять файлы конфигурации IDE, которые среда может запускать автоматически. Это повышает риск обхода запросов подтверждения для Bash. Разумный минимум: оставить ручное подтверждение правок и не давать агенту непроверенные промпты.

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

А что с Cline и расширениями

Тем, кто предпочитает не консольного агента, а плагин с чатом внутри IDE, можно посмотреть на Cline: по его документации он работает и в IDE JetBrains (в том числе через протокол ACP), а к шлюзу подключается как OpenAI-совместимый провайдер с адресом https://api.zukko.pro/v1. Пошаговая настройка описана в статье про Cline↗. Для VS Code у Claude Code есть собственное расширение: см. Claude Code в VS Code↗. Какой вариант удобнее, проще всего понять на своих задачах.

Создайте ключ в кабинете, пропишите его в ~/.claude/settings.json и проверьте /status: на первое подключение уходит около десяти минут.

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

Нужен ли отдельный плагин, если Claude Code уже стоит в терминале?

Для работы в консоли плагин не нужен. Он добавляет интеграцию: диффы в окне IDE, передачу выделения, диагностику и горячие клавиши.

Почему IDE не видит переменные окружения из .zshrc?

Приложение, запущенное из Dock или меню, наследует окружение графической сессии, а не вашей командной оболочки. Надёжнее прописать переменные в блок env файла ~/.claude/settings.json.

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

Любые из списка GET /v1/models, указав идентификатор в ANTHROPIC_MODEL или командой /model. Для агента на сложных задачах обычно берут claude-sonnet-5-5 или claude-opus-5-5; сравнивайте по цене, контексту и индексу силы и проверяйте на своих задачах.

Как оплатить доступ из России?

Баланс пополняется от $1 через СБП (платёжная страница добавляет комиссию 8,5%), картой MasterCard или криптовалютой. Подробности — в разделе про оплату в кабинете.