Перейти к основному содержанию
Claude Code VS Code Extension Interface

Расширение 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:
  1. Нажмите на значок Spark на боковой панели редактора, чтобы открыть панель Claude Code
  2. Запросите Claude Code так же, как вы это делали бы в терминале
  3. Смотрите, как Claude анализирует ваш код и предлагает изменения
  4. Просмотрите и примите правки непосредственно в интерфейсе
    • Совет: Перетащите боковую панель шире, чтобы увидеть встроенные различия, затем нажмите на них, чтобы развернуть для полных деталей

Использование сторонних поставщиков (Vertex и Bedrock)

Расширение VS Code поддерживает использование Claude Code со сторонними поставщиками, такими как Amazon Bedrock и Google Vertex AI. При настройке с этими поставщиками расширение не будет запрашивать вход. Для использования сторонних поставщиков настройте переменные окружения в параметрах расширения VS Code:
  1. Откройте параметры VS Code
  2. Найдите “Claude Code: Environment Variables”
  3. Добавьте необходимые переменные окружения

Переменные окружения

ПеременнаяОписаниеОбязательноПример
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_IDID проекта 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 должна быть доступна
  • Если команда не установлена:
    1. Откройте палитру команд с помощью Cmd+Shift+P (Mac) или Ctrl+Shift+P (Windows/Linux)
    2. Найдите “Shell Command: Install ‘code’ command in PATH” (или эквивалент для вашей IDE)
Для дополнительной помощи см. наше руководство по устранению неполадок.