Claude Code в VS Code: установка расширения и работа

Claude Code встраивается в VS Code двумя путями: поставить официальное расширение «Claude Code for VS Code» из маркетплейса (издатель - Anthropic) или просто запустить claude в интегрированном терминале, тогда расширение установится само. Нужны VS Code версии 1.94 и новее и платный тариф Claude (Pro или Max) либо оплата по факту через Claude Console. После подключения в редакторе появляется графическая панель: inline-диффы правок, контекст выделенного кода, история сессий.

Раньше Claude Code был чисто терминальной историей: сидишь в одном окне, код смотришь в другом. Расширение убирает этот разрыв - изменения видно прямо в редакторе, и принимать их можно там же. Ниже разберу оба способа установки, что конкретно даёт интеграция и какие грабли собраны за вас.

Что такое Claude Code для VS Code

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

Расширение официальное, издатель - Anthropic, бесплатное. Установок у него уже больше 24 миллионов, обновляется чуть ли не ежедневно. Внутри расширения лежит своя копия CLI, так что если работаешь только через панель, отдельно ничего ставить не нужно. Но команда claude в терминале из этого сама не появится - терминальная версия ставится отдельно, и об этом ниже.

Что нужно до установки

Список короткий:

• VS Code 1.94 или новее. Старые версии расширение просто не подтянет, так что обнови редактор заранее.
• Аккаунт Claude с платным тарифом - Pro, Max, Team или Enterprise. Либо аккаунт Claude Console с оплатой по факту использования, без подписки. Бесплатного плана с доступом к Claude Code сейчас нет.
• Доступ из России. России нет в списке поддерживаемых стран Anthropic - ни для сайта, ни для API. Вопрос решается VPN и правильным аккаунтом, я подробно разбирал это в статье Claude Code в России.

Установка расширения из маркетплейса

Классический путь - через панель расширений:

1. Открой VS Code и нажми Ctrl+Shift+X (на Mac Cmd+Shift+X).
2. В поиске набери «Claude Code».
3. Выбери расширение Claude Code for VS Code от издателя anthropic и нажми Install.

Можно и без поиска: на официальной странице документации есть прямая ссылка vscode:extension/anthropic.claude-code, по ней VS Code откроется и поставит расширение сам.

После установки слева в тулбаре редактора появится иконка Claude - через неё открывается панель. Работает это и в форках: Cursor, Kiro и прочие ставят то же расширение через свой маркетплейс, а для редакторов на Open VSX есть своя копия там.

Если вместо редактора ты больше сидишь в терминале, этот шаг можно вообще пропустить - есть путь без ручной установки.

Способ без установки: запусти claude в терминале

У Claude Code есть нативная установка отдельным бинарником (я расписывал её в гайде по установке). Если CLI уже стоит, достаточно открыть в VS Code интегрированный терминал (Ctrl+``) и набрать claude` - интеграция включится автоматически.

Приятная деталь: если расширения в редакторе нет, CLI поставит его сам. Этим управляет настройка autoInstallIdeExtension, включённая по умолчанию. Обратное тоже верно: если ты расширение удалил, а потом запустил claude в терминале VS Code - оно вернётся. Отключается это через CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1 или выключение той же настройки в /config.

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

Что даёт интеграция в редакторе

Вот ради чего всё затевается.

Графическая панель. Открывается иконкой в тулбаре, из Activity Bar или через Command Palette. Панель можно перетащить в любую сторону редактора или оставить как вкладку. Anthropic прямо называет её рекомендуемым способом работы с Claude Code в VS Code.

Inline-диффы. Когда Claude предлагает правки, в ручном режиме открывается сравнение бок о бок: слева оригинал, справа предложение. Принять, отклонить или поправить можно прямо в этом виде, не прыгая в терминал. Режимов разрешения несколько: Auto (правит сам), Manual (спрашивает по каждому файлу), Plan (сначала показывает план работ).

Выделение как контекст. Выделил кусок кода - Claude его уже видит, в футере панели показывается число выделенных строк. Хочешь сослаться точнее - нажми Option+K (на Windows Alt+K), и в промпт вставится упоминание вида @file.ts#5-10 с конкретными строками.

Контекст без копипасты. Через @ подтягиваются файлы и папки с нечётким поиском, а @terminal отдаёт Claude вывод терминала - не надо копировать логи ошибки руками.

Сессии. История бесед с поиском, несколько параллельных разговоров в табах, чекпоинты с откатом состояния. Облачные сессии из claude.ai подтягиваются во вкладке Web.

Чего в расширении нет

Честно про ограничения, потому что они есть:

• Команды панели - подмножество CLI. Часть slash-команд доступна только в терминальной версии.
• Нет шортката ! для bash-команд и tab completion из терминала.
• MCP-серверы подключаются только через CLI командой claude mcp add - я разбирал это в статье про MCP-серверы. Внутри панели ими можно управлять через /mcp, но добавление - только из терминала.

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

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

Самые частые проблемы и официальные фиксы:

• Иконки Claude нет в тулбаре. Открой какой-нибудь файл (не просто папку), проверь версию VS Code, выполни Developer: Reload Window. В Restricted Mode расширение не работает вообще - доверяй рабочей папке. Ещё вариант - конфликт с другими AI-расширениями вроде Cline или Continue.
• «Claude Code never responds». Проверь соединение и начни новый разговор; запуск claude в терминале покажет ошибку подробнее.
• «Not logged in». Reload window; если вход не подхватывается - см. Tip про запуск code . выше.
• IDE не находится при автоподключении. Бывает под tmux - выставь CLAUDE_CODE_AUTO_CONNECT_IDE=true, это форсирует попытку подключения. Для WSL есть CLAUDE_CODE_IDE_HOST_OVERRIDE.
• Cmd+Esc не работает на Mac. Системный шорткат Game Overlay в новых macOS перехватывает нажатие - отключи его в настройках клавиатуры.

А как же JetBrains

Для IntelliJ IDEA, PyCharm, WebStorm и остальной линейки есть официальный плагин «Claude Code [Beta]» в JetBrains Marketplace. Ключевое отличие от VS Code: он не несёт CLI внутри - нужен отдельно установленный claude в PATH, иначе плагин не запустится. Фичи похожие: диффы в нативном просмотрщике, автоподхват выделения, ссылки на файлы со строками. Команда /ide из внешнего терминала подключается и к JetBrains, и плагин тоже ставит сама.

Итог

Спор «терминал или редактор» с расширением Claude Code в VS Code закрылся: ставишь расширение из маркетплейса или просто запускаешь claude в терминале - и получаешь оба мира сразу. Начни с панели в повседневной работе, а терминал держи под рукой для MCP и остальной настройки. Если доступа из России нет - начни с разбора про подключение и оплату, дальше всё пойдёт по шагам выше.