vs code claude: как поставить расширение claude code и работать в редакторе

vs code claude — это официальное расширение claude code от anthropic: агент живёт в панели редактора, видит выделенный код, показывает правки диффом и умеет откатывать их. ставится из маркетплейса за минуту, отдельный cli для панели не нужен, вход — через подписку claude или аккаунт claude console. ниже — установка, интерфейс, режимы разрешений и чем панель отличается от терминала, всё сверено с документацией на 14 октября 2026 года.

что умеет расширение и что нужно заранее

расширение — это графический интерфейс к тому же агенту, что работает в терминале. в нём можно читать и править план до того, как агент начнёт, принимать правки по одной, ссылаться на файлы с диапазоном строк, листать историю и держать несколько разговоров во вкладках. anthropic называет его рекомендуемым способом работать с claude code внутри vs code.

что нужно до установки:

• vs code версии 1.94.0 или новее (проверить: help → about);
• аккаунт anthropic: любая платная подписка claude (pro, max, team или enterprise) или аккаунт claude console. api-ключ не обязателен;
• если доступ к claude у компании идёт через amazon bedrock, google cloud agent platform или microsoft foundry, в настройках расширения включают «disable login prompt», а провайдера настраивают в ~/.claude/settings.json.

важная деталь: внутри расширения лежит своя копия cli, и панель работает на ней. номер версии расширения совпадает с версией claude code внутри: если функция требует v2.1.286, нужна версия расширения 2.1.286 или новее. в маркетплейсе на сегодня стоит 2.1.296.

vs code claude: установка расширения из маркетплейса

в маркетплейсе расширение называется «claude code for vs code», издатель — anthropic, идентификатор anthropic.claude-code. перед установкой сверяй издателя, чтобы не поставить что-то постороннее.

1. открой панель расширений: Cmd+Shift+X на mac или Ctrl+Shift+X на windows и linux;
2. набери в поиске «claude code» и проверь издателя;
3. нажми install;
4. если значок не появился, перезапусти редактор или выполни из палитры команд «developer: reload window».

второй путь — ссылка, которая сразу открывает страницу расширения в редакторе:

vscode:extension/anthropic.claude-code

для cursor в документации есть своя ссылка, cursor:extension/anthropic.claude-code. расширение ставится и в другие форки vs code, например devin desktop и kiro: ищи «claude code» в их панели расширений или бери из реестра open vsx. если редактор вообще не даёт поставить расширение, остаётся cli во встроенном терминале — как его установить на windows и mac, я разобрал в статье как установить claude code.

первый запуск: вход, панель и история

claude code в vs code везде помечен значком-искрой. быстрее всего открыть панель по искре в правом верхнем углу редактора, но она появляется только при открытом файле. другие входы:

• искра на левой панели активности — список сессий, виден всегда;
• палитра команд (Cmd+Shift+P / Ctrl+Shift+P), набрать «claude code» и выбрать, например, «open in new tab»;
• надпись «✻ claude code» в правом нижнем углу строки состояния, работает даже без открытого файла.

при первом открытии появится экран входа: жмёшь «sign in» и подтверждаешь вход в браузере. если в оболочке задан ANTHROPIC_API_KEY, а расширение всё равно просит войти, значит vs code не унаследовал переменные окружения. запусти редактор из терминала командой:

code .

после входа откроется чек-лист «learn claude code», а пошаговый тур есть в палитре команд: «claude code: open walkthrough». панель можно перетащить в правый сайдбар, в левый или открыть вкладкой рядом с файлами. новые разговоры открываются через «open in new tab» (Cmd+Shift+Esc / Ctrl+Shift+Esc) или «open in new window», у каждого своя история и свой контекст. синяя точка на искре вкладки значит, что агент ждёт разрешения, оранжевая — что он закончил, пока вкладка была скрыта.

история — по кнопке session history вверху панели: поиск по словам или по времени, названия сессиям ии даёт сам по первому сообщению. сессию можно переименовать или убрать в архив. по умолчанию сессия без активности 14 дней уходит в архив сама, срок меняется настройкой archiveInactiveSessions.

выделение, @-упоминания файлов и вывод терминала

