Claude Code начинался как терминальный инструмент, и это до сих пор отпугивает половину тех, кому он подошёл бы. Официальное расширение для VS Code снимает вопрос: то же самое, но с графической панелью, показом изменений рядом с кодом и историей разговоров по вкладкам.
Что понадобится
- VS Code 1.94.0 или новее.
- Аккаунт Anthropic — подойдёт любая платная подписка Claude (Pro, Max, Team, Enterprise) либо аккаунт Claude Console. API-ключ не нужен: вход выполняется через браузер при первом открытии панели.
- Отдельно установленный CLI — только если хотите запускать
claudeво встроенном терминале VS Code. Для работы самой панели он не нужен: расширение приносит свою копию.
1. Поставить расширение
Cmd+Shift+X (Mac) или Ctrl+Shift+X (Windows и Linux) → поиск «Claude Code» → Install.
Расширение ставится не только в сам VS Code, но и в его форки — Cursor и другие. Если магазин расширений редактора его не находит, оно лежит в реестре Open VSX. Совсем не встаёт — остаётся поставить CLI и запускать claude во встроенном терминале: он работает в любом.
Если после установки значок не появился, перезапустите редактор или выполните «Developer: Reload Window» из палитры команд.
2. Открыть панель
Claude Code обозначается значком-искрой. Открыть его можно четырьмя способами:
- панель редактора — значок в правом верхнем углу, появляется, когда открыт файл;
- боковая панель слева — список сессий, виден всегда;
- палитра команд —
Cmd+Shift+P/Ctrl+Shift+P, набрать «Claude Code»; - строка состояния — внизу справа, работает и без открытого файла.
Панель перетаскивается куда угодно в интерфейсе — привычка тут у всех своя.
3. Войти
При первом открытии появится экран входа: Sign in → авторизация в браузере.
Если у вас в окружении прописан ANTHROPIC_API_KEY, а экран входа всё равно появляется, значит VS Code не унаследовал переменные окружения оболочки. Запустите редактор из терминала командой code . — либо просто войдите аккаунтом Claude, это проще.
4. Разобраться с режимами
Внизу окна ввода стоит индикатор режима разрешений — главное, что отличает удобную работу от раздражающей. Режимов четыре:
| Режим | Что делает | Когда |
|---|---|---|
| Auto | классификатор проверяет действия вместо вас | режим по умолчанию на Pro, Max и Team |
| Manual | спрашивает разрешение перед правкой файлов и большинством команд | первые дни, незнакомый проект |
| Plan | описывает, что собирается сделать, и ждёт одобрения | крупная задача, чужой код |
| Edit automatically | правит без вопросов | отлаженный повторяющийся сценарий |
Режим Plan в расширении сделан заметно удобнее, чем в терминале: план открывается полноценным Markdown-документом, и в нём можно оставлять комментарии прямо по строкам — агент их учтёт до начала работы.
ПолезноНа незнакомом проекте начинайте с Manual, даже если Auto стоит по умолчанию. Первые двадцать подтверждений показывают, что агент вообще собирается делать, — это дешевле любой инструкции.
5. Работать с выделением
Агент автоматически видит выделенный вами текст. Чтобы вставить в запрос ссылку на конкретные строки — Option+K (Mac) или Alt+K (Windows, Linux): в поле ввода появится упоминание вида @file.ts#5-10.
Это тот случай, где панель выигрывает у терминала очевидно: объяснить словами, о каком куске речь, всегда дольше, чем выделить его.
6. Смотреть изменения
В режиме Manual каждая правка показывается сравнением «было — стало» прямо в редакторе. Можно принять, отклонить или сказать, что сделать иначе.
Отдельная тонкость: если вы отредактируете предложенный текст прямо в окне сравнения перед тем, как принять, агент об этом узнает и не будет считать, что файл совпадает с его предложением. Мелочь, которая избавляет от рассинхрона.
Расширение или CLI: что выбрать
Не «или», а «когда что».
Панель удобнее, когда работа идёт вокруг кода, который вы читаете: правки по выделению, просмотр изменений, несколько разговоров в разных вкладках, история.
CLI удобнее, когда работа идёт вокруг команд: неинтерактивный режим для скриптов, запуск по расписанию, работа на удалённом сервере по SSH, конвейеры. Этого в панели нет и не будет — справочник по командам.
Многие держат оба: панель для ежедневной работы, CLI для автоматизации. Настройки, скиллы, CLAUDE.md и MCP-серверы у них общие — это один и тот же инструмент с двумя лицами.
Чем это отличается от Cursor
Вопрос возникает сразу, потому что расширение ставится и в Cursor тоже.
Cursor — редактор со встроенным ИИ: дополнения по ходу набора, правки по выделению, своя модельная логика. Claude Code — агент, которому делегируют задачу целиком, а он сам решает, какие файлы читать и менять. Поставив расширение в Cursor, вы получаете оба подхода в одном окне.
Развёрнутое сравнение — Claude Code vs Cursor.
Коротко о главном
- Нужен VS Code 1.94+ и платная подписка Claude либо аккаунт Console; API-ключ не требуется.
- Расширение ставится из магазина за минуту, работает и в форках VS Code, включая Cursor.
- Панель приносит свою копию CLI; отдельная установка нужна только для
claudeво встроенном терминале. - Четыре режима разрешений; на незнакомом проекте начинайте с Manual, крупные задачи — через Plan.
Option+K/Alt+Kвставляет ссылку на выделенные строки — главное преимущество панели над терминалом.- Панель и CLI не конкурируют: первая для работы руками, второй для автоматизации.
Дальше: первый день работы по шагам, подключение MCP-серверов, плагины.