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 прошла 21 сентября 2026 года. У меня на macOS claude --version печатает 2.1.278, расширение с тем же номером лежит в Marketplace с 19 сентября. Windows руками не проверял.

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

Где вы сейчас

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

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

Что понадобится для расширения?

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

Версия VS Code видна в меню Help → About. В описании на странице Marketplace стоит 1.98.0, в документации и манифесте 1.94.0, так что проще обновить редактор до свежей версии. Если в системе задан ключ 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 в его встроенном терминале.

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

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

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

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

На экране входа жми Sign in и подтверди вход в браузере теми же данными, что и в терминале.

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

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

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

Первая задача пусть будет без правок:

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

Когда агент хочет изменить файл в режиме Manual, он показывает исходный и предложенный текст рядом. Можно принять, отклонить или написать, что сделать иначе. С версии 2.1.276 у каждой правки в окне свои кнопки, и большую правку можно разобрать по кускам.

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

Коротко: через символ @ и выделение. Набираешь @ и начало имени файла, агент подтягивает содержимое. Выделенный текст уходит к агенту сам, а 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:имя. Файлы с ключами вроде .env документация советует закрыть правилом запрета на чтение (Read deny): тогда ни выделение, ни отметка об открытом файле к агенту не уйдут. Как пишутся запреты - в статье настройка Claude Code с нуля.

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

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

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

1. Настройка claudeCode.initialPermissionMode в VS Code.
2. Режим, выбранный кнопкой последним, если это Manual, Edit automatically или Auto.
3. Поле permissions.defaultMode в ~/.claude/settings.json на Pro, Max и Team.
4. Умолчание тарифа: Auto на Pro, Max и Team, Manual на Enterprise и с ключом Claude Console.

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

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

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

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

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

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

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

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 ставят отдельно.

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

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

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

Какие настройки расширения стоит знать?

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

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

Строка со схемой в ~/.claude/settings.json включает подсказки полей прямо в VS Code:

"$schema": "https://json.schemastore.org/claude-code-settings.json"

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

Частые ошибки 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 в терминале в той же папке: там сбой повторится с понятным текстом.

The connection to Claude Code ended before this message completed

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

Unsupported platform

Под твою систему в сборке нет готовой программы. Поставь Claude Code отдельно и укажи путь к нему в настройке claudeCode.claudeProcessWrapper.

Чек-лист

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

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

Расширение стоит - что дальше?

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

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

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