агент видит файл, открытый в редакторе, и выделенный текст, даже если ты о нём не пишешь. под полем ввода видно, сколько строк выделено, а крестик на этом индикаторе убирает выделение из контекста. чтобы вставить в сообщение точную ссылку на кусок кода, выдели строки и нажми Option+K на mac или Alt+K на windows и linux — в поле появится ссылка вида @app.ts#5-10.

файлы и папки подтягиваются через @ с нечётким поиском: @auth найдёт и auth.js, и authservice.ts, а папку пишут с косой чертой на конце, @src/components/. картинку можно вставить из буфера обмена прямо в поле ввода, а файлы перетащить, удерживая Shift.

вывод терминала не нужно копировать руками: @terminal:имя, где имя — заголовок терминала, отдаёт агенту логи и ошибки. это удобно, когда упала сборка или dev-сервер сыплет ошибками.

про приватность. если файл попадает под files.exclude, search.exclude или под .gitignore (при включённых search.useIgnoreFiles и respectGitIgnore, по умолчанию так и есть), панель отдаёт агенту только путь, без выделенного текста. это работает только в панели: cli во встроенном терминале шлёт выделение из любого файла, поэтому для .env ставь правило запрета Read.

диффы и откат: как принимать правки

как выглядят правки, зависит от режима разрешений внизу поля ввода. в режимах auto и edit automatically агент правит большинство файлов в проекте без вопросов. в режиме manual он показывает сравнение «было — стало» рядом и ждёт решения: принять, отклонить или написать, что сделать иначе. если поправишь предложенный текст прямо в диффе, агенту сообщат, что файл изменён тобой.

большой дифф удобно разбирать по кусочкам: под каждым изменением есть кнопки «accept this change» и «reject this change», те же действия есть в палитре команд. это работает с claude code v2.1.275, а дифф больше чем на 100 изменений открывается без таких кнопок, только целиком.

если агент ушёл не туда, наведи курсор на сообщение и нажми кнопку отката. вариантов три:

• fork conversation from here — новая ветка разговора с этого места, код не трогается;
• rewind code to here — файлы возвращаются к состоянию на этот момент, переписка остаётся;
• fork conversation and rewind code — и новая ветка, и откат файлов.

у чекпоинтов есть пределы. они не видят изменений, которые агент сделал командами в терминале (rm, mv, cp), и правок, которые ты внёс руками вне сессии. это быстрый откат внутри сессии, а не замена git, так что коммиты делай как обычно.

режимы разрешений в vs code claude: почему по умолчанию auto

режим переключается кликом по индикатору внизу поля ввода. в vs code у режимов такие подписи:

начиная с claude code v2.1.283, auto — встроенный стартовый режим для интерактивных сессий в терминале и в vs code на всех тарифах и у всех провайдеров. в более старых версиях так было только на pro, max и team. если модель не поддерживает auto или организация его отключила, разговор стартует в manual. сама документация предупреждает: auto сокращает число вопросов, но безопасности не гарантирует.

с каким режимом начнётся новый разговор, расширение решает по первому подходящему пункту:

1. настройка claudeCode.initialPermissionMode в пользовательских настройках vs code (значение auto она не принимает);
2. режим, который ты последним выбрал в индикаторе, если это manual, edit automatically или auto. plan и bypass permissions действуют только на текущий разговор;
3. permissions.defaultMode из ~/.claude/settings.json или управляемых настроек;
4. встроенное значение по умолчанию.

проектный .claude/settings.json расширение для стартового режима не читает никогда. чтобы снова подтверждать каждую правку, достаточно один раз выбрать manual в индикаторе: выбор запомнится.

в режиме plan vs code открывает план полноценным markdown-документом, где можно оставить комментарии прямо в тексте до старта работ. то же самое включается командой в поле ввода:

/plan fix the auth bug

bypass permissions появляется в списке, только если включить в настройках allowDangerouslySkipPermissions, и документация советует это лишь в песочнице без доступа в интернет. отдельный риск: в режимах с автоправками агент может изменить settings.json или tasks.json самого vs code, а редактор их выполняет. для чужого непроверенного кода документация советует restricted mode vs code, режим manual и ручную проверку каждой правки.

пример: первая задача в панели по шагам

