JetBrains IDEs

Используйте Claude Code с JetBrains IDEs, включая IntelliJ, PyCharm, WebStorm и другие

Claude Code интегрируется с JetBrains IDEs через специальный плагин, предоставляя функции, такие как интерактивный просмотр различий, совместное использование контекста выделения и многое другое.

Поддерживаемые IDE

Плагин Claude Code работает с большинством JetBrains IDE, включая:

• IntelliJ IDEA
• PyCharm
• Android Studio
• WebStorm
• PhpStorm
• GoLand

Функции

• Быстрый запуск: используйте Cmd+Esc (Mac) или Ctrl+Esc (Windows/Linux) для открытия Claude Code непосредственно из редактора, или нажмите кнопку Claude Code в интерфейсе
• Просмотр различий: Claude Code открывает изменения кода в средстве просмотра различий IDE вместо терминала; измените это с помощью параметра Diff tool в /config
• Контекст выделения: текущее выделение или вкладка в IDE автоматически передаются в Claude Code. Правила отказа Read блокируют это совместное использование для соответствующих файлов
• Ярлыки ссылок на файлы: используйте Cmd+Option+K (Mac) или Alt+Ctrl+K (Linux/Windows) для вставки ссылок на файлы, такие как @src/auth.ts#L1-99
• Совместное использование диагностики: Claude читает диагностику проверки IDE, такую как ошибки lint и синтаксиса, вызывая инструмент getDiagnostics; Claude Code не запрашивает диагностику у плагина самостоятельно после редактирования

Установка

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

Если claude установлен в месте, которое ваша IDE не может найти, установите полный путь в параметре Claude command плагина.

Claude Code работает с любой платной подпиской Claude (Pro, Max, Team или Enterprise) или с учетной записью Claude Console, и API ключ не требуется. Вам будет предложено войти при первом запуске claude.

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

Из вашей IDE

Запустите claude из встроенного терминала вашей IDE, и все функции интеграции будут активны.

Из внешних терминалов

Используйте команду /ide в любом внешнем терминале для подключения Claude Code к вашей JetBrains IDE и активации всех функций:

claude

/ide

Когда соединение установлено успешно, Claude Code подтверждает это сообщением вроде Connected to IntelliJ IDEA. Если Claude Code обнаружит запущенную IDE, в которой нет плагина, /ide установит плагин для вас и попросит перезагрузить IDE.

Если вы хотите, чтобы Claude имел доступ к тем же файлам, что и ваша IDE, запустите Claude Code из того же каталога, что и корень проекта вашей IDE.

Конфигурация

Параметры Claude Code

Настройте интеграцию IDE через параметры Claude Code:

1. Запустите claude
2. Введите команду /config
3. Установите инструмент diff на auto для отображения различий в IDE, или terminal для сохранения их в терминале

Запись Diff tool появляется в /config только когда Claude Code подключен к IDE, поэтому запустите claude из терминала JetBrains или сначала запустите /ide из внешнего терминала. Дополнительную информацию см. в разделе diffTool.

Параметры плагина

Настройте плагин Claude Code, перейдя в Settings → Tools → Claude Code [Beta]:

Общие параметры

• Claude command: укажите пользовательскую команду для запуска Claude, например claude, /usr/local/bin/claude или npx @anthropic-ai/claude-code
• Suppress notification for when Claude Command is 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:

1. Перейдите в Settings → Tools → Terminal
2. Либо:
   • Снимите флажок "Move focus to the editor with Escape", либо
   • Нажмите "Configure terminal keybindings" и удалите ярлык "Switch focus to Editor"
3. Примените изменения

Это позволит клавише ESC правильно прерывать операции Claude Code.

Специальные конфигурации

Удаленная разработка

Конфигурация WSL

Если вы используете Claude Code на WSL2 с JetBrains IDE и видите "No available IDEs detected", причина обычно заключается в NAT-сетевом взаимодействии WSL2 или брандмауэре Windows, блокирующем соединение между WSL2 и IDE, работающей на хосте Windows. WSL1 использует сеть хоста напрямую и не подвержена этой проблеме.

Разрешить трафик WSL2 через брандмауэр Windows

Это рекомендуемое исправление, так как оно сохраняет ваш существующий режим сетевого взаимодействия WSL2.

hostname -I

New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

