
Расширение 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.Как это работает
После установки вы можете начать использовать Claude Code через интерфейс VS Code:- Нажмите на значок Spark на боковой панели редактора, чтобы открыть панель Claude Code
- Запросите Claude Code так же, как вы это делали бы в терминале
- Смотрите, как Claude анализирует ваш код и предлагает изменения
- Просмотрите и примите правки непосредственно в интерфейсе
- Совет: Перетащите боковую панель шире, чтобы увидеть встроенные различия, затем нажмите на них, чтобы развернуть для полных деталей
Использование сторонних поставщиков (Vertex и Bedrock)
Расширение VS Code поддерживает использование Claude Code со сторонними поставщиками, такими как Amazon Bedrock и Google Vertex AI. При настройке с этими поставщиками расширение не будет запрашивать вход. Для использования сторонних поставщиков настройте переменные окружения в параметрах расширения VS Code:- Откройте параметры VS Code
- Найдите “Claude Code: Environment Variables”
- Добавьте необходимые переменные окружения
Переменные окружения
| Переменная | Описание | Обязательно | Пример |
|---|---|---|---|
CLAUDE_CODE_USE_BEDROCK | Включить интеграцию Amazon Bedrock | Требуется для Bedrock | "1" или "true" |
CLAUDE_CODE_USE_VERTEX | Включить интеграцию Google Vertex AI | Требуется для Vertex AI | "1" или "true" |
ANTHROPIC_API_KEY | Ключ API для доступа третьей стороны | Требуется | "your-api-key" |
AWS_REGION | Регион AWS для Bedrock | "us-east-2" | |
AWS_PROFILE | Профиль AWS для аутентификации Bedrock | "your-profile" | |
CLOUD_ML_REGION | Регион для Vertex AI | "global" или "us-east5" | |
ANTHROPIC_VERTEX_PROJECT_ID | ID проекта GCP для Vertex AI | "your-project-id" | |
ANTHROPIC_MODEL | Переопределить основную модель | Переопределить ID модели | "us.anthropic.claude-sonnet-4-5-20250929-v1:0" |
ANTHROPIC_SMALL_FAST_MODEL | Переопределить малую/быструю модель | Опционально | "us.anthropic.claude-3-5-haiku-20241022-v1:0" |
CLAUDE_CODE_SKIP_AUTH_LOGIN | Отключить все запросы на вход | Опционально | "1" или "true" |
Еще не реализовано
Следующие функции еще недоступны в расширении VS Code:- Полная конфигурация MCP-сервера: Вам нужно сначала настроить MCP-серверы через CLI, затем расширение будет их использовать
- Конфигурация подагентов: Настройте подагентов через CLI, чтобы использовать их в VS Code
- Контрольные точки: Сохраняйте и восстанавливайте состояние разговора в определенных точках
- Продвинутые сочетания клавиш:
- Сочетание клавиш
#для добавления в память - Сочетание клавиш
!для прямого запуска команд bash
- Сочетание клавиш
- Завершение табуляции: Завершение пути файла с помощью клавиши tab
Соображения безопасности
Когда Claude Code работает в VS Code с включенными разрешениями на автоматическое редактирование, он может быть в состоянии изменять файлы конфигурации IDE, которые могут быть автоматически выполнены вашей IDE. Это может увеличить риск запуска Claude Code в режиме автоматического редактирования и позволить обойти запросы разрешений Claude Code для выполнения bash. При запуске в VS Code рассмотрите:- Включение VS Code Restricted Mode для ненадежных рабочих пространств
- Использование режима ручного одобрения для правок
- Особую осторожность, чтобы убедиться, что Claude используется только с надежными запросами
Устаревшая интеграция CLI
Первая интеграция VS Code, которую мы выпустили, позволяет Claude Code, работающему в терминале, взаимодействовать с вашей IDE. Она обеспечивает совместное использование контекста выделения (текущее выделение/вкладка автоматически передается Claude Code), просмотр различий в IDE вместо терминала, сочетания клавиш для ссылок на файлы (Cmd+Option+K на Mac или Alt+Ctrl+K на Windows/Linux для вставки ссылок на файлы, таких как @File#L1-99), и автоматическое совместное использование диагностики (ошибки lint и синтаксиса).
Устаревшая интеграция автоматически устанавливается при запуске 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должна быть доступна
- VS Code: команда
- Если команда не установлена:
- Откройте палитру команд с помощью
Cmd+Shift+P(Mac) илиCtrl+Shift+P(Windows/Linux) - Найдите “Shell Command: Install ‘code’ command in PATH” (или эквивалент для вашей IDE)
- Откройте палитру команд с помощью