JetBrains IDE

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

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

Claude Code предоставляет официальный плагин для JetBrains, поддерживающий IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, RubyMine, CLion, Rider, DataGrip, Android Studio и все остальные IDE на платформе IntelliJ. В этом руководстве показано, как установить плагин и направить его на шлюз QCode, чтобы вызывать флагманские модели вроде Claude Opus 4.8 и Sonnet 4.6 с меньшими затратами.

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

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

1. Claude Code CLI установлен и работает корректно (текущая версия 2.1.187)

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

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

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

5. JetBrains IDE версии 2024.1 или выше (плагин зависит от относительно нового API платформы IntelliJ)

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

Установка¶

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

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

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

3. Найдите "Claude Code" (издатель: Anthropic)

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 4.8 / Sonnet 4.6, а также семейство GPT-5.x) могут читать изображения в качестве ввода:

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

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

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

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

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

QCode также поддерживает модели GPT-5.x и Gemini (тарификация ×2 по использованию), но плагин Claude Code для JetBrains ориентирован на протокол Anthropic; GPT/Gemini лучше использовать в соответствующих инструментах, таких как Codex / Antigravity. Полные цены см. по ссылке CTA ниже.

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

• Динамические рабочие процессы (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.

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

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

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

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

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

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

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

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 под свой бюджет.