Интеграция с JetBrains IDE

Использование Claude Code через QCode в IntelliJ IDEA, WebStorm, PyCharm, GoLand и других JetBrains IDE

Последняя проверка: 2026-09-18 · 📄 По официальной документации (плагин Claude Code для JetBrains 0.1.14-beta (Marketplace; нужна IDE ≥2024.2))

Кратко¶

Claude Code предоставляет официальный плагин для JetBrains. Документация называет шесть IDE (в том числе Android Studio, которой нужен Ladybug 2024.2.1 или новее; отдельно JetBrains MPS требует 2024.3+), а в списке совместимости Marketplace есть RubyMine, CLion, Rider, DataGrip и другие IDE на платформе IntelliJ — так что «годится любая IDE на IntelliJ» мы не обещаем: проверьте страницу плагина внутри своей IDE перед установкой. В этом руководстве показано, как установить плагин и направить его на шлюз QCode, чтобы вызывать флагманские модели вроде Claude Opus 5 и Sonnet 5 с меньшими затратами.

Плагин использует ту же конфигурацию, что и версия для командной строки: если ваш CLI claude может подключиться к QCode, плагин для IDE тоже будет работать.

Предварительные требования¶

1. Claude Code CLI установлен и работает корректно (проверяйте claude --version, не сверяйте с устаревшей цифрой на странице)

2. Выполните установку по инструкции

3. Настройте переменные окружения для QCode API

4. Выполните claude --version в терминале, чтобы убедиться в работоспособности

5. JetBrains IDE версии 2024.2 или выше (в записи Marketplace для плагина нижняя граница — сборка 242.0, то есть 2024.2; на 2024.1 плагин показан как несовместимый)

6. API-ключ QCode (начинается с cr_) — один и тот же ключ работает для всех конечных точек

Установка¶

Шаг 1: Установка плагина Claude Code¶

1. Откройте JetBrains IDE

2. Перейдите в Settings / Preferences → Plugins → Marketplace

3. Найдите Claude Code [Beta] — это и есть официальное название в Marketplace (издатель Anthropic PBC, xmlId com.anthropic.code.plugin). ⚠️ Если искать просто "Claude Code", первыми выпадут несколько сторонних одноимённых плагинов; ставьте тот, что издан Anthropic PBC

4. Нажмите Install

5. Перезапустите IDE

Подсказка: Если из вашей сети нет прямого доступа к JetBrains Marketplace, скачайте пакет .zip со страницы плагина и установите его офлайн через Plugins → значок шестерёнки → Install Plugin from Disk.... Подробности смотрите в официальной документации JetBrains.

Шаг 2: Настройка доступа к QCode¶

Плагин повторно использует конфигурацию Claude Code CLI. Основа — две переменные окружения:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

Пользователям в материковом Китае: замена api.qcode.cc на asia.qcode.cc обычно даёт более высокую скорость и стабильность:

bash export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

Четыре домена api / asia / us / eu используют один и тот же API-ключ, поэтому выбирайте наиболее подходящий для вашего региона. В конце BASE_URL не должно быть слеша.

Подсказка: JetBrains IDE наследует системные переменные окружения. Если вы уже настроили их в ~/.zshrc или ~/.bashrc, IDE подхватит их при запуске — при условии, что IDE запущена из окружения, в котором эта конфигурация была загружена (см. раздел вопросов ниже).

Если вы не хотите полагаться на глобальные переменные окружения, их можно задать для отдельного проекта (см. Часто задаваемые вопросы).

Шаг 3: Проверка¶

1. В IDE нажмите Cmd+Esc (macOS) или Ctrl+Esc (Windows/Linux), чтобы открыть панель Claude Code

2. Введите простое сообщение (например, «привет») для проверки подключения

3. Если вы получили нормальный ответ, значит плагин успешно подключился через QCode

Доступность самого шлюза можно также проверить с помощью curl (ответ 401 означает, что путь верен и не хватает только аутентификации, что ожидаемо):

curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← путь верен, как и ожидалось

Использование¶

Горячие клавиши¶

Фактические сочетания клавиш зависят от версии плагина и вашей раскладки (keymap); для настройки найдите «Claude» в Settings → Keymap.

Основные возможности¶

1. Объяснение кода: выделите код → правая кнопка → Ask Claude, чтобы он объяснил эту логику

