Claude Code в VS Code: как установить и пользоваться расширением

Расширение Claude Code для VS Code открывает панель чата прямо в редакторе. Claude видит открытый файл и выделенный код, а в режиме Manual показывает предложенные правки в привычном окне сравнения до того, как их применить. В документации Anthropic расширение названо рекомендуемым способом работать с Claude Code в VS Code.

Ниже весь путь по шагам: что подготовить, как поставить и войти, как устроена ежедневная работа и что делать, если панель не появилась. Версии, команды и сочетания клавиш я сверил с документацией Anthropic и страницей расширения в Marketplace 25 сентября 2026 года. Расширение обновляется часто, поэтому у некоторых функций указываю минимальную версию Claude Code: без неё функция просто не появится.

Что нужно перед установкой#

• VS Code 1.94.0 или новее. Такой минимум указан в документации Anthropic и в манифесте расширения. На странице расширения в Marketplace в разделе Requirements стоит VS Code 1.98.0, поэтому проще сразу обновиться до 1.98 и не гадать. Свою версию смотри в Help → About на Windows и Linux или в Code → About Visual Studio Code на Mac.
• Платный аккаунт. Подходит любая платная подписка Claude (Pro, Max, Team или Enterprise) либо аккаунт Claude Console с оплатой по факту использования, API-ключ не нужен. Бесплатный план claude.ai доступа к Claude Code не даёт.

Само расширение в Marketplace помечено как бесплатное. Платишь за доступ к Claude, а не за плагин.

Если ты в России, сначала реши вопрос с аккаунтом и оплатой. В системных требованиях Claude Code Anthropic указывает поддерживаемые компанией страны. Как с этим живут на практике, подробно разобрано в статье Claude Code в России.

Claude Max за $100 я оплатил из России картой Altyn Wallet, платёж прошёл с первого раза. Ссылка партнёрская, комиссию платит сервис, на цену для тебя это не влияет. Другие способы оплаты разобраны в гайде по картам для зарубежных подписок.

Как установить Claude Code в VS Code#

1. Открой панель расширений: Ctrl+Shift+X на Windows и Linux или Cmd+Shift+X на Mac.
2. Набери в поиске «Claude Code».
3. Выбери Claude Code for VS Code от издателя Anthropic (идентификатор anthropic.claude-code) и нажми Install.
4. Если после установки расширение не появилось, перезапусти VS Code или выполни в палитре команд Developer: Reload Window.

На 25 сентября 2026 года в Marketplace опубликована версия 2.1.282, а издатель Anthropic отмечен там как проверенный. Перед установкой сверь издателя и идентификатор, чтобы поставить именно официальное расширение.

В Cursor расширение ставится так же, для него в документации есть отдельная ссылка установки. В других форках VS Code вроде Kiro или Devin Desktop найди Claude Code в панели расширений или поставь его из реестра Open VSX. Если редактор расширение не принимает совсем, остаётся CLI: поставь его и запускай claude во встроенном терминале.

Как подключить аккаунт и открыть панель#

Claude Code в интерфейсе VS Code обозначен значком-искрой (Spark). Открыть панель можно так:

• кликнуть искру в панели инструментов редактора, в правом верхнем углу (значок виден, только когда открыт какой-нибудь файл);
• кликнуть искру в Activity Bar слева: там список сессий, и этот значок виден всегда;
• открыть палитру команд (Ctrl+Shift+P на Windows и Linux или Cmd+Shift+P на Mac), набрать «Claude Code» и выбрать действие вроде Open in New Tab;
• кликнуть ✻ Claude Code в правом нижнем углу строки состояния, если в настройке preferredLocation выбран sidebar или Claude открыт командой Claude Code: Open in Side Bar; этот путь работает и без открытого файла.

При первом открытии появится экран входа. Нажми Sign in и подтверди авторизацию в браузере. После входа расширение покажет чек-лист Learn Claude Code: его можно пройти кнопками Show me или закрыть крестиком.

Со входом бывают две ситуации, обе описаны в документации:

• Надпись «Not logged in · Please run /login». Расширение само снова открывает экран входа. Если не открыло, выполни Developer: Reload Window.
• ANTHROPIC_API_KEY задан в shell, а расширение всё равно просит войти. VS Code мог не унаследовать переменные окружения. Запусти его из терминала командой code . или войди аккаунтом Claude.

Как пользоваться: запрос, контекст и файлы#

