Использование Claude Code в JetBrains IDE

Claude Code глубоко интегрируется с JetBrains IDE через специализированный плагин, предоставляя мощные возможности, такие как интерактивный просмотр различий и обмен контекстом выделенного кода, бесшовно встраивая программирование с поддержкой ИИ в ваш рабочий процесс разработки.

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

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

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

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

Характеристика Описание
Быстрый старт Использование на MacCmd+Esc, использование на Windows/LinuxCtrl+Esc, открывать Claude Code напрямую из редактора
Просмотр Diff Изменения кода отображаются непосредственно в Diff-просмотрщике IDE, а не в терминале
Обмен контекстом выделения Текущий выделенный код или содержимое вкладки в IDE автоматически передаётся в Claude Code
Горячая клавиша для ссылки на файл Использование на MacCmd+Option+K, в Linux/Windows используйтеAlt+Ctrl+K, быстро вставлять, например@src/auth.ts#L1-99ссылки на файлы в виде
Обмен диагностической информацией Диагностическая информация, такая как ошибки линтера и синтаксические ошибки в IDE, автоматически передаётся Claude, пока вы работаете

Установка и настройка

Шаг 1: Установка предварительных требований

Перед установкой плагина JetBrains необходимо сначала установить Claude Code CLI.

# macOS、Linux、WSL 安装
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell 安装
irm https://claude.ai/install.ps1 | iex

# 验证安装
claude --version

Подробные инструкции по установке см. вРуководство по установке Claude Code。

Шаг 2: Установка плагина JetBrains

  1. Откройте вашу JetBrains IDE
  2. Перейдите вНастройки → Плагины
  3. Переключитесь на вкладкуMarketplacetab
  4. НайдитеClaude Code
  5. НажмитеУстановить
  6. После завершения установкиПерезапустите IDE

Шаг 3: Запуск и подключение Claude Code

Запуск из встроенного терминала IDE (рекомендуется)

Выполните следующую команду во встроенном терминале IDE, и все интегрированные функции будут активированы автоматически:

claude

Это экран приветствия. После нажатия Enter можно начать работу:

Подключение из внешнего терминала

Если вы используете внешний терминал, можно использовать/ideкоманду, чтобы подключить Claude Code к вашей JetBrains IDE:

# 先启动 Claude Code
claude

# 然后执行 /ide 命令连接 IDE
/ide

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

Шаг 4: Настройка Claude Code

Настройка инструмента Diff

После запуска Claude Code задайте режим отображения Diff, выполнив следующие шаги:

# 启动 Claude Code
claude

# 进入配置
/config

Установите инструмент diff вauto, изменения кода будут отображаться непосредственно в окне просмотра Diff в IDE; установите вterminalто оставьте его отображаться в терминале.

Настройка параметров плагина

Перейдите вНастройки → Инструменты → Claude Code [Beta], там можно настроить следующие параметры:

  • Команда Claude (путь к команде Claude): настройте команду для запуска Claude, напримерclaude、/usr/local/bin/claudeилиnpx @anthropic-ai/claude-code
  • Не показывать уведомление об отсутствии команды Claude: отключить запрос уведомления, когда команда Claude не найдена
  • Включить использование Option+Enter для многострочных запросов(только macOS): если включено,Option+Enterможно вставлять переносы строк в поле ввода запроса
  • Включить автоматические обновления: автоматически проверять и устанавливать обновления плагинов, применяется после перезапуска

💡 Пользователям WSL: задайте команду Claude какwsl -d Ubuntu -- bash -lic "claude"(заменитеUbuntuна название вашего дистрибутива WSL).

Настройте клавишу ESC (необязательно)

ЕслиESCклавиша не может прервать операции Claude Code, выполните следующие шаги для исправления:

  1. Перейдите вНастройки → Инструменты → Терминал
  2. Снимите флажок"Переместить фокус в редактор с помощью Escape", или нажмите"Настроить сочетания клавиш терминала"и удалите"Переключить фокус в редактор"сочетание клавиш
  3. Применить изменения


Настройка особого сценария

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

При использовании JetBrains Remote Development плагин необходимо установить наудаленном хосте, а не на локальной клиентской машине.

Путь операции:Настройки → Плагины (хост)

Настройка WSL2

Если вы используете Claude Code в среде WSL2 и сталкиваетесь с"Не обнаружено доступных IDE"ошибкой, обычно это происходит потому, что NAT-сеть WSL2 или брандмауэр Windows блокирует соединение.

Вариант 1: добавьте правило брандмауэра Windows (рекомендуется)

# 第一步:在 WSL 中查看 IP 地址
hostname -I
# 例如输出 172.21.123.45,子网为 172.21.0.0/16
# 第二步:以管理员身份打开 PowerShell,创建防火墙规则(根据你的子网调整 IP 范围)
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

Затем перезапустите IDE и Claude Code, чтобы изменения вступили в силу.

Вариант 2: Переключить WSL2 в режим зеркальной сети(требуется Windows 11 22H2 или более поздняя версия)

В пользовательском каталоге Windows,.wslconfigдобавьте в файл:

[wsl2]
networkingMode=mirrored

Затем выполните в PowerShellwsl --shutdownПерезапустите WSL.


Устранение распространённых проблем

Функции плагина не появляются после установки

  • Убедитесь, что Claude Code изкорневого каталога проектазапущен
  • Проверьте, что плагин JetBrains включён в настройках IDE
  • Попробуйтеполностью перезапустить IDE(может потребоваться несколько перезапусков)
  • В сценариях удалённой разработки убедитесь, что плагин установлен на удалённом хосте

Сообщение: "Доступные IDE не обнаружены"

  • Убедитесь, что плагин установлен и включён
  • Полностью перезапустите IDE
  • Убедитесь, что Claude Code запускается из встроенного терминала IDE
  • Пользователям WSL, пожалуйста, обратитесь к разделуКонфигурация WSL2section

При нажатии на значок Claude появляется сообщение "command not found"

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