2. Генерация кода: опишите задачу на естественном языке в панели Claude, чтобы он сгенерировал или изменил код

3. Исправление ошибок: отправьте трассировку стека или сообщение об ошибке Claude для анализа и исправления

4. Рефакторинг кода: выделите целевой код и попросите Claude улучшить его структуру, выделить функции или добавить тесты

Нативный режим Diff¶

Плагин глубоко интегрирован с JetBrains: когда Claude предлагает изменения файлов, они отображаются в нативном режиме параллельного сравнения (diff) IDE, так что вы можете просмотреть каждое изменение, принять или отклонить его, а затем записать на диск. Это нагляднее и безопаснее, чем обычный diff в терминале.

Совместное использование со встроенным терминалом¶

Встроенный терминал JetBrains IDE также позволяет запускать команду claude напрямую, с полной функциональностью CLI. Плагин автоматически передаёт CLI текущий открытый файл и выделение в качестве контекста, поэтому их лучше всего использовать вместе.

Ввод изображений (визуальные возможности)¶

Модели с поддержкой зрения (Claude Opus 5 / Sonnet 5, а также семейство GPT-5.x) могут читать изображения в качестве ввода:

• Вставьте скриншот напрямую (Ctrl+V) в панель Claude
• Перетащите файл изображения в окно чата
• Укажите путь к файлу изображения в запросе

Типичные сценарии: воссоздание интерфейса по макету/скриншоту, отладка по скриншоту ошибки, чтение архитектурных диаграмм и графиков.

Это ввод изображений, а не их генерация. Чтобы модель генерировала изображения, используйте модель gpt-image-2 — см. Генерация изображений gpt-image-2.

Выбор модели¶

В панели Claude модель можно переключать командой /model; все модели вызываются через один и тот же ключ QCode. Распространённые варианты:

Цены мы на эту страницу не переносим — смотрите актуальные значения на qcode.cc/models (администратор может менять тарифы).

QCode также поддерживает модели GPT-5.x и Gemini, но плагин Claude Code для JetBrains ориентирован на протокол Anthropic; GPT/Gemini лучше использовать в соответствующих инструментах, таких как Codex / Antigravity. Цены — на qcode.cc/models. Идентификаторы 4.x (claude-sonnet-4-6, claude-opus-4-8) по-прежнему в продаже.

Продвинутое использование¶

• Динамические рабочие процессы (Dynamic Workflows): включите в запрос ключевое слово ultracode (или просто попросите «запустить workflow»), чтобы оркестрировать от десятков до сотен фоновых субагентов параллельно для крупных задач (ревью кода по всему репозиторию, массовая миграция, исследование по множеству файлов и т. д.). Субагенты работают в фоне, пока вы продолжаете работу; проверяйте ход выполнения командой /workflows. Они работают на той модели, на которую настроен Claude Code, — поэтому работают и при направлении на QCode. См. Субагенты.

• Headless / автоматизация: в терминале IDE также можно использовать claude -p "<запрос>" с --output-format json|text|stream-json для вызовов из скриптов. json возвращает структурированный объект с полями result, total_cost_usd, usage и session_id, который легко разобрать с помощью jq. См. Автоматизация и CI/CD.

У плагина собственная страница настроек¶

Официально: Settings → Tools → Claude Code [Beta]. Перечисленные пункты:

• Claude command — какой командой плагин запускает Claude Code, например claude, /usr/local/bin/claude, npx @anthropic-ai/claude-code. Если IDE не находит claude, официальный способ — прописать сюда абсолютный путь, а не переделывать запуск оболочки

• Suppress notification for when Claude Command is not found — убрать уведомление о ненайденной команде

• Enable using Option+Enter for multi-line prompts — только macOS
• Enable automatic updates — автоматически искать и ставить обновления плагина (применяется после перезапуска)

Подключение внешнего терминала: /ide¶

По официальной документации, команда /ide внутри Claude Code в любом внешнем терминале подключает его к запущенной JetBrains IDE и включает все функции. При успехе Claude Code отвечает чем-то вроде Connected to IntelliJ IDEA.; если обнаружена IDE без плагина, /ide сам ставит плагин и просит перезапустить IDE. С QCode всё так же — внешний claude использует уже настроенный ANTHROPIC_BASE_URL.

