Расширение VS Code (Бета)

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

Функции

Расширение VS Code предоставляет:
  • Нативный опыт IDE: Выделенная боковая панель Claude Code, доступная через иконку Spark
  • Режим планирования с редактированием: Просмотр и редактирование планов Claude перед их принятием
  • Режим автоматического принятия правок: Автоматическое применение изменений Claude по мере их внесения
  • Управление файлами: @-упоминание файлов или прикрепление файлов и изображений с помощью системного файлового выборщика
  • Использование MCP-серверов: Использование серверов Model Context Protocol, настроенных через CLI
  • История разговоров: Легкий доступ к прошлым разговорам
  • Множественные сессии: Запуск нескольких сессий Claude Code одновременно
  • Горячие клавиши: Поддержка большинства горячих клавиш из CLI
  • Слэш-команды: Доступ к большинству CLI слэш-команд непосредственно в расширении

Требования

  • VS Code 1.98.0 или выше

Установка

Скачайте и установите расширение из Visual Studio Code Extension Marketplace.

Обновление

Для обновления расширения VS Code:
  1. Откройте палитру команд VS Code с помощью Cmd+Shift+P (Mac) или Ctrl+Shift+P (Windows/Linux)
  2. Найдите “Claude Code: Update”
  3. Выберите команду для обновления до последней версии

Как это работает

После установки вы можете начать использовать Claude Code через интерфейс VS Code:
  1. Нажмите на иконку Spark в боковой панели редактора, чтобы открыть панель Claude Code
  2. Отправьте запрос Claude Code так же, как вы бы делали это в терминале
  3. Наблюдайте, как Claude анализирует ваш код и предлагает изменения
  4. Просматривайте и принимайте правки непосредственно в интерфейсе
    • Совет: Расширьте боковую панель, чтобы увидеть встроенные различия, затем нажмите на них, чтобы развернуть для полной детализации

Еще не реализовано

Следующие функции пока недоступны в расширении VS Code:
  • Полная конфигурация MCP-серверов: Вам нужно сначала настроить MCP-серверы через CLI, затем расширение будет их использовать
  • Конфигурация субагентов: Настройте субагентов через CLI, чтобы использовать их в VS Code
  • Контрольные точки: Сохранение и восстановление состояния разговора в определенных точках
  • Расширенные горячие клавиши:
    • Горячая клавиша # для добавления в память
    • Горячая клавиша ! для прямого выполнения bash-команд
  • Автодополнение по Tab: Автодополнение путей к файлам клавишей tab
Мы работаем над добавлением этих функций в будущих обновлениях.

Соображения безопасности

Когда Claude Code запускается в VS Code с включенными разрешениями на автоматическое редактирование, он может изменять файлы конфигурации IDE, которые могут автоматически выполняться вашей IDE. Это может увеличить риск запуска Claude Code в режиме автоматического редактирования и позволить обойти запросы разрешений Claude Code для выполнения bash. При работе в VS Code рассмотрите:
  • Включение Ограниченного режима VS Code для недоверенных рабочих пространств
  • Использование режима ручного одобрения для правок
  • Проявление особой осторожности, чтобы убедиться, что Claude используется только с доверенными запросами

Устаревшая интеграция с CLI

Первая интеграция с VS Code, которую мы выпустили, позволяет Claude Code, работающему в терминале, взаимодействовать с вашей IDE. Она обеспечивает совместное использование контекста выделения (текущее выделение/вкладка автоматически передается Claude Code), просмотр различий в IDE вместо терминала, горячие клавиши для ссылок на файлы (Cmd+Option+K на Mac или Alt+Ctrl+K на Windows/Linux для вставки ссылок на файлы типа @File#L1-99) и автоматическое совместное использование диагностики (ошибки линтинга и синтаксиса). Устаревшая интеграция автоматически устанавливается при запуске claude из встроенного терминала VS Code. Просто запустите claude из терминала, и все функции активируются. Для внешних терминалов используйте команду /ide для подключения Claude Code к вашему экземпляру VS Code. Для настройки запустите claude, введите /config и установите инструмент diff на auto для автоматического обнаружения IDE. И расширение, и интеграция с CLI работают с Visual Studio Code, Cursor, Windsurf и VSCodium.

Устранение неполадок

Расширение не устанавливается

  • Убедитесь, что у вас совместимая версия VS Code (1.85.0 или новее)
  • Проверьте, что VS Code имеет разрешение на установку расширений
  • Попробуйте установить напрямую с веб-сайта marketplace

Устаревшая интеграция не работает

  • Убедитесь, что вы запускаете Claude Code из встроенного терминала VS Code
  • Убедитесь, что CLI для вашего варианта IDE установлен:
    • VS Code: команда code должна быть доступна
    • Cursor: команда cursor должна быть доступна
    • Windsurf: команда windsurf должна быть доступна
    • VSCodium: команда codium должна быть доступна
  • Если команда не установлена:
    1. Откройте палитру команд с помощью Cmd+Shift+P (Mac) или Ctrl+Shift+P (Windows/Linux)
    2. Найдите “Shell Command: Install ‘code’ command in PATH” (или эквивалент для вашей IDE)
Для дополнительной помощи см. наше руководство по устранению неполадок.