ВойтиПолучить доступ

Инструменты18 минобновлено

Claude Code в VS Code

Что такое Claude Code в VS Code?

Коротко: Claude Code в VS Code - это официальное расширение Anthropic под названием Claude Code for VS Code. Агент открывается панелью рядом с файлами проекта, читает и правит их, а в режиме Manual показывает каждую правку в окне сравнения. Нужны VS Code 1.94.0 или новее и платная подписка Claude либо аккаунт Claude Console.

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

В курсе ClaudeBase мы работаем именно в VS Code: файлы, правки и разговор с агентом лежат в одном окне.

Общий разбор - что такое Claude Code. Сверка с документацией Anthropic прошла 5 ноября 2026 года. На эту дату последняя версия расширения в реестре Open VSX - 2.1.318 от 4 ноября. Установку на Windows отдельно не проверяли: шаги для неё взяты из документации.

Как подготовить VS Code под агента, разобрано в ClaudeBase: в уроке и в готовых файлах настроек.

Где вы сейчас

Коротко: выберите строку, похожую на вашу ситуацию, и переходите в нужный раздел. Читать подряд не обязательно: сделанные шаги пропускайте.

  • VS Code есть, Claude Code нет. Идите по порядку, отдельно ставить Claude Code не нужно.
  • Claude Code уже стоит в терминале. Начните с установки расширения, настройки у них общие. Работа в терминале - отдельно.
  • Расширение стоит, но не работает. Сразу в раздел с ошибками.
  • Расширение хотите убрать. Раздел «Как отключить или удалить Claude Code в VS Code» ближе к концу.
  • Работаете в Cursor. Оговорки в разделе про установку, сравнение инструментов - Claude Code или Cursor. Что с моделями OpenAI в Cursor после 12 ноября - Cursor в России: что изменилось после 12 ноября.

Что понадобится для Claude Code в VS Code?

Коротко: нужны три вещи: VS Code версии 1.94.0 или новее, подписка Claude на платном тарифе (Pro, Max, Ultra, Team или Enterprise) или аккаунт Claude Console и папка с проектом. Ключ API не нужен, вход идёт через браузер. Бесплатного плана claude.ai для агента не хватит, Anthropic пишет это прямо в документации.

Что Требование
VS Code 1.94.0 или новее, по документации и манифесту пакета
Аккаунт Pro, Max, Ultra, Team, Enterprise или Claude Console
Ключ API не нужен
Claude Code в терминале для панели не нужен, для команды claude в терминале нужен

Версия VS Code видна в меню Help → About. В описании на странице Marketplace стоит 1.98.0, в документации и манифесте 1.94.0, так что проще обновить редактор до свежей версии. Версия расширения видна в панели расширений и совпадает с версией Claude Code внутри него: если у функции в документации указано «нужна версия 2.1.275 или новее», смотрите этот номер. Если в системе задан ключ ANTHROPIC_API_KEY, Claude Code возьмёт его вместо подписки, а платить за расход придётся по тарифам API.

Что доступно без оплаты, разобрано в статье Claude Code бесплатно. Лимиты у расширения общие с чатом и терминалом, как они считаются - в разборе лимитов. Оплата подписки из России - отдельная статья.

Как установить расширение Claude Code for VS Code?

Коротко: ставится через встроенный магазин расширений VS Code. Ищете Claude Code, проверяете издателя Anthropic и нажимаете Install. Официальное расширение называется Claude Code for VS Code, идентификатор у него anthropic.claude-code. Если значок после установки не появился, окно перезагружают командой Developer: Reload Window.

  1. Откройте панель расширений: Cmd+Shift+X на Mac, Ctrl+Shift+X на Windows и Linux.
  2. Наберите в поиске Claude Code латиницей: так расширение называется в магазине, хотя вслух его зовут и клод код, и клауд код.
  3. Найдите Claude Code for VS Code от издателя Anthropic, у него в магазине подтверждён домен anthropic.com.
  4. Нажмите Install.
  5. Значка нет - откройте палитру команд (Cmd+Shift+P или Ctrl+Shift+P) и выполните Developer: Reload Window.

Издателя проверяйте: со словом Claude в названии в магазине есть и чужие расширения. Идентификатор официального:

anthropic.claude-code

В Cursor расширение ставится так же, а в Devin Desktop и Kiro его ищут в своей панели расширений или берут из реестра Open VSX. Не принимает редактор расширение - запускайте claude в его встроенном терминале.