Удалённая разработка JetBrains: плагин ставится на хост¶

Документация требует прямо: при JetBrains Remote Development плагин нужно ставить на удалённом хосте через Settings → Plugins → Plugin (Host). Установка на локальном клиенте результата не даст.

AI Assistant — это другой продукт¶

Эта страница про плагин Claude Code: он использует ваш собственный CLI claude по протоколу Anthropic, а base URL берётся из переменной окружения. У JetBrains есть и AI Assistant — там тоже можно подключить сторонние модели, но вход другой: Settings | Tools | AI Assistant | Providers & API keys, и, согласно документации, поле URL есть только у типа "OpenAI-compatible" — у Anthropic и Gemini API key поля только для ключа.

AI completion в AI Assistant (автодополнение в строке / next edit) тоже работает только с эндпоинтом "OpenAI Compatible", и документация предупреждает: для автодополнения нужна поддержка Fill-in-the-Middle, которой у универсальных диалоговых моделей обычно нет.

Часто задаваемые вопросы¶

Плагин не отображает панель Claude Code?¶

1. Убедитесь, что плагин установлен и активирован (Settings → Plugins → Installed)

2. Убедитесь, что Claude Code CLI установлен глобально: выполните claude --version в терминале — должен появиться номер версии (см. официальные Releases)

3. Убедитесь, что версия IDE ≥ 2024.2

4. Перезапустите IDE; при необходимости выполните File → Invalidate Caches / Restart

Esc не прерывает генерацию?¶

Официальная запись в разделе устранения неполадок: в терминалах JetBrains Esc перехватывает IDE, чтобы перенести фокус в редактор. Правится в Settings → Tools → Terminal — либо снимите галочку "Move focus to the editor with Escape", либо нажмите "Configure terminal keybindings" и удалите сочетание "Switch focus to Editor".

Переменные окружения не подхватываются?¶

JetBrains IDE может не считывать переменные окружения из конфигурационных файлов оболочки (процессы, запущенные из GUI, часто не загружают ~/.zshrc). Решения:

• macOS: запускайте IDE из терминала (например, open -a "IntelliJ IDEA"), а не из Dock; либо используйте Tools → Create Command-line Launcher и запускайте из терминала

• Все платформы: добавьте ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN вручную в Run/Debug Configurations → Environment variables

• Постоянство: задайте их через JetBrains Toolbox, *.vmoptions или системные переменные окружения, чтобы они считывались при каждом запуске

Ошибка аутентификации / 401 / 403?¶

1. Проверьте, что ANTHROPIC_AUTH_TOKEN — действительный ключ QCode, начинающийся с cr_, без лишних пробелов или кавычек

2. Убедитесь, что в конце ANTHROPIC_BASE_URL нет слеша, а путь — /api (протокол Anthropic)

3. Выполните curl -i https://api.qcode.cc/api/v1/messages: ответ 401 означает, что шлюз доступен (не хватает только аутентификации); ошибка соединения указывает на проблему с сетью/прокси

Тайм-ауты соединения / блокировка за корпоративным прокси?¶

• Пользователям в материковом Китае сначала следует переключиться на asia.qcode.cc

• Если вы за корпоративным прокси, убедитесь, что в IDE правильно настроен Settings → Appearance & Behavior → System Settings → HTTP Proxy, либо задайте переменную окружения HTTPS_PROXY для терминала

• Убедитесь, что брандмауэр разрешает процессу IDE исходящий доступ к *.qcode.cc:443

Изменили переменные окружения, но IDE их не замечает?¶

Переменные окружения считываются один раз при запуске процесса. После редактирования ~/.zshrc или системных переменных нужно полностью закрыть и перезапустить IDE (а не просто открыть окно заново), чтобы изменения вступили в силу.

Следующие шаги¶

• Ознакомьтесь с конечными точками и форматами API, чтобы узнать о четырёх доменах и base URL для каждого протокола

• Ознакомьтесь с интеграцией с VS Code для использования расширения VS Code

• Ознакомьтесь с интеграцией с Cline — ещё одним AI-расширением для VS Code

• Изучите советы по CLI для работы в терминале

Хотите узнать, какую модель выгоднее всего запускать в JetBrains? Загляните на страницу цен QCode и выберите Opus / Sonnet / Haiku под свой бюджет.