# Расширение Claude Code для VS Code: установка, diff

URL: https://agentvera.dev/ru/blog/claude-code-vs-code/ · Опубликовано: 2026-10-23

Установите расширение Claude Code для VS Code, используйте контекст выделения и просмотр diff, подберите настройки, решите типичные проблемы и подключите JetBrains.

**Коротко:**

- Официальное расширение Claude Code (anthropic.claude-code) требует VS Code 1.94.0 или новее и тариф Pro, Max, Team или Enterprise либо аккаунт Console.
- Установка расширения не добавляет claude в PATH; чтобы работать в терминале, установите отдельный CLI. История диалогов у них общая.
- В IDE JetBrains плагин Claude Code [Beta] запускает CLI claude в терминале IDE, поэтому CLI нужно установить заранее.

Расширение 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](https://code.claude.com/docs/en/vs-code "Claude Code в VS Code") и [JetBrains](https://code.claude.com/docs/en/jetbrains "Claude Code в IDE JetBrains").

## Установка расширения

1. Откройте VS Code и нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux).
2. Найдите **Claude Code** и установите расширение от Anthropic.
3. Если оно не появилось сразу, перезапустите VS Code или выполните **Developer: Reload Window** в палитре команд.
4. Откройте панель и войдите в аккаунт, когда она попросит.

Требования:

| Требование | Подробности |
| --- | --- |
| 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](https://code.claude.com/docs/en/setup "Установка Claude Code").

Когда установлены оба, у них общая история диалогов. Выполните `claude --resume` в терминале, чтобы продолжить диалог, начатый в панели.

Чтобы запустить CLI внутри VS Code, нажмите `` Ctrl+` `` (на Mac `` Cmd+` ``) и выполните `claude`. Он автоматически подключается к IDE для diff и диагностики. Из внешнего терминала выполните `/ide` внутри Claude Code, чтобы подключить его к VS Code.

Если вам нравится интерфейс терминала, но хочется видеть его на месте панели, включите настройку **Use Terminal** (`claudeCode.useTerminal`).

Практическое правило: панель удобна, когда хочется кликать по diff и читать планы как документы. CLI — когда нужны все слэш-команды, режим shell через `!` и [сочетания клавиш из нашей шпаргалки](/ru/blog/claude-code-commands-cheat-sheet/ "Шпаргалка по командам Claude Code").

## Контекст выделения и @-упоминания

Расширение добавляет к сообщению файл, открытый в редакторе, и 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-агентами](/ru/blog/best-ai-coding-cli-tools/ "Лучшие CLI-инструменты для AI-программирования"), и теряете из виду, какому из них нужен ответ.

Для этого и создан [AgentVera](/ru/agents/claude-code/ "Claude Code в AgentVera"). Это настольное приложение для macOS, Windows и Linux, которое запускает каждого CLI-агента в отдельной панели, в сетке на проект. Это не редактор, и он не заменяет VS Code. Многие держат открытыми оба.

- **Много агентов в одном окне.** [Рабочая область](/ru/features/workspace/ "Рабочая область") раскладывает агентов в сетки до 5×4. [Групповой вид](/ru/features/group-view/ "Групповой вид") считает агентов, которые работают, ждут ответа или ждут подтверждения, с кнопками Approve и Reject на каждой карточке.
- **Diff без переключения окон.** В инструментах [редактора и терминала](/ru/features/editor-and-terminal/ "Редактор и терминал") есть редактор файлов и вкладка Changes с diff между HEAD и рабочим деревом, в унифицированном виде или бок о бок. [Git и GitHub](/ru/features/git-and-github/ "Git и GitHub") добавляют worktree и PR.
- **Второе мнение.** [Автоматическое код-ревью](/ru/features/code-review/ "Автоматическое код-ревью"): выбранная вами модель Claude проверяет код агента, когда его ход заканчивается, со ссылками вида файл:строка.

Если вы настраиваете параллельную работу, следующий шаг — [git worktree для параллельных агентов](/ru/blog/git-worktree-parallel-agents/ "Git worktree для параллельных агентов").

Чтобы попробовать AgentVera, начните с [главной страницы](/ru/ "AgentVera").

## Частые вопросы

**Как установить расширение Claude Code в VS Code?** Откройте панель расширений через Cmd+Shift+X или Ctrl+Shift+X, найдите Claude Code и установите расширение от Anthropic (ID anthropic.claude-code). Нужны VS Code 1.94.0 или новее и тариф Pro, Max, Team или Enterprise либо аккаунт Console.

**Входит ли CLI Claude Code в расширение для VS Code?** Расширение содержит собственную копию CLI для панели чата, но не добавляет claude в PATH. Чтобы запускать claude во встроенном терминале, один раз установите отдельный CLI. История диалогов у них общая, поэтому claude --resume находит сессии расширения.

**Работает ли расширение Claude Code в Cursor?** Да. В документации VS Code есть ссылка Install for Cursor, а в других форках VS Code расширение можно поставить из реестра Open VSX. Если в редакторе расширение не устанавливается, запускайте claude во встроенном терминале.

**Почему я не вижу значок Spark Claude Code?** Значок появляется на панели редактора только при открытом файле. Проверьте, что VS Code не старше 1.94.0, рабочая область доверенная и нет конфликтующих AI-расширений, затем выполните Developer: Reload Window. Пункт Claude Code в строке состояния работает и без открытого файла.

**Есть ли плагин Claude Code для IDE JetBrains?** Да. Плагин Claude Code [Beta] из JetBrains Marketplace работает с IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm и Android Studio. Он запускает CLI в терминале IDE, поэтому CLI должен быть установлен, и добавляет diff в IDE и передачу выделения.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/