сам я делаю сайты, ботов и seo через claude code. для новой задачи в незнакомом коде советую такой порядок:

1. открой нужный файл, чтобы появилась искра, и запусти панель;
2. переключись в plan и опиши задачу, ссылаясь на файлы через @, а на конкретный кусок — через Option+K;
3. прочитай план в markdown, оставь комментарии там, где агент понял не так, и одобри;
4. для правок в рабочем проекте выбери manual и принимай изменения по одному в диффе;
5. если сломалась сборка, отдай ошибку через @terminal:имя, а не копируй руками;
6. когда результат устраивает, попроси агента сделать коммит. если нет — откати код кнопкой rewind и попробуй другой подход.

как формулировать задачи, чтобы агент понимал с первого раза, и как выглядит ежедневный цикл работы, я разобрал отдельно: claude code — как использовать.

расширение или cli в терминале: в чём разница

запрос «claude code vs code» часто читают как сравнение, но это не соперники: агент один, разные только окна к нему. claude code расширение и cli в терминале делят одну историю разговоров и одни настройки в ~/.claude/settings.json: разрешённые команды, хуки, mcp-серверы. различия по документации:

если нужна функция, которой нет в панели, открой встроенный терминал (Ctrl+` / Cmd+`) и запусти claude. для этого нужен отдельно установленный cli: расширение не добавляет claude в path. cli во встроенном терминале сам подключается к редактору и показывает диффы в штатном окне сравнения vs code, а из внешнего терминала его подключает команда /ide. продолжить разговор из панели в терминале можно так:

claude --resume

кто привык к терминальному виду, может оставить его и внутри редактора: настройка «use terminal» (claudeCode.useTerminal) открывает claude code в режиме терминала вместо графической панели. плагины ставятся из панели через /plugins, они общие с cli. для intellij idea, pycharm и других ide jetbrains есть отдельный плагин, он запускает cli во встроенном терминале — инструкция в документации по jetbrains. а если выбираешь между claude code и самим cursor, сравнение здесь: cursor vs claude code.

если что-то не работает

• нет искры в редакторе. открой файл (одной папки мало), проверь версию vs code, сделай «developer: reload window», временно отключи другие ии-расширения вроде cline и continue. в restricted mode расширение не работает. запасной вход — «✻ claude code» в строке состояния;
• Cmd+Esc ничего не делает на mac. в macos tahoe это сочетание по умолчанию забирает game overlay. сними галочку в системных настройках: клавиатура → сочетания клавиш → игровые контроллеры, или назначь другую клавишу команде «claude code: focus input»;
• claude не найден во встроенном терминале. панель работает на своей копии cli, а для терминала нужна отдельная установка;
• снова просит войти. при «not logged in · please run /login» расширение само открывает экран входа, если нет — «developer: reload window»;
• расширение возвращается после удаления. его переустанавливает запуск claude во встроенном терминале. чтобы этого не было, выключи «auto-install ide extension» в /config или поставь autoInstallIdeExtension в false.

вопросы

нужно ли ставить cli, чтобы работало расширение?

нет. панель работает на копии cli, которая лежит внутри расширения. отдельный cli нужен, только если хочешь запускать claude во встроенном или внешнем терминале.

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

да, для cursor в документации есть своя ссылка установки, а ещё расширение ставится в devin desktop, kiro и другие форки через их маркетплейс или open vsx.

можно ли пользоваться бесплатно?

нужна платная подписка claude (pro, max, team или enterprise) либо аккаунт claude console. компании с bedrock, google cloud agent platform или microsoft foundry подключают своего провайдера через настройки.

как вернуть подтверждение каждой правки?

выбери manual в индикаторе режима внизу поля ввода, расширение запомнит выбор для новых разговоров. либо пропиши claudeCode.initialPermissionMode со значением default в пользовательских настройках vs code.

где мои старые разговоры?

кнопка session history вверху панели. по умолчанию сессии без активности дольше 14 дней лежат в группе archived sessions, оттуда их можно вернуть.

источники

• use claude code in vs code — code.claude.com
• choose a permission mode — code.claude.com
• checkpointing — code.claude.com
• jetbrains ides — code.claude.com
• claude code for vs code — visual studio marketplace