Как открыть панель Claude Code в VS Code и войти в аккаунт?

Коротко: панель открывается значком Spark справа вверху редактора, но только когда открыт хотя бы один файл. Без файла поможет кнопка Claude Code в строке состояния. При первом открытии появится экран входа: нажимаете Sign in и подтверждаете вход в браузере. Папку проекта отметьте как доверенную, в ограниченном режиме расширение не работает.

Открыть Claude можно четырьмя способами:

  1. Значок Spark в панели инструментов редактора. Появляется, только когда открыт файл: одной папки мало.
  2. Значок Spark на панели действий слева - список сессий, виден всегда.
  3. Палитра команд: набрать Claude Code и выбрать, например, Open in New Tab.
  4. Кнопка ✻ Claude Code в строке состояния, в правом нижнем углу окна. Она работает и когда ни один файл не открыт.

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

Новую папку VS Code открывает в ограниченном режиме (Restricted Mode) и спрашивает, доверяете ли вы её авторам. В этом режиме расширение не работает: для своего проекта отвечайте, что доверяете.

Как дать первую задачу и проверить правки?

Коротко: задачу пишете обычными словами в поле внизу панели и отправляете клавишей Enter, новую строку даёт Shift+Enter. Что будет дальше, зависит от режима разрешений под полем ввода. В режиме Manual агент перед каждой правкой открывает окно сравнения «было - стало» и ждёт вашего решения.

Первая задача пусть будет без правок, лучше всего в учебной папке, а не в рабочем проекте:

Посмотри файлы в этой папке и расскажи, что тут лежит. Ничего не меняй.

Когда агент хочет изменить файл в режиме Manual, он показывает исходный и предложенный текст рядом. Можно принять, отклонить или написать, что сделать иначе. С версии 2.1.275 под каждым изменением в окне есть свои кнопки Accept this change и Reject this change, так что большую правку можно разобрать по кускам. Это выручает на первом настоящем проекте вроде бота для MAX на Python, где правок много и каждую хочется видеть.

После принятой правки не ограничивайтесь пересказом агента: откройте панель Source Control в VS Code и посмотрите, какие файлы изменились на самом деле.

Как показать агенту файл или кусок кода?

Коротко: через символ @ и выделение. Набираете @ и начало имени файла, агент подтягивает содержимое. Выделенный текст уходит к агенту сам, а Option+K на Mac или Alt+K на Windows вставляет в запрос ссылку с номерами строк. Открытый файл тоже прикладывается, это отключается настройкой.

Объясни, что делает @auth
Что лежит в @src/components/

Поиск нечёткий, папку пишут со слэшем на конце.

Выделенный текст агент получает без лишних действий. Option+K или Alt+K добавляет ссылку вида @app.ts#5-10: файл и номера строк. Имя открытого файла уходит и без выделения, а настройка Attach Open File (claudeCode.attachOpenFile, с версии 2.1.271) оставляет только выделенный текст.

Вывод терминала передаёт ссылка @terminal:имя. Картинку вставляют из буфера обмена, а файлы перетаскивают в поле ввода с зажатой клавишей Shift. Файлы с ключами вроде .env документация советует закрыть правилом запрета на чтение (Read deny): тогда ни выделение, ни отметка об открытом файле к агенту не уйдут. Как пишутся запреты - в статье настройка Claude Code с нуля.

Какой режим разрешений выбрать в Claude Code в VS Code?

Коротко: режим переключается кнопкой под полем ввода. В списке Manual, Edit automatically, Plan и Auto, пятый Bypass permissions появляется после отдельной настройки. С версии 2.1.283 новые разговоры по умолчанию стартуют в Auto: там каждое действие перед выполнением оценивает отдельная модель. Для незнакомого кода и чувствительной работы документация советует Manual.

Подпись Значение в настройках Что агент делает без вопроса
Manual default только читает
Edit automatically acceptEdits читает, правит файлы, выполняет простые команды вроде mkdir и mv
Plan plan читает и описывает план, правки после одобрения; план открывается документом, куда можно оставить комментарии
Auto auto всё, с фоновой проверкой действий моделью-классификатором
Bypass permissions bypassPermissions всё, без проверок

