Расширение Claude Code для VS Code — официальное расширение Anthropic (ID anthropic.claude-code), которое открывает Claude Code в графической панели внутри VS Code. Вы устанавливаете его из панели расширений, входите в аккаунт, и после этого Claude видит открытый файл и выделение, показывает предлагаемые правки в виде diff «бок о бок», которые можно принять или отклонить, и делит историю с CLI. Нужны VS Code 1.94.0 или новее и платный тариф Claude либо аккаунт Console. Если вам ближе терминал, можно запускать CLI claude во встроенном терминале VS Code и сохранить diff в IDE.
В этом руководстве: установка, расширение и CLI, просмотр diff, контекст выделения, настройки, которые стоит менять, типичные проблемы и короткий раздел про JetBrains. Всё здесь основано на официальной документации: VS Code и JetBrains.
Установка расширения
- Откройте VS Code и нажмите
Cmd+Shift+X(Mac) илиCtrl+Shift+X(Windows/Linux). - Найдите Claude Code и установите расширение от Anthropic.
- Если оно не появилось сразу, перезапустите VS Code или выполните Developer: Reload Window в палитре команд.
- Откройте панель и войдите в аккаунт, когда она попросит.
Требования:
| Требование | Подробности |
|---|---|
| VS Code | 1.94.0 или новее |
| Аккаунт | Тариф Pro, Max, Team или Enterprise либо аккаунт Console |
| Рабочая область | Доверенная (в Restricted Mode расширение не работает) |
Cursor и другие форки VS Code
В документации есть прямая ссылка Install for Cursor, так что Cursor поддерживается. В других форках VS Code расширение можно установить из реестра Open VSX. Если редактор вообще не позволяет его поставить, откройте встроенный терминал и запустите claude.
Как открыть Claude Code
Есть четыре способа:
- Значок Spark на панели редактора, справа вверху. Виден только при открытом файле.
- Список сессий на боковой панели Activity Bar слева.
- Палитра команд (
Cmd+Shift+P/Ctrl+Shift+P): введите «Claude Code» и выберите Open in New Tab. - Строка состояния: нажмите ✻ Claude Code в правом нижнем углу. Работает и без открытого файла.
Панель можно перетащить во вторичную боковую панель (справа), основную боковую панель (слева) или в область редактора как вкладку. В документации советуют держать основную сессию в боковой панели, а побочные задачи — во вкладках.
Расширение или CLI во встроенном терминале?
Это один и тот же Claude Code. Отличаются интерфейс и несколько возможностей.
| Возможность | CLI | Расширение для VS Code |
|---|---|---|
| Команды и skills | Все | Часть (введите /, чтобы увидеть список) |
| Настройка MCP-серверов | Да | Да, через /mcp в панели |
| Контрольные точки | Да | Да |
Быстрый вызов shell через ! | Да | Нет |
| Автодополнение по Tab | Да | Нет |
Подвох, на котором спотыкаются многие: установка расширения не добавляет claude в PATH. Расширение содержит собственную копию CLI для своей панели. Чтобы набирать claude в терминале, нужна отдельная установка CLI.
Когда установлены оба, у них общая история диалогов. Выполните claude --resume в терминале, чтобы продолжить диалог, начатый в панели.
Чтобы запустить CLI внутри VS Code, нажмите Ctrl+` (на Mac Cmd+`) и выполните claude. Он автоматически подключается к IDE для diff и диагностики. Из внешнего терминала выполните /ide внутри Claude Code, чтобы подключить его к VS Code.
Если вам нравится интерфейс терминала, но хочется видеть его на месте панели, включите настройку Use Terminal (claudeCode.useTerminal).
Практическое правило: панель удобна, когда хочется кликать по diff и читать планы как документы. CLI — когда нужны все слэш-команды, режим shell через ! и сочетания клавиш из нашей шпаргалки.
Контекст выделения и @-упоминания
Расширение добавляет к сообщению файл, открытый в редакторе, и Claude видит выделенный вами текст. Вставлять код в промпт не нужно.
Option+K(Mac) /Alt+K(Windows/Linux) вставляет ссылку на текущий файл и выделение, например@auth.ts#5-10. Фокус должен быть в редакторе.@в поле промпта упоминает любой файл или папку.@terminal:nameссылается на вывод терминала.Cmd+Esc/Ctrl+Escпереключает фокус между редактором и Claude.
О приватности: выделенный текст не отправляется из файлов, подпадающих под files.exclude или search.exclude, и из файлов в gitignore, пока включён respectGitIgnore. Это относится к панели чата. Если нужно отправлять только выделение, а не весь открытый файл, выключите attachOpenFile.
Просмотр diff
Когда Claude хочет изменить файл в режиме Manual, VS Code показывает diff предлагаемой правки «бок о бок». Её можно принять, отклонить или отредактировать предложенный текст перед принятием. В свежих версиях можно также принимать и отклонять отдельные изменения внутри одной правки командами Accept Change at Cursor и Reject Change at Cursor в палитре команд. У очень больших правок (больше 100 изменений) кнопок для отдельных изменений нет.
Как часто вы видите diff, зависит от режима разрешений в поле промпта:
| Режим | Что происходит |
|---|---|
| Manual | Claude спрашивает перед каждой правкой и показывает diff |
| Edit automatically | Правки применяются без вопросов |
| Plan | Claude пишет план как Markdown-документ, который можно комментировать, и ждёт |
| Auto | Claude решает сам с проверкой безопасности; в свежих версиях это режим по умолчанию |
Поверх этого работают контрольные точки. Наведите курсор на сообщение, чтобы увидеть кнопку отката: Rewind code to here, Fork conversation from here или оба действия сразу.
Настройки, которые стоит изменить
Откройте настройки VS Code (Cmd+, / Ctrl+,) и перейдите в Extensions > Claude Code. Общие настройки, такие как разрешённые команды, hooks и MCP-серверы, лучше держать в ~/.claude/settings.json, который читает и CLI.
| Настройка | По умолчанию | Зачем менять |
|---|---|---|
useTerminal | false | Открывать интерфейс в стиле CLI вместо панели чата |
initialPermissionMode | не задано | Запускать новые чаты в default, plan, acceptEdits или bypassPermissions |
preferredLocation | panel | sidebar оставляет Claude закреплённым справа |
attachOpenFile | true | Выключите, чтобы отправлялось только выделение |
autosave | true | Сохраняет файлы перед тем, как Claude их читает или пишет |
useCtrlEnterToSend | false | Отправка по Ctrl/Cmd+Enter, а Enter переводит строку |
respectGitIgnore | true | Не включать файлы из gitignore в поиск и контекст выделения |
environmentVariables | [] | Переменные окружения только для процесса Claude |
allowDangerouslySkipPermissions | false | Добавляет Bypass permissions в меню режимов. Только для песочниц |
initialPermissionMode читается только из пользовательских настроек, а не из настроек рабочей области. Добавьте "$schema": "https://json.schemastore.org/claude-code-settings.json" в settings.json, чтобы работало автодополнение.
Несколько диалогов одновременно
Open in New Tab (Cmd+Shift+Esc / Ctrl+Shift+Esc) и Open in New Window запускают дополнительные диалоги со своей историей. Цветная точка на значке spark во вкладке показывает статус: синяя — ожидается запрос разрешения, оранжевая — Claude закончил, пока вкладка была скрыта. Список сессий умеет группировать сессии и фильтровать их по Needs input, Working или Completed.
Решение типичных проблем
| Проблема | Решение |
|---|---|
| Расширение не устанавливается | Проверьте, что VS Code 1.94.0+, что ему разрешено ставить расширения, или установите со страницы Marketplace |
| Нет значка Spark | Откройте файл (одной папки недостаточно), доверьте рабочую область, отключите конфликтующие AI-расширения, перезагрузите окно |
Cmd+Esc ничего не делает на macOS | В macOS Tahoe это сочетание занято Game Overlay. Отключите его в Keyboard Shortcuts → Game Controllers или переназначьте Claude Code: Focus input |
| «Not logged in · Please run /login» | Перезагрузите окно и войдите снова |
ANTHROPIC_API_KEY не подхватывается | Запускайте VS Code из терминала командой code ., чтобы он унаследовал окружение |
claude не найден в терминале | Установите отдельный CLI; расширение не добавляет его в PATH |
| Claude не отвечает | Проверьте соединение, начните новый диалог, затем попробуйте claude в терминале, чтобы увидеть более понятную ошибку |
| Нужны логи | Выполните Claude Code: Show Logs в палитре команд |
Claude Code в IDE JetBrains
Плагин Claude Code [Beta] из JetBrains Marketplace поддерживает IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm и GoLand. В отличие от расширения для VS Code, он запускает CLI claude в терминале IDE, поэтому CLI нужно установить заранее. Если видите «Cannot launch Claude Code», значит claude нет в PATH.
Что вы получаете:
Cmd+Esc/Ctrl+Escоткрывает Claude Code из редактора.Cmd+Option+K/Alt+Ctrl+Kвставляет ссылку на файл, например@src/auth.ts#L1-99.- Предлагаемые изменения открываются во встроенном просмотрщике diff IDE. Задайте Diff tool значение
autoилиterminalв/config. - Ваше выделение и диагностика IDE (ошибки линтера и типов) передаются Claude.
- Из внешнего терминала выполните
/ide, чтобы подключиться.
Два совета из документации: если Esc не прерывает Claude, откройте Settings → Tools → Terminal и снимите флажок «Move focus to the editor with Escape». В WSL задайте в плагине команду Claude wsl -d Ubuntu -- bash -lic "claude", а если видите «No available IDEs detected», добавьте правило брандмауэра или переключите WSL на mirrored networking.
Когда нужно отдельное приложение для множества агентов
Расширение построено вокруг одного окна редактора и нескольких диалогов. Для большинства дней этого хватает. Сложнее становится, когда вы запускаете четырёх-пятерых агентов одновременно на разных ветках или смешиваете Claude Code с Codex и другими CLI-агентами, и теряете из виду, какому из них нужен ответ.
Для этого и создан AgentVera. Это настольное приложение для macOS, Windows и Linux, которое запускает каждого CLI-агента в отдельной панели, в сетке на проект. Это не редактор, и он не заменяет VS Code. Многие держат открытыми оба.
- Много агентов в одном окне. Рабочая область раскладывает агентов в сетки до 5×4. Групповой вид считает агентов, которые работают, ждут ответа или ждут подтверждения, с кнопками Approve и Reject на каждой карточке.
- Diff без переключения окон. В инструментах редактора и терминала есть редактор файлов и вкладка Changes с diff между HEAD и рабочим деревом, в унифицированном виде или бок о бок. Git и GitHub добавляют worktree и PR.
- Второе мнение. Автоматическое код-ревью: выбранная вами модель Claude проверяет код агента, когда его ход заканчивается, со ссылками вида файл:строка.
Если вы настраиваете параллельную работу, следующий шаг — git worktree для параллельных агентов.
Чтобы попробовать AgentVera, начните с главной страницы.