Поддерживаемые IDE
Плагин Claude Code работает с большинством JetBrains IDE, включая:- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
Функции
- Быстрый запуск: используйте
Cmd+Esc(Mac) илиCtrl+Esc(Windows/Linux) для открытия Claude Code непосредственно из редактора, или нажмите кнопку Claude Code в интерфейсе - Просмотр различий: изменения кода могут отображаться непосредственно в средстве просмотра различий IDE вместо терминала
- Контекст выделения: текущее выделение или вкладка в IDE автоматически передаются в Claude Code. Правила отказа
Readблокируют это совместное использование для соответствующих файлов - Ярлыки ссылок на файлы: используйте
Cmd+Option+K(Mac) илиAlt+Ctrl+K(Linux/Windows) для вставки ссылок на файлы, такие как@src/auth.ts#L1-99 - Совместное использование диагностики: диагностические ошибки из IDE, такие как ошибки lint и синтаксиса, автоматически передаются в Claude по мере работы
Установка
Плагин запускает командуclaude в интегрированном терминале вашей IDE и подключается к ней. Он не включает собственную копию CLI, поэтому установите обе части:
Установите Claude Code CLI
Следуйте руководству по быстрому старту для установки CLI, если вы еще этого не сделали. Плагин показывает уведомление “Cannot launch Claude Code” (Не удается запустить Claude Code), когда
claude отсутствует в вашем PATH.Установите плагин JetBrains
Установите плагин Claude Code из JetBrains Marketplace и перезагрузите вашу IDE.
claude установлен в месте, которое ваша IDE не может найти, установите полный путь в параметре Claude command плагина.
Claude Code работает с любой платной подпиской Claude (Pro, Max, Team или Enterprise) или с учетной записью Claude Console, и API ключ не требуется. Вам будет предложено войти при первом запуске claude.
После установки плагина может потребоваться полностью перезагрузить IDE, чтобы он вступил в силу.
Использование
Из вашей IDE
Запуститеclaude из встроенного терминала вашей IDE, и все функции интеграции будут активны.
Из внешних терминалов
Используйте команду/ide в любом внешнем терминале для подключения Claude Code к вашей JetBrains IDE и активации всех функций:
Конфигурация
Параметры Claude Code
Настройте интеграцию IDE через параметры Claude Code:- Запустите
claude - Введите команду
/config - Установите инструмент diff на
autoдля отображения различий в IDE, илиterminalдля сохранения их в терминале
Параметры плагина
Настройте плагин Claude Code, перейдя в Settings → Tools → Claude Code [Beta]:Общие параметры
- Claude command: укажите пользовательскую команду для запуска Claude, например
claude,/usr/local/bin/claudeилиnpx @anthropic-ai/claude-code - Suppress notification for Claude command not found: пропустить уведомления об отсутствии команды Claude
- Enable using Option+Enter for multi-line prompts: только на macOS. Если включено, Option+Enter вставляет новые строки в подсказки Claude Code. Отключите, если клавиша Option захватывается неожиданно. Требуется перезагрузка терминала.
- Enable automatic updates: автоматически проверять и устанавливать обновления плагина, применяемые при перезагрузке
Конфигурация клавиши ESC
Если клавиша ESC не прерывает операции Claude Code в терминалах JetBrains:- Перейдите в Settings → Tools → Terminal
- Либо:
- Снимите флажок “Move focus to the editor with Escape”, либо
- Нажмите “Configure terminal keybindings” и удалите ярлык “Switch focus to Editor”
- Примените изменения
Специальные конфигурации
Удаленная разработка
Плагин должен быть установлен на удаленном хосте, а не на вашей локальной клиентской машине.Конфигурация WSL
Если вы используете Claude Code на WSL2 с JetBrains IDE и видите “No available IDEs detected”, причина обычно заключается в NAT-сетевом взаимодействии WSL2 или брандмауэре Windows, блокирующем соединение между WSL2 и IDE, работающей на хосте Windows. WSL1 использует сеть хоста напрямую и не подвержена этой проблеме.Разрешить трафик WSL2 через брандмауэр Windows
Это рекомендуемое исправление, так как оно сохраняет ваш существующий режим сетевого взаимодействия WSL2.Найдите ваш IP-адрес WSL2
Из вашей оболочки WSL запустите:Запомните подсеть, например
172.21.123.45 находится в 172.21.0.0/16.Создайте правило брандмауэра
Откройте PowerShell от имени администратора и запустите следующее, отрегулировав диапазон IP в соответствии с вашей подсетью:
Переключите WSL2 на зеркальное сетевое взаимодействие
Зеркальное сетевое взаимодействие требует Windows 11 22H2 или более поздней версии. Если вы используете Windows 10, используйте вместо этого правило брандмауэра выше. Добавьте это в.wslconfig в вашем каталоге пользователя Windows:
wsl --shutdown из PowerShell.
Устранение неполадок
Плагин не работает
Если плагин установлен, но функции Claude Code не отображаются в вашей IDE:- Убедитесь, что вы запускаете Claude Code из корневого каталога проекта
- Проверьте, что плагин JetBrains включен в параметрах IDE
- Полностью перезагрузите IDE (может потребоваться сделать это несколько раз)
- Для Remote Development убедитесь, что плагин установлен на удаленном хосте
IDE не обнаружена
Если запускclaude показывает “No available IDEs detected”:
- Проверьте, что плагин установлен и включен
- Полностью перезагрузите IDE
- Проверьте, что вы запускаете Claude Code из встроенного терминала
- Для пользователей WSL см. конфигурацию WSL выше
Команда не найдена
Если нажатие на значок Claude показывает “command not found”:- Проверьте, что Claude Code установлен, запустив
claude --versionв терминале - Настройте путь команды Claude в параметрах плагина
- Для пользователей WSL используйте формат команды WSL, упомянутый в разделе конфигурации
Соображения безопасности
Когда Claude Code работает в JetBrains IDE в режиме разрешенияacceptEdits, он может быть в состоянии изменять файлы конфигурации IDE, которые могут быть автоматически выполнены вашей IDE. Это может увеличить риск запуска Claude Code в режиме acceptEdits и позволить обойти подсказки разрешений Claude Code для выполнения bash.
При запуске в JetBrains IDEs учитывайте:
- Использование режима ручного одобрения для редактирования
- Особую осторожность, чтобы убедиться, что Claude используется только с доверенными подсказками
- Осведомленность о том, какие файлы Claude Code имеет доступ для изменения