Что такое 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.
- Откройте панель расширений:
Cmd+Shift+Xна Mac,Ctrl+Shift+Xна Windows и Linux. - Наберите в поиске
Claude Codeлатиницей: так расширение называется в магазине, хотя вслух его зовут и клод код, и клауд код. - Найдите Claude Code for VS Code от издателя Anthropic, у него в магазине подтверждён домен anthropic.com.
- Нажмите Install.
- Значка нет - откройте палитру команд (
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 можно четырьмя способами:
- Значок Spark в панели инструментов редактора. Появляется, только когда открыт файл: одной папки мало.
- Значок Spark на панели действий слева - список сессий, виден всегда.
- Палитра команд: набрать
Claude Codeи выбрать, например, Open in New Tab. - Кнопка ✻ 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 |
всё, без проверок |
Стартовый режим нового разговора расширение берёт из первого сработавшего пункта:
- Настройка
claudeCode.initialPermissionModeв пользовательских настройках VS Code. Принимаетdefault(он жеmanual),acceptEdits,plan,bypassPermissions. - Режим, выбранный кнопкой последним, если это Manual, Edit automatically или Auto. Plan и Bypass permissions действуют только на тот разговор, где их выбрали.
- Поле
permissions.defaultModeв~/.claude/settings.json(до версии 2.1.283 - только на Pro, Max, Ultra и Team). - Умолчание самой программы: с версии 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.
Контрольная точка создаётся на каждый ваш запрос, у кнопки отката три варианта:
- Fork conversation from here - новая ветка разговора, файлы как есть.
- Rewind code to here - файлы возвращаются к этому моменту, разговор сохраняется.
- 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из внешнего терминала может поставить расширение заново: это отключается настройкой.
- Откройте панель расширений:
Cmd+Shift+Xна Mac,Ctrl+Shift+Xна Windows и Linux. - Найдите Claude Code и нажмите Uninstall.
- Не хотите, чтобы команда
/ideставила расширение снова, - задайтеautoInstallIdeExtensionсо значениемfalseв файле~/.claude.jsonлибо выключите Auto-install IDE extension в/configиз встроенного терминала.
Как убрать и данные расширения, написано в разделе Uninstall документации Anthropic (ссылка в источниках).
Чек-лист
Коротко: Claude Code в VS Code готов к работе, если все шесть проверок ниже дают ответ «да». На каждую уходит около минуты. Где ответ «нет», перечитайте одноимённый раздел выше и пройдите его заново.
- Стоит Claude Code for VS Code от издателя Anthropic.
- Значок Spark появляется при открытом файле, вход выполнен.
- В системе нет лишнего
ANTHROPIC_API_KEY, если работаете по подписке. - Вы видите режим под полем ввода и умеете его переключить.
- Агент получил файл через
@и кусок кода черезOption+KилиAlt+K. - Одна пробная правка откачена кнопкой отката.
Claude Code в VS Code установлен - что дальше?
Коротко: дальше агента учат вашему проекту и вашим правилам. Вот три шага по порядку отдачи: файл правил, первые скиллы, разрешения и запреты. В панели VS Code и в терминале всё это работает одинаково, потому что настройки и история у них общие.
- Заведите файл правил проекта, его агент открывает первым делом в каждой сессии: как задать правила проекта.
- Поставьте первые скиллы, готовые инструкции под типовые задачи: что такое скиллы и где их брать.
- Настройте разрешения и запреты: настройка 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 года.
- Anthropic: Use Claude Code in VS Code - расширение, требования, настройки, горячие клавиши, удаление.
- Anthropic: Choose a permission mode - режимы и стартовый режим разговора.
- Anthropic: Error reference - ошибки расширения и обёрток.
- Anthropic: Checkpointing - контрольные точки и откат.
- Visual Studio Marketplace: Claude Code for VS Code и Open VSX - страницы расширения и номер последней версии.
- Visual Studio Code: Workspace Trust - ограниченный режим папки.