Пиши в поле ввода обычным языком: объясни, как работает функция, найди ошибку, поменяй обработку ответа. Качество ответа сильно зависит от контекста, который ты дал, а в редакторе дать его проще, чем в терминале.

• Выделение. Claude автоматически видит текст, выделенный в редакторе, а внизу поля ввода написано, сколько строк выделено. Alt+K на Windows и Linux или Option+K на Mac вставляет в запрос ссылку вида @app.ts#5-10 с путём и номерами строк.
• Открытый файл. Даже без выделения Claude знает, какой файл сейчас открыт. Если хочешь отправлять только выделенный фрагмент, выключи настройку Attach Open File.
• @-упоминания. Набери @ и часть имени, поиск нечёткий: @auth найдёт и auth.js, и AuthService.ts. Для папки добавь слеш в конце: @src/components/.
• Вывод терминала. @terminal:имя передаёт Claude вывод терминала с этим заголовком, логи копировать руками не нужно.
• Картинки и файлы. Картинку вставь из буфера обмена, файлы перетащи в поле ввода с зажатым Shift.

Shift+Enter переносит строку без отправки. Если привык отправлять по Ctrl+Enter (на Mac Cmd+Enter), включи настройку useCtrlEnterToSend.

Несколько задач можно вести параллельно: Open in New Tab или Open in New Window в палитре команд открывают новый разговор со своей историей. Цветная точка на искре во вкладке подсказывает статус. Синяя значит, что Claude ждёт твоего разрешения, оранжевая значит, что он закончил, пока вкладка была скрыта.

Из некоторых файлов панель не отправляет Claude выделенный текст. Если файл внутри рабочей папки попадает под files.exclude или search.exclude, панель отправит Claude только путь к нему, без выделенного текста; с файлами из .gitignore так же при настройках по умолчанию. Этот фильтр работает только в панели чата, а CLI во встроенном терминале отправляет выделение из любого файла.

Как Claude вносит правки: режимы и диффы#

Текущий режим разрешений виден внизу поля ввода, клик по нему переключает режим. На тарифах Pro, Max и Team стартовый режим по умолчанию Auto.

• Auto. Большинство действий проверяет классификатор, а не ты.
• Manual. Перед правкой файла Claude показывает исходник и предложенную версию бок о бок и спрашивает разрешения. Можно принять, отклонить или написать, что сделать иначе.
• Plan. Claude сначала описывает план и ждёт одобрения. VS Code открывает план как Markdown-документ, где можно оставить комментарии прямо в строках.
• Edit automatically. Правки идут без вопросов.

Большие изменения удобнее разбирать по частям: под каждым фрагментом диффа есть кнопки Accept this change и Reject this change. Для этого нужен Claude Code v2.1.275 или новее, а дифф больше чем на 100 изменений открывается без этих кнопок, только целиком. Если поправишь предложенный текст руками прямо в диффе, Claude узнает об этом и не будет считать, что файл совпадает с его версией.

С чужим или непроверенным кодом Anthropic советует работать в Manual и включать Restricted Mode в VS Code. Причина в том, что в режимах с автоправками Claude может изменить settings.json или tasks.json, а их VS Code способен выполнить автоматически. И на своём проекте первые дни держи Manual, пока не привыкнешь к тому, как Claude режет задачи.

Если правки ушли не туда, наведи курсор на сообщение и нажми кнопку отката. Вариантов три: начать новую ветку разговора с этого места, откатить файлы к этому моменту и оставить историю, или сделать и то и другое сразу.

Для разбора того, что Claude предложил, пригодится скилл Ревьюер кода. Скиллы в панели открываются командой /skills: там же видно, какие из них включены (нужен Claude Code v2.1.280 или новее). Где брать готовые скиллы, рассказано в статье где скачать скиллы для Claude Code.

Горячие клавиши Claude Code в VS Code#

Сначала указано сочетание для Windows и Linux, после косой черты для Mac.

• Ctrl+Esc / Cmd+Esc: переключить фокус между редактором и панелью Claude.
• Ctrl+Shift+Esc / Cmd+Shift+Esc: новый разговор во вкладке редактора.
• Alt+K / Option+K: вставить ссылку на текущий файл и выделение; работает, когда фокус в редакторе.
• Ctrl+Shift+T / Cmd+Shift+T: вернуть последнюю закрытую вкладку сессии Claude. Если последней закрыли обычную вкладку, сработает стандартное повторное открытие редактора.
• Ctrl+Alt+F / Ctrl+Option+F: режим Focus view, который прячет вызовы инструментов и оставляет только запросы и ответы (Claude Code v2.1.221 или новее).
• Ctrl+N / Cmd+N: новый разговор, но только когда фокус в Claude и включена настройка enableNewConversationShortcut.
• Ctrl+O: развернуть или свернуть все блоки рассуждений в сессии.

