Предварительные требования
Перед установкой убедитесь, что у вас есть:- VS Code версии 1.98.0 или выше
- Учётная запись Anthropic (вы войдёте при первом открытии расширения). Если вы используете поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Vertex AI, см. вместо этого Использование поставщиков третьей стороны.
Установка расширения
Нажмите на ссылку для вашей IDE для прямой установки: Или в VS Code нажмитеCmd+Shift+X (Mac) или Ctrl+Shift+X (Windows/Linux) для открытия представления расширений, найдите “Claude Code” и нажмите Установить.
Если расширение не появляется после установки, перезагрузите VS Code или выполните “Developer: Reload Window” из палитры команд.
Начало работы
После установки вы можете начать использовать Claude Code через интерфейс VS Code:Откройте панель Claude Code
По всему VS Code значок Spark указывает на Claude Code: 
Самый быстрый способ открыть Claude — нажать на значок Spark в панели инструментов редактора (верхний правый угол редактора). Значок появляется только при открытом файле.
Самый быстрый способ открыть Claude — нажать на значок Spark в панели инструментов редактора (верхний правый угол редактора). Значок появляется только при открытом файле.- Activity Bar: нажмите на значок Spark в левой боковой панели для открытия списка сеансов. Нажмите на любой сеанс для открытия его как полной вкладки редактора или начните новый. Этот значок всегда виден в Activity Bar.
- Command Palette:
Cmd+Shift+P(Mac) илиCtrl+Shift+P(Windows/Linux), введите “Claude Code” и выберите опцию, например “Open in New Tab” - Status Bar: нажмите ✱ Claude Code в нижнем правом углу окна. Это работает даже при отсутствии открытого файла.
Отправьте подсказку
Попросите Claude помочь с вашим кодом или файлами, будь то объяснение того, как что-то работает, отладка проблемы или внесение изменений.Вот пример вопроса о конкретной строке в файле:
Использование поля подсказки
Поле подсказки поддерживает несколько функций:- Режимы разрешения: нажмите на индикатор режима в нижней части поля подсказки для переключения режимов. В обычном режиме Claude запрашивает разрешение перед каждым действием. В Plan Mode Claude описывает, что он будет делать, и ждёт одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ markdown, где вы можете добавлять встроенные комментарии для обратной связи перед началом работы Claude. В режиме автоматического принятия Claude вносит правки без запроса. Установите значение по умолчанию в параметрах VS Code в разделе
claudeCode.initialPermissionMode. - Меню команд: нажмите
/или введите/для открытия меню команд. Опции включают присоединение файлов, переключение моделей, переключение расширенного мышления и просмотр использования плана (/usage). Раздел Customize предоставляет доступ к MCP servers, hooks, памяти, разрешениям и plugins. Элементы со значком терминала открываются во встроенном терминале. - Индикатор контекста: поле подсказки показывает, сколько context window Claude вы используете. Claude автоматически выполняет компактизацию при необходимости, или вы можете выполнить
/compactвручную. - Расширенное мышление: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Включите его через меню команд (
/). Подробности см. в разделе Расширенное мышление. - Многострочный ввод: нажмите
Shift+Enterдля добавления новой строки без отправки. Это также работает в поле свободного текста “Other” диалогов вопросов.
Ссылка на файлы и папки
Используйте @-упоминания для предоставления Claude контекста о конкретных файлах или папках. Когда вы вводите@ с последующим именем файла или папки, Claude читает это содержимое и может ответить на вопросы о нём или внести в него изменения. Claude Code поддерживает нечёткое совпадение, поэтому вы можете вводить частичные имена для поиска того, что вам нужно:
Option+K (Mac) / Alt+K (Windows/Linux) для вставки @-упоминания с путём файла и номерами строк (например, @app.ts#5-10). Нажмите на индикатор выделения для переключения видимости вашего выделенного текста для Claude — значок с косой чертой означает, что выделение скрыто от Claude.
Вы также можете удерживать Shift при перетаскивании файлов в поле подсказки для добавления их как вложений. Нажмите X на любом вложении для удаления его из контекста.
Возобновление прошлых бесед
Нажмите на раскрывающееся меню в верхней части панели Claude Code для доступа к истории ваших бесед. Вы можете искать по ключевому слову или просматривать по времени (Today, Yesterday, Last 7 days и т. д.). Нажмите на любую беседу для её возобновления с полной историей сообщений. Наведите курсор на сеанс для открытия действий переименования и удаления: переименуйте для присвоения ему описательного названия или удалите для удаления его из списка. Дополнительную информацию о возобновлении сеансов см. в разделе Распространённые рабочие процессы.Возобновление удалённых сеансов из Claude.ai
Если вы используете Claude Code в веб-версии, вы можете возобновить эти удалённые сеансы непосредственно в VS Code. Это требует входа с помощью Claude.ai Subscription, а не Anthropic Console.Откройте прошлые беседы
Нажмите на раскрывающееся меню Past Conversations в верхней части панели Claude Code.
Выберите вкладку Remote
Диалог показывает две вкладки: Local и Remote. Нажмите Remote для просмотра сеансов из claude.ai.
Только веб-сеансы, начатые с репозитория GitHub, появляются на вкладке Remote. Возобновление загружает историю беседы локально; изменения не синхронизируются обратно в claude.ai.
Настройка вашего рабочего процесса
После того как вы начнёте работать, вы можете переместить панель Claude, запустить несколько сеансов или переключиться на режим терминала.Выберите, где находится Claude
Вы можете перетащить панель Claude для её переместить в любое место VS Code. Возьмите вкладку или заголовок панели и перетащите её в:- Secondary sidebar: правая сторона окна. Держит Claude видимым во время кодирования.
- Primary sidebar: левая боковая панель со значками для Explorer, Search и т. д.
- Editor area: открывает Claude как вкладку рядом с вашими файлами. Полезно для побочных задач.
Запуск нескольких бесед
Используйте Open in New Tab или Open in New Window из палитры команд для начала дополнительных бесед. Каждая беседа сохраняет свою собственную историю и контекст, позволяя вам работать над различными задачами параллельно. При использовании вкладок небольшая цветная точка на значке spark указывает статус: синий означает, что запрос разрешения ожидает, оранжевый означает, что Claude завершил работу, пока вкладка была скрыта.Переключение на режим терминала
По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте параметр Use Terminal и установите флажок. Вы также можете открыть параметры VS Code (Cmd+, на Mac или Ctrl+, на Windows/Linux), перейти в Extensions → Claude Code и установить флажок Use Terminal.
Управление plugins
Расширение VS Code включает графический интерфейс для установки и управления plugins. Введите/plugins в поле подсказки для открытия интерфейса Manage plugins.
Установка plugins
Диалог plugin показывает две вкладки: Plugins и Marketplaces. На вкладке Plugins:- Установленные plugins появляются в верхней части с переключателями для их включения или отключения
- Доступные plugins из ваших настроенных marketplaces появляются ниже
- Поиск для фильтрации plugins по имени или описанию
- Нажмите Install на любом доступном plugin
- Install for you: доступно во всех ваших проектах (область пользователя)
- Install for this project: общее использование с сотрудниками проекта (область проекта)
- Install locally: только для вас, только в этом репозитории (локальная область)
Управление marketplaces
Переключитесь на вкладку Marketplaces для добавления или удаления источников plugins:- Введите репозиторий GitHub, URL или локальный путь для добавления нового marketplace
- Нажмите на значок обновления для обновления списка plugins marketplace
- Нажмите на значок корзины для удаления marketplace
Управление plugins в VS Code использует те же команды CLI под капотом. Plugins и marketplaces, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.
Автоматизация задач браузера с помощью Chrome
Подключите Claude к вашему браузеру Chrome для тестирования веб-приложений, отладки с помощью логов консоли и автоматизации рабочих процессов браузера без выхода из VS Code. Это требует расширения Claude in Chrome версии 1.0.36 или выше. Введите@browser в поле подсказки с последующим описанием того, что вы хотите, чтобы Claude сделал:
Команды и сочетания клавиш VS Code
Откройте палитру команд (Cmd+Shift+P на Mac или Ctrl+Shift+P на Windows/Linux) и введите “Claude Code” для просмотра всех доступных команд VS Code для расширения Claude Code.
Некоторые сочетания клавиш зависят от того, какая панель “сфокусирована” (получает ввод с клавиатуры). Когда ваш курсор находится в файле кода, редактор сфокусирован. Когда ваш курсор находится в поле подсказки Claude, Claude сфокусирован. Используйте Cmd+Esc / Ctrl+Esc для переключения между ними.
Это команды VS Code для управления расширением. Не все встроенные команды Claude Code доступны в расширении. Подробности см. в разделе Расширение VS Code и CLI Claude Code.
| Команда | Сочетание клавиш | Описание |
|---|---|---|
| Focus Input | Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) | Переключение фокуса между редактором и Claude |
| Open in Side Bar | - | Открыть Claude в левой боковой панели |
| Open in Terminal | - | Открыть Claude в режиме терминала |
| Open in New Tab | Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) | Открыть новую беседу как вкладку редактора |
| Open in New Window | - | Открыть новую беседу в отдельном окне |
| New Conversation | Cmd+N (Mac) / Ctrl+N (Windows/Linux) | Начать новую беседу (требует фокуса Claude) |
| Insert @-Mention Reference | Option+K (Mac) / Alt+K (Windows/Linux) | Вставить ссылку на текущий файл и выделение (требует фокуса редактора) |
| Show Logs | - | Просмотр логов отладки расширения |
| Logout | - | Выход из вашей учётной записи Anthropic |
Настройка параметров
Расширение имеет два типа параметров:- Параметры расширения в VS Code: управляют поведением расширения в VS Code. Откройте с помощью
Cmd+,(Mac) илиCtrl+,(Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести/и выбрать General Config для открытия параметров. - Параметры Claude Code в
~/.claude/settings.json: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP servers. Подробности см. в разделе Settings.
Параметры расширения
| Параметр | По умолчанию | Описание |
|---|---|---|
selectedModel | default | Модель для новых бесед. Измените для каждого сеанса с помощью /model. |
useTerminal | false | Запустить Claude в режиме терминала вместо графической панели |
initialPermissionMode | default | Управляет подсказками одобрения: default (спросить каждый раз), plan, acceptEdits или bypassPermissions |
preferredLocation | panel | Где открывается Claude: sidebar (справа) или panel (новая вкладка) |
autosave | true | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |
useCtrlEnterToSend | false | Использовать Ctrl/Cmd+Enter вместо Enter для отправки подсказок |
enableNewConversationShortcut | true | Включить Cmd/Ctrl+N для начала новой беседы |
hideOnboarding | false | Скрыть контрольный список адаптации (значок выпускной шапки) |
respectGitIgnore | true | Исключить шаблоны .gitignore из поиска файлов |
environmentVariables | [] | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |
disableLoginPrompt | false | Пропустить подсказки аутентификации (для настроек поставщика третьей стороны) |
allowDangerouslySkipPermissions | false | Обойти все подсказки разрешения. Используйте с крайней осторожностью. |
claudeProcessWrapper | - | Путь исполняемого файла, используемый для запуска процесса Claude |
Расширение VS Code и CLI Claude Code
Claude Code доступен как расширение VS Code (графическая панель), так и CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, выполнитеclaude во встроенном терминале VS Code.
| Функция | CLI | Расширение VS Code |
|---|---|---|
| Команды и skills | Все | Подмножество (введите / для просмотра доступных) |
| Конфигурация MCP server | Да | Частично (добавьте servers через CLI; управляйте существующими servers с помощью /mcp в панели чата) |
| Checkpoints | Да | Да |
Сокращение ! bash | Да | Нет |
| Завершение вкладки | Да | Нет |
Перемотка с checkpoints
Расширение VS Code поддерживает checkpoints, которые отслеживают правки файлов Claude и позволяют вам перемотать в предыдущее состояние. Наведите курсор на любое сообщение для открытия кнопки перемотки, затем выберите один из трёх вариантов:- Fork conversation from here: начать новую ветвь беседы из этого сообщения, сохраняя все изменения кода
- Rewind code to here: отменить изменения файлов до этой точки в беседе, сохраняя полную историю беседы
- Fork conversation and rewind code: начать новую ветвь беседы и отменить изменения файлов до этой точки
Запуск CLI в VS Code
Для использования CLI, оставаясь в VS Code, откройте встроенный терминал (Ctrl+` на Windows/Linux или Cmd+` на Mac) и выполните claude. CLI автоматически интегрируется с вашей IDE для функций, таких как просмотр diff и обмен диагностикой.
Если вы используете внешний терминал, выполните /ide внутри Claude Code для подключения его к VS Code.
Переключение между расширением и CLI
Расширение и CLI совместно используют одну и ту же историю бесед. Для продолжения беседы расширения в CLI выполнитеclaude --resume в терминале. Это открывает интерактивный выбор, где вы можете найти и выбрать вашу беседу.
Включение вывода терминала в подсказки
Ссылайтесь на вывод терминала в ваших подсказках, используя@terminal:name, где name — это название терминала. Это позволяет Claude видеть вывод команды, сообщения об ошибках или логи без копирования и вставки.
Мониторинг фоновых процессов
Когда Claude запускает долгоживущие команды, расширение показывает прогресс в строке состояния. Однако видимость фоновых задач ограничена по сравнению с CLI. Для лучшей видимости попросите Claude вывести команду, чтобы вы могли выполнить её во встроенном терминале VS Code.Подключение к внешним инструментам с помощью MCP
MCP (Model Context Protocol) servers предоставляют Claude доступ к внешним инструментам, базам данных и API. Для добавления MCP server откройте встроенный терминал (Ctrl+` или Cmd+`) и выполните:
/mcp в панель чата. Диалог управления MCP позволяет вам включать или отключать servers, переподключаться к server и управлять аутентификацией OAuth. Доступные servers см. в документации MCP.
Работа с git
Claude Code интегрируется с git для помощи в рабочих процессах управления версиями непосредственно в VS Code. Попросите Claude совершить изменения, создать pull requests или работать между ветвями.Создание commits и pull requests
Claude может подготавливать изменения, писать сообщения commit и создавать pull requests на основе вашей работы:Использование git worktrees для параллельных задач
Используйте флаг--worktree (-w) для запуска Claude в изолированном worktree с собственными файлами и ветвью:
Использование поставщиков третьей стороны
По умолчанию Claude Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Vertex AI или Microsoft Foundry для доступа к Claude, настройте расширение для использования вашего поставщика вместо этого:Отключение подсказки входа
Откройте параметр Disable Login Prompt и установите флажок.Вы также можете открыть параметры VS Code (
Cmd+, на Mac или Ctrl+, на Windows/Linux), найти “Claude Code login” и установить флажок Disable Login Prompt.Настройка вашего поставщика
Следуйте руководству по настройке для вашего поставщика:Эти руководства охватывают настройку вашего поставщика в
~/.claude/settings.json, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.Безопасность и конфиденциальность
Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробности об обработке данных и о том, как отказаться от логирования, см. в разделе Data and privacy. С включёнными разрешениями на автоматическое редактирование Claude Code может изменять файлы конфигурации VS Code (такие какsettings.json или tasks.json), которые VS Code может выполнять автоматически. Для снижения риска при работе с ненадёжным кодом:
- Включите VS Code Restricted Mode для ненадёжных рабочих пространств
- Используйте режим ручного одобрения вместо автоматического принятия для правок
- Тщательно проверяйте изменения перед их принятием
Исправление распространённых проблем
Расширение не устанавливается
- Убедитесь, что у вас есть совместимая версия VS Code (1.98.0 или выше)
- Проверьте, что VS Code имеет разрешение на установку расширений
- Попробуйте установить непосредственно из VS Code Marketplace
Значок Spark не виден
Значок Spark появляется в панели инструментов редактора (верхний правый угол редактора) при открытом файле. Если вы его не видите:- Откройте файл: Значок требует открытого файла. Просто открытая папка недостаточна.
- Проверьте версию VS Code: Требуется 1.98.0 или выше (Help → About)
- Перезагрузите VS Code: Выполните “Developer: Reload Window” из палитры команд
- Отключите конфликтующие расширения: Временно отключите другие расширения AI (Cline, Continue и т. д.)
- Проверьте доверие рабочего пространства: Расширение не работает в Restricted Mode
Cmd+Shift+P / Ctrl+Shift+P) и ввести “Claude Code”.
Claude Code никогда не отвечает
Если Claude Code не отвечает на ваши подсказки:- Проверьте подключение к интернету: Убедитесь, что у вас есть стабильное подключение к интернету
- Начните новую беседу: Попробуйте начать свежую беседу, чтобы увидеть, сохраняется ли проблема
- Попробуйте CLI: Выполните
claudeиз терминала, чтобы увидеть, получите ли вы более подробные сообщения об ошибках
Удаление расширения
Для удаления расширения Claude Code:- Откройте представление расширений (
Cmd+Shift+Xна Mac илиCtrl+Shift+Xна Windows/Linux) - Найдите “Claude Code”
- Нажмите Uninstall
Следующие шаги
Теперь, когда у вас есть Claude Code, установленный в VS Code:- Изучите распространённые рабочие процессы для получения максимальной пользы от Claude Code
- Настройте MCP servers для расширения возможностей Claude с помощью внешних инструментов. Добавьте servers с помощью CLI, затем управляйте ими с помощью
/mcpв панели чата. - Настройте параметры Claude Code для настройки разрешённых команд, hooks и многого другого. Эти параметры общие для расширения и CLI.