Стартовый режим нового разговора расширение берёт из первого сработавшего пункта:

  1. Настройка claudeCode.initialPermissionMode в пользовательских настройках VS Code. Принимает default (он же manual), acceptEdits, plan, bypassPermissions.
  2. Режим, выбранный кнопкой последним, если это Manual, Edit automatically или Auto. Plan и Bypass permissions действуют только на тот разговор, где их выбрали.
  3. Поле permissions.defaultMode в ~/.claude/settings.json (до версии 2.1.283 - только на Pro, Max, Ultra и Team).
  4. Умолчание самой программы: с версии 2.1.283 обычно Auto (зависит от тарифа, провайдера и настроек организации). Если Auto недоступен, например его отключила организация или модель его не поддерживает, разговор стартует в Manual.

Файлы .claude/settings.json и .claude/settings.local.json в папке проекта расширение для стартового режима не читает. Значение auto настройка initialPermissionMode не принимает: для старта в Auto её оставляют пустой и один раз выбирают Auto кнопкой.

Plan можно включить и командой /plan: план откроется документом с комментариями (нужна версия 2.1.280).

Bypass permissions спрятан за переключателем Allow dangerously skip permissions, и документация советует включать его только в песочнице без интернета. Правила запрета работают в любом режиме.

Режимы в курсе. Урок «Настройка VS Code и работа в Claude Code» разбирает рабочее место: тему, расширения, режим разрешений и правило «одна задача - одно окно». Установку расширения урок не показывает, она здесь. Материал «Настройки Claude Code, Codex и VS Code» - четыре готовых файла: они включают работу без лишних вопросов и закрывают опасные команды. Всё это в ClaudeBase.

Как вернуться к разговору и откатить правки?

Коротко: старые разговоры лежат за кнопкой Session history вверху панели, там есть поиск по словам. Правки откатываются контрольными точками: наводите курсор на сообщение и выбираете, что вернуть. Изменения, сделанные командами в терминале, так не откатываются, поэтому git в проекте всё равно нужен.

В Session history любой разговор продолжается с полной историей. С версии 2.1.265 сессия без активности 14 дней уходит в архив сама, срок меняет настройка Archive Inactive Sessions, а вернуть её помогает кнопка Unarchive session.

Контрольная точка создаётся на каждый ваш запрос, у кнопки отката три варианта:

  1. Fork conversation from here - новая ветка разговора, файлы как есть.
  2. Rewind code to here - файлы возвращаются к этому моменту, разговор сохраняется.
  3. Fork conversation and rewind code - и ветка, и откат файлов.

Откат касается только правок, которые агент внёс инструментами редактирования. Файл, удалённый командой rm или переименованный через mv, он не вернёт. История у расширения и терминала общая, разговор из панели продолжается командой claude --resume.

Чем расширение отличается от claude в терминале?

Коротко: движок один, отличаются интерфейс и набор функций. Расширение даёт окно сравнения и кнопки, терминал - полный набор команд. Главная путаница: своя копия программы в расширении работает только для панели и в PATH не попадает. Для команды claude во встроенном терминале Claude Code ставят отдельно.

Что Терминал Расширение
Команды и скиллы все часть, список по /
Серверы MCP да да, через /mcp
Контрольные точки да да
Запуск команды через ! да нет
Дополнение по Tab да нет

Расширение стоит, а claude в терминале не находится - так и задумано. PATH - это список папок, где система ищет программы, и расширение туда ничего не добавляет. Для терминала Claude Code ставится по инструкции по установке, дальше встроенный терминал открывается клавишами Ctrl+` на Windows и Linux или Cmd+` на Mac.

Агент во встроенном терминале сам связывается с редактором и показывает правки в окне сравнения VS Code, во внешнем терминале связь включает команда /ide. Терминал с нуля - в отдельной статье, команды - в шпаргалке.

Плагины и серверы MCP у панели и терминала общие: плагины, разбор MCP.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF

Какие настройки Claude Code в VS Code стоит знать?

Коротко: настройки делятся на две группы. Параметры самого расширения хранятся в VS Code и управляют панелью. Файл ~/.claude/settings.json общий для расширения и терминала: там разрешения, переменные окружения, хуки и серверы MCP. Ниже семь настроек расширения, которые пригодятся новичку в первую неделю.

Открываются через Cmd+, или Ctrl+,, раздел Extensions → Claude Code, либо через / и пункт General config.

Настройка По умолчанию Что делает
claudeCode.preferredLocation panel sidebar - открывать сбоку справа, panel - новой вкладкой
claudeCode.initialPermissionMode не задана стартовый режим разрешений
claudeCode.useCtrlEnterToSend false отправка по Ctrl+Enter или Cmd+Enter
claudeCode.attachOpenFile true прикладывать открытый файл
claudeCode.attachSelection true прикладывать выделенный текст
claudeCode.archiveInactiveSessions 14 дней до автоархива, 0 выключает его
claudeCode.useTerminal false терминальный вид вместо панели