Полный список команд расширения открывается в палитре: Ctrl+Shift+P на Windows и Linux или Cmd+Shift+P на Mac, затем «Claude Code».

На macOS Tahoe и новее Cmd+Esc может не срабатывать: системный Game Overlay перехватывает это сочетание раньше VS Code. Сними галочку Game Overlay в System Settings → Keyboard → Keyboard Shortcuts → Game Controllers или назначь команде Claude Code: Focus input другое сочетание в редакторе клавиш VS Code (Cmd+K Cmd+S).

Расширение или CLI в терминале VS Code#

Расширение несёт внутри собственную копию CLI для панели чата, но команду claude в PATH не добавляет. Поэтому claude во встроенном терминале не запустится, пока ты не поставишь CLI отдельно. Как это сделать, описано в гайде по Claude Code, а для Windows есть отдельная инструкция.

CLI нужен, когда не хватает возможностей панели. По документации различия такие:

• в CLI доступны все команды и скиллы, в расширении только часть (набери /, чтобы увидеть список);
• быстрый вызов bash через ! и автодополнение по Tab есть только в CLI;
• MCP-серверы и контрольные точки работают в обоих вариантах.

Во встроенном терминале (View → Terminal или Ctrl+`; на Mac это тоже Control, а не Cmd) CLI сам связывается с редактором: диффы открываются в просмотрщике VS Code, туда же уходит диагностика. Если запускаешь Claude Code во внешнем терминале, выполни в нём /ide, чтобы подключить VS Code. История разговоров общая, поэтому разговор из панели продолжается в терминале через claude --resume.

Нравится интерфейс терминала, но не хочется держать отдельное окно? Включи настройку Use Terminal в Extensions → Claude Code, и расширение будет открывать Claude в режиме терминала. Разрешённые команды и хуки хранятся в ~/.claude/settings.json, а MCP-серверы в ~/.claude.json (личные) или в .mcp.json в корне проекта (общие для команды). Эти настройки общие для расширения и CLI.

Если Claude Code в VS Code не работает#

Расширение не ставится. Проверь версию VS Code (по документации нужна 1.94.0 или новее) и то, что VS Code разрешено ставить расширения. Если не помогло, установи расширение со страницы в Marketplace.

Нет значка-искры. Документация предлагает пройти по списку:

1. Открой файл: одной открытой папки мало.
2. Проверь версию VS Code: Help → About на Windows и Linux или Code → About Visual Studio Code на Mac.
3. Выполни Developer: Reload Window.
4. Временно отключи другие AI-расширения вроде Cline или Continue.
5. Проверь доверие к рабочей папке: в Restricted Mode расширение не работает.

Claude молчит. Проверь соединение, начни новый разговор, запусти claude в терминале: CLI показывает более подробные сообщения об ошибках. Если проблема остаётся, Anthropic просит завести issue в репозитории Claude Code на GitHub.

Если связь из России нестабильна, это отдельная история. В статье про Claude Code в России описан сетап с зарубежным VPS и подключением к нему из VS Code через Remote SSH.

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

Расширение Claude Code для VS Code бесплатное?

Установка бесплатная, в Marketplace расширение помечено как Free. Бесплатно работать не получится: нужна платная подписка Claude (Pro, Max, Team или Enterprise) или аккаунт Claude Console с оплатой по факту использования.

Нужен ли API-ключ?

Нет, достаточно войти аккаунтом Claude через браузер. Если организация ходит к Claude через Amazon Bedrock, Google Cloud Agent Platform или Microsoft Foundry, в настройках расширения включают Disable Login Prompt, а провайдера настраивают в ~/.claude/settings.json.

Работает ли расширение в Cursor?

Да, это то же расширение anthropic.claude-code, и для Cursor в документации Anthropic есть своя ссылка установки.

Как удалить Claude Code из VS Code?

Открой панель расширений, найди Claude Code и нажми Uninstall. Но если потом запустить claude во встроенном терминале VS Code, расширение установится заново. Чтобы этого не было, выключи Auto-install IDE extension в /config или задай autoInstallIdeExtension со значением false.