> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JetBrains IDEs

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

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

<h2 id="supported-ides">
  Поддерживаемые IDE
</h2>

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

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

<h2 id="features">
  Функции
</h2>

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

<h2 id="installation">
  Установка
</h2>

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

<Steps>
  <Step title="Установите Claude Code CLI">
    Следуйте [руководству по быстрому старту](/ru/quickstart) для установки CLI, если вы еще этого не сделали. Плагин показывает уведомление "Cannot launch Claude Code" (Не удается запустить Claude Code), когда `claude` отсутствует в вашем PATH.
  </Step>

  <Step title="Установите плагин JetBrains">
    Установите [плагин Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) из JetBrains Marketplace и перезагрузите вашу IDE.
  </Step>
</Steps>

Если `claude` установлен в месте, которое ваша IDE не может найти, установите полный путь в [параметре Claude command](#general-settings) плагина.

Claude Code работает с любой платной подпиской Claude (Pro, Max, Team или Enterprise) или с учетной записью Claude Console, и API ключ не требуется. Вам будет предложено [войти](/ru/authentication#log-in-to-claude-code) при первом запуске `claude`.

<Note>
  После установки плагина может потребоваться полностью перезагрузить IDE, чтобы он вступил в силу.
</Note>

<h2 id="usage">
  Использование
</h2>

<h3 id="from-your-ide">
  Из вашей IDE
</h3>

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

<h3 id="from-external-terminals">
  Из внешних терминалов
</h3>

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

```bash theme={null}
claude
```

```text theme={null}
/ide
```

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

<h2 id="configuration">
  Конфигурация
</h2>

<h3 id="claude-code-settings">
  Параметры Claude Code
</h3>

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

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

<h3 id="plugin-settings">
  Параметры плагина
</h3>

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

<h4 id="general-settings">
  Общие параметры
</h4>

* **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**: автоматически проверять и устанавливать обновления плагина, применяемые при перезагрузке

<Tip>
  Для пользователей WSL: установите `wsl -d Ubuntu -- bash -lic "claude"` в качестве команды Claude (замените `Ubuntu` на имя вашего дистрибутива WSL)
</Tip>

<h4 id="esc-key-configuration">
  Конфигурация клавиши ESC
</h4>

Если клавиша 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.

<h2 id="special-configurations">
  Специальные конфигурации
</h2>

<h3 id="remote-development">
  Удаленная разработка
</h3>

<Warning>
  При использовании JetBrains Remote Development необходимо установить плагин на удаленном хосте через **Settings → Plugin (Host)**.
</Warning>

Плагин должен быть установлен на удаленном хосте, а не на вашей локальной клиентской машине.

<h3 id="wsl-configuration">
  Конфигурация WSL
</h3>

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

<h4 id="allow-wsl2-traffic-through-windows-firewall">
  Разрешить трафик WSL2 через брандмауэр Windows
</h4>

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

<Steps>
  <Step title="Найдите ваш IP-адрес WSL2">
    Из вашей оболочки WSL запустите:

    ```bash theme={null}
    hostname -I
    ```

    Запомните подсеть, например `172.21.123.45` находится в `172.21.0.0/16`.
  </Step>

  <Step title="Создайте правило брандмауэра">
    Откройте PowerShell от имени администратора и запустите следующее, отрегулировав диапазон IP в соответствии с вашей подсетью:

    ```powershell theme={null}
    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
    ```
  </Step>

  <Step title="Перезагрузите вашу IDE и Claude Code">
    Закройте и снова откройте оба приложения, чтобы новое правило вступило в силу.
  </Step>
</Steps>

<h4 id="switch-wsl2-to-mirrored-networking">
  Переключите WSL2 на зеркальное сетевое взаимодействие
</h4>

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

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

```ini theme={null}
[wsl2]
networkingMode=mirrored
```

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

<h2 id="troubleshooting">
  Устранение неполадок
</h2>

<h3 id="plugin-not-working">
  Плагин не работает
</h3>

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

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

<h3 id="ide-not-detected">
  IDE не обнаружена
</h3>

Если запуск `claude` показывает "No available IDEs detected":

* Проверьте, что плагин установлен и включен
* Полностью перезагрузите IDE
* Проверьте, что вы запускаете Claude Code из встроенного терминала
* Для пользователей WSL см. [конфигурацию WSL](#wsl-configuration) выше

<h3 id="command-not-found">
  Команда не найдена
</h3>

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

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

<h2 id="security-considerations">
  Соображения безопасности
</h2>

Когда Claude Code работает в JetBrains IDE в режиме разрешения [`acceptEdits`](/ru/permission-modes#auto-approve-file-edits-with-acceptedits-mode), он может быть в состоянии изменять файлы конфигурации IDE, которые могут быть автоматически выполнены вашей IDE. Это может увеличить риск запуска Claude Code в режиме `acceptEdits` и позволить обойти подсказки разрешений Claude Code для выполнения bash.

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

* Использование режима ручного одобрения для редактирования
* Особую осторожность, чтобы убедиться, что Claude используется только с доверенными подсказками
* Осведомленность о том, какие файлы Claude Code имеет доступ для изменения

Для проблем с установкой или входом в Claude Code вне IDE см. [Устранение неполадок установки и входа](/ru/troubleshoot-install).