Переключите WSL2 на зеркальное сетевое взаимодействие

Зеркальное сетевое взаимодействие требует Windows 11 22H2 или более поздней версии. Если вы используете Windows 10, используйте вместо этого правило брандмауэра выше.

Добавьте это в .wslconfig в вашем каталоге пользователя Windows:

[wsl2]
networkingMode=mirrored

Затем перезагрузите WSL с помощью wsl --shutdown из PowerShell.

Устранение неполадок

Плагин не работает

Если плагин установлен, но функции Claude Code не отображаются в вашей IDE:

• Убедитесь, что вы запускаете Claude Code из корневого каталога проекта
• Проверьте, что плагин JetBrains включен в параметрах IDE
• Полностью перезагрузите IDE (может потребоваться сделать это несколько раз)
• Для Remote Development убедитесь, что плагин установлен на удаленном хосте

IDE не обнаружена

Если команда /ide показывает "No available IDEs detected":

• Проверьте, что плагин установлен и включен
• Полностью перезагрузите IDE
• Если вы ожидали автоматического подключения без запуска /ide, проверьте, что вы запустили claude из встроенного терминала IDE
• Для пользователей WSL см. конфигурацию WSL выше

Команда не найдена

Если нажатие на значок Claude показывает "command not found":

1. Проверьте, что Claude Code установлен, запустив claude --version в терминале
2. Настройте путь команды Claude в параметрах плагина
3. Для пользователей WSL используйте формат команды WSL, упомянутый в разделе конфигурации

Соображения безопасности

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

При запуске в JetBrains IDEs учитывайте:

• Использование режима Manual для редактирования, потому что acceptEdits и режим auto оба одобряют редактирования внутри вашего рабочего каталога без запроса, кроме как в защищённых путях
• Особую осторожность, чтобы убедиться, что Claude используется только с доверенными подсказками
• Осведомленность о том, какие файлы Claude Code имеет доступ для изменения

Для проблем с установкой или входом в Claude Code вне IDE см. Устранение неполадок установки и входа.

Встроенный MCP сервер IDE

Когда плагин активен, он запускает локальный MCP сервер, к которому CLI подключается автоматически. Это то, как CLI открывает различия в собственном средстве просмотра различий IDE, читает вашу текущую выделенную область для упоминаний @ и позволяет Claude читать диагностику проверки.

Сервер называется ide и скрыт от /mcp, потому что нечего конфигурировать. Однако если ваша организация использует PreToolUse hook для создания списка разрешенных MCP инструментов, вам нужно знать, что он существует.

Контекст выделения и открытого файла. При подключении CLI включает вашу текущую выделенную область редактора и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку ⧉ Selected N lines from <file> когда это происходит. Чтобы исключить конфиденциальный файл, такой как .env, добавьте Read правило отказа для его пути. Соответствующее правило отказа предотвращает как выделенный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

Транспорт и аутентификация. Сервер прослушивает порт, назначенный ОС, и порт не настраивается. Транспорт — это незашифрованный ws://; на loopback любой процесс, который может захватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту от локального злоумышленника. Каждый запуск IDE генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в ~/.claude/ide/<port>.lock, и CLI должен представить его как заголовок X-Claude-Code-Ide-Authorization для подключения. Если установлена переменная CLAUDE_CONFIG_DIR, файл блокировки записывается в $CLAUDE_CONFIG_DIR/ide/ вместо этого.

Инструменты, предоставленные модели. Сервер размещает несколько инструментов, но только один видим модели. Остальные — это внутренний RPC, который CLI использует для своего собственного пользовательского интерфейса, такой как открытие различий и чтение выделений, и они отфильтровываются перед тем, как список инструментов достигает Claude.

Плагин JetBrains не предоставляет инструмент выполнения кода модели.

Интерфейс прослушивания. Какой сетевой интерфейс использует сервер, контролируется параметром Accept connections from all network interfaces в разделе Settings → Tools → Claude Code [Beta] → Networking (Advanced). Если параметр отключен, сервер прослушивает только 127.0.0.1 и недоступен с других хостов. Если он включен, порт доступен из вашей локальной сети. Параметр существует для случаев, когда CLI не может достичь IDE через loopback, например WSL2 с сетью NAT по умолчанию или удаленная установка IDE; см. Конфигурация WSL для этого сценария.