Строка "$schema": "https://json.schemastore.org/claude-code-settings.json" в ~/.claude/settings.json включает подсказки полей прямо в VS Code.

Если в сеть выходите через прокси, например из России, переменные вроде HTTPS_PROXY можно задать в блоке env того же файла, тогда их получат и расширение, и терминал. Заданные только в терминале переменные VS Code может не унаследовать, тогда его запускают командой code ., а на Mac её сначала включают в палитре команд: Shell Command: Install ‘code’ command in PATH. Вход и сеть - в статье Claude Code в России.

Какие горячие клавиши есть у Claude Code в VS Code?

Коротко: самые полезные - переключение между редактором и панелью агента, новая вкладка с разговором и вставка ссылки на выделенные строки. Одно сочетание включается настройкой, остальные работают сразу. Полный список команд лежит в палитре команд по слову Claude Code.

Что делает Mac Windows и Linux
Переключить фокус между редактором и Claude Cmd+Esc Ctrl+Esc
Новый разговор вкладкой Cmd+Shift+Esc Ctrl+Shift+Esc
Вставить ссылку на файл и выделенные строки Option+K Alt+K
Новый разговор в панели (включается claudeCode.enableNewConversationShortcut) Cmd+N Ctrl+N
Вернуть закрытую вкладку с разговором Cmd+Shift+T Ctrl+Shift+T

Cmd+N и Ctrl+N работают, когда в фокусе панель Claude.

Частые ошибки Claude Code в VS Code

Коротко: ниже дословные тексты сообщений, на которых застревают с расширением, и что с каждым делать. Почти все они про вход в аккаунт, отдельную установку Claude Code для терминала и PATH на Windows. Если сообщения нет, а панель не отвечает, смотрите таблицу симптомов в конце раздела.

Not logged in · Please run /login

Экран входа обычно открывается сам. Не открылся - выполните Developer: Reload Window. Если в системе задан ANTHROPIC_API_KEY, а панель просит войти, VS Code не унаследовал переменные: запустите его командой code . или войдите аккаунтом Claude.

zsh: command not found: claude

Стоит только расширение, а claude набран в терминале. Поставьте Claude Code отдельно по инструкции. На Linux и Windows текст сообщения другой, причина та же.

Could not locate the Claude CLI on PATH

Бывает на Windows, когда Claude открывают во встроенном терминале с PowerShell. Выполните в PowerShell вне VS Code:

where.exe claude

Пусто - добавьте папку программы в PATH. Путь напечатан - перенесите его из профиля PowerShell в переменные пользователя или системы и перезапустите VS Code: PATH он читает при старте.

Claude Code process exited with code 1

Процесс агента упал, код выхода причину не называет. Нажмите View output logs рядом с ошибкой или запустите claude в терминале в той же папке: там сбой повторится с понятным текстом. Состояние установки проверяет команда claude doctor.

The connection to Claude Code ended before this message completed

Связь оборвалась до ответа, и расширение не знает, дошло ли сообщение. Отправьте его ещё раз, разговор продолжится в новом процессе.

The Claude Code program for this computer could not be found

В расширении нет сборки под вашу систему, в сообщении названа нужная, например Linux (linux-x64). До версии 2.1.290 это сообщение звучало как Unsupported platform. Переустановите расширение из панели расширений или поставьте Claude Code отдельно и укажите путь к нему в настройке claudeCode.claudeProcessWrapper.

Симптом Что делать
Нет значка Spark открыть файл, обновить VS Code, Developer: Reload Window, отключить другие ИИ-расширения, выйти из ограниченного режима; панель открывает и кнопка Claude Code в строке состояния
Cmd+Esc не работает на macOS на Tahoe и новее сочетание занято Game Overlay: снять его в System Settings → Keyboard → Keyboard Shortcuts → Game Controllers или назначить расширению другую клавишу
Кривые символы во встроенном терминале выполнить /terminal-setup
Панель не отвечает проверить интернет, начать новый разговор, запустить claude в терминале в той же папке

Как отключить или удалить Claude Code в VS Code?

