Claude Code отлично работает с любой интегрированной средой разработки (IDE), которая имеет терминал. Просто запустите claude, и вы готовы к работе.

Кроме того, Claude Code предоставляет специальные интеграции для популярных IDE, которые предлагают такие функции, как интерактивный просмотр различий, совместное использование контекста выбора и многое другое. Эти интеграции в настоящее время существуют для:

  • Visual Studio Code (включая популярные форки, такие как Cursor, Windsurf и VSCodium)
  • JetBrains IDEs (включая IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm и GoLand)

​
Функции

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

​
Установка

Чтобы установить Claude Code на VS Code и популярные форки, такие как Cursor, Windsurf и VSCodium:

  1. Откройте VS Code
  2. Откройте встроенный терминал
  3. Запустите claude - расширение установится автоматически

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

​
Из вашей IDE

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

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

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

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

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

Интеграции IDE работают с системой конфигурации Claude Code:

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

​
Настройки плагина JetBrains

Вы можете настроить параметры плагина Claude Code, перейдя в Settings → Tools → Claude Code [Beta]. Вот доступные настройки:

​
Общие настройки

  • Команда Claude: Укажите пользовательскую команду для запуска Claude (например, claude, /usr/local/bin/claude или npx @anthropic/claude) при нажатии на иконку Claude
  • Подавить уведомление о том, что команда Claude не найдена: Пропускать уведомления о том, что команда Claude не найдена
  • Включить использование Option+Enter для многострочных подсказок (только macOS): Когда включено, Option+Enter вставляет новые строки в подсказки Claude Code. Отключите это, если у вас возникают проблемы с неожиданным захватом клавиши Option (требует перезапуска терминала)
  • Включить автоматические обновления: Автоматически проверять и устанавливать обновления плагина (применяется при перезапуске)

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

​
Конфигурация клавиши 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.

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

​
Расширение VS Code не устанавливается

  • Убедитесь, что вы запускаете Claude Code из встроенного терминала VS Code
  • Убедитесь, что CLI, соответствующий вашей IDE, установлен:
    • Для VS Code: команда code должна быть доступна
    • Для Cursor: команда cursor должна быть доступна
    • Для Windsurf: команда windsurf должна быть доступна
    • Для VSCodium: команда codium должна быть доступна
    • Если не установлено, используйте Cmd+Shift+P (Mac) или Ctrl+Shift+P (Windows/Linux) и найдите “Shell Command: Install ‘code’ command in PATH” (или эквивалент для вашей IDE)
  • Проверьте, что VS Code имеет разрешение на установку расширений

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

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

Если вы используете WSL или WSL2 и IDE не обнаруживается, см. наше руководство по устранению неполадок WSL2 для настройки сети и параметров брандмауэра.

Для дополнительной помощи обратитесь к нашему руководству по устранению неполадок.

​
Безопасность

Когда Claude Code работает в IDE с включенными разрешениями автоматического редактирования, он может изменять файлы конфигурации IDE, которые могут автоматически выполняться вашей IDE. Это может увеличить риск запуска Claude Code в режиме автоматического редактирования и позволить обойти подсказки разрешений Claude Code для выполнения bash. При работе в IDE рассмотрите возможность включения функций безопасности IDE (таких как VS Code Restricted Mode), использования режима ручного утверждения для редактирования или проявления особой осторожности, чтобы убедиться, что Claude используется только с доверенными подсказками.