Коротко: расширение убирают в панели расширений кнопкой Uninstall. Claude Code для терминала при этом остаётся. Команда /ide из внешнего терминала может поставить расширение заново: это отключается настройкой.

  1. Откройте панель расширений: Cmd+Shift+X на Mac, Ctrl+Shift+X на Windows и Linux.
  2. Найдите Claude Code и нажмите Uninstall.
  3. Не хотите, чтобы команда /ide ставила расширение снова, - задайте autoInstallIdeExtension со значением false в файле ~/.claude.json либо выключите Auto-install IDE extension в /config из встроенного терминала.

Как убрать и данные расширения, написано в разделе Uninstall документации Anthropic (ссылка в источниках).

Чек-лист

Коротко: Claude Code в VS Code готов к работе, если все шесть проверок ниже дают ответ «да». На каждую уходит около минуты. Где ответ «нет», перечитайте одноимённый раздел выше и пройдите его заново.

  1. Стоит Claude Code for VS Code от издателя Anthropic.
  2. Значок Spark появляется при открытом файле, вход выполнен.
  3. В системе нет лишнего ANTHROPIC_API_KEY, если работаете по подписке.
  4. Вы видите режим под полем ввода и умеете его переключить.
  5. Агент получил файл через @ и кусок кода через Option+K или Alt+K.
  6. Одна пробная правка откачена кнопкой отката.

Claude Code в VS Code установлен - что дальше?

Коротко: дальше агента учат вашему проекту и вашим правилам. Вот три шага по порядку отдачи: файл правил, первые скиллы, разрешения и запреты. В панели VS Code и в терминале всё это работает одинаково, потому что настройки и история у них общие.

  1. Заведите файл правил проекта, его агент открывает первым делом в каждой сессии: как задать правила проекта.
  2. Поставьте первые скиллы, готовые инструкции под типовые задачи: что такое скиллы и где их брать.
  3. Настройте разрешения и запреты: настройка Claude Code с нуля.

Урок про настройку VS Code, список расширений и файлы настроек лежат в базе. Листать её вручную не придётся: прямо из панели VS Code агент дотягивается до базы через MCP и находит материал по вашей просьбе. Доступ - на странице ClaudeBase.

Работа с репозиторием: Claude Code и GitHub.

Тот же Claude Code можно запустить на локальной модели через Ollama, это разобрано в статье Claude Code Ollama.

«Ошибка «Credit balance is too low» в расширении: причины и проверка /status.».

Источники

Проверено 5 ноября 2026 года.

Спрашивают

Пять вопросов по теме

Как подключить Claude к VS Code?

Поставить расширение Claude Code for VS Code от издателя Anthropic из панели расширений и войти в аккаунт. Панель открывается значком Spark, когда в редакторе открыт файл, или кнопкой в строке состояния, дальше кнопка Sign in и подтверждение в браузере. Нужны VS Code 1.94.0 или новее и платная подписка Claude либо аккаунт Claude Console, ключ API для этого не нужен.

Можно ли пользоваться Claude Code в VS Code бесплатно?

Само расширение в Marketplace бесплатное, но без платного аккаунта работать не будет. Документация Anthropic прямо пишет, что бесплатный план claude.ai доступа к Claude Code не даёт: нужна подписка Pro, Max, Ultra, Team или Enterprise либо аккаунт Claude Console с оплатой по расходу. Лимиты подписки общие для чата, терминала и редактора.

Где в VS Code указать ключ Claude Code?

При работе по подписке ключ не нужен: расширение входит через браузер кнопкой Sign in, аккаунт Console тоже умеет так входить. Если ключ задан переменной окружения ANTHROPIC_API_KEY, Claude Code берёт его вместо подписки, и расход идёт по тарифам API. Поэтому лишнюю переменную из системы лучше убрать.

Как работать с Claude Code в VS Code через прокси?

Задать переменные прокси в блоке env файла ~/.claude/settings.json. Этот файл общий для расширения и терминала, и документация разрешает держать в нём сетевые переменные, включая HTTPS_PROXY. Если переменные заданы только в терминале, VS Code может их не унаследовать: тогда редактор запускают из терминала командой code с точкой.

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

Да. На странице Anthropic про VS Code есть отдельная ссылка установки для Cursor, а в других редакторах на базе VS Code, например Devin Desktop и Kiro, его ищут в панели расширений или берут из реестра Open VSX. Подписка Pro или Max покрывает работу в таких редакторах, лимиты общие. Если редактор расширение не принимает, Claude Code запускают в его встроенном терминале.

Источники