Как использовать Claude Code с VS Code?
Claude Code — это ИИ-ассистент Anthropic, разработанный для программистов. Доступный непосредственно в VS Code через официальное расширение, он позволяет генерировать, изменять, анализировать и отлаживать код, не покидая редактор. С 2025 года нативное расширение является рекомендуемым способом использования Claude Code в VS Code — вот как его установить и получить максимальную отдачу.
Требования перед установкой
Перед установкой расширения Claude Code проверьте следующее:
- VS Code 1.98.0 или выше — более ранние версии несовместимы с расширением
- Учётная запись Anthropic — вы войдёте в систему при первом открытии расширения. Claude Code требует подписки Claude Pro, Max, Team или Enterprise
- При использовании Amazon Bedrock или Google Vertex AI в качестве провайдера требуется специальная конфигурация в settings.json
Установка расширения Claude Code
Установка занимает несколько секунд прямо из VS Code:
- Откройте VS Code и нажмите Ctrl+Shift+X (Windows/Linux) или Cmd+Shift+X (Mac) для открытия панели Расширения
- Введите "Claude Code" в строке поиска
- Установите расширение, опубликованное компанией Anthropic — тщательно проверьте издателя, чтобы избежать неофициальных расширений третьих сторон
- Если иконка Spark не появляется после установки, перезапустите VS Code или выполните "Developer: Reload Window" из палитры команд
Полезно знать: расширение автоматически включает CLI (интерфейс командной строки) Claude Code. Устанавливать CLI отдельно не нужно — он доступен прямо из встроенного терминала VS Code для расширенных функций.
Открытие Claude Code в VS Code
После установки расширения иконка Spark (⚡) идентифицирует Claude Code во всём интерфейсе VS Code. Несколько способов доступа:
- Панель инструментов редактора: нажмите иконку Spark в правом верхнем углу редактора — видна только когда открыт файл
- Панель активности: нажмите иконку Spark на левой боковой панели для открытия списка сессий. Всегда видна даже без открытого файла
- Палитра команд: Cmd+Shift+P / Ctrl+Shift+P, введите "Claude Code" и выберите "Open in New Tab"
- Строка состояния: нажмите ✱ Claude Code в правом нижнем углу окна
При первом открытии панели появляется контрольный список вводного руководства. Проработайте каждый пункт, нажав "Show me", или закройте его крестиком.
Отправка первого запроса
Claude Code автоматически видит файл, открытый в редакторе. Для взаимодействия:
- Выделите код в файле — Claude Code автоматически включает это выделение в контекст запроса
- Нажмите Option+K (Mac) / Alt+K (Windows/Linux) для вставки ссылки @файл.ts#5-10 на выделение в промпт
- Введите запрос на естественном языке: "Объясни эту функцию", "Исправь этот баг", "Добавь юнит-тесты для этого класса"…
Когда Claude Code предлагает изменить файл, он показывает сравнение diff бок о бок с предлагаемыми изменениями перед их применением. Вы можете принять, отклонить или запросить корректировки.
Режимы разрешений
Claude Code предлагает три режима разрешений, доступные в нижней части поля промпта:
| Режим | Поведение | Рекомендуемое использование |
|---|---|---|
| Обычный | Claude запрашивает подтверждение перед каждым действием | Повседневное использование, точный контроль |
| Plan | Claude описывает, что будет делать, и ждёт вашего одобрения перед внесением изменений | Сложные задачи, крупные рефакторинги |
| Auto-accept | Claude вносит изменения без запроса | Повторяющиеся задачи, быстрое прототипирование |
Режим Plan особенно полезен для значительных изменений: Claude открывает план как документ Markdown, в который можно добавлять встроенные комментарии до начала модификации кода.
Ссылки на файлы через @-упоминания
Для предоставления Claude Code дополнительного контекста используйте @-упоминания в промпте:
- Введите @ с именем файла для его упоминания: @auth.ts
- Добавьте диапазон строк для точного указания раздела: @auth.ts#10-25
- Упомяните целую папку: @src/components/
- Используйте Option+K / Alt+K из выделения для автоматической вставки ссылки
Управление несколькими разговорами
VS Code позволяет одновременно открывать несколько сессий Claude Code — удобно для параллельной работы над несколькими функциями или папками workspace:
- Каждая сессия сохраняет свой независимый контекст
- Открывайте новый разговор с помощью Cmd+N (Mac) / Ctrl+N (Windows/Linux) из панели Claude
- Получайте доступ к истории разговоров через иконку Spark на панели активности
- Сессии можно открывать как отдельные вкладки или окна по вашему усмотрению
Полезно знать: при работе над монорепозиторием или проектом микросервисов каждая папка workspace может иметь собственную сессию Claude Code с собственным контекстом. Для настройки поведения Claude в вашем проекте создайте файл CLAUDE.md в корне репозитория — Claude Code автоматически прочитает его для адаптации ответов к проекту, соглашениям и конкретным инструкциям.
Использование CLI из встроенного терминала
Расширение VS Code включает CLI Claude Code, доступный из встроенного терминала VS Code. CLI предлагает расширенные функции, недоступные в графическом интерфейсе:
- Запустите claude во встроенном терминале для начала сессии CLI
- Используйте claude -p "ваш промпт" для неинтерактивных запросов (режим print)
- Команда /terminal-setup в сессии автоматически настраивает сочетание клавиш Shift+Enter для многострочных промптов
- Переключайтесь между графическим интерфейсом и CLI через меню настроек расширения
Основные сочетания клавиш
| Действие | Mac | Windows / Linux |
|---|---|---|
| Открыть панель Расширения | Cmd+Shift+X | Ctrl+Shift+X |
| Палитра команд | Cmd+Shift+P | Ctrl+Shift+P |
| Вставить @-упоминание из выделения | Option+K | Alt+K |
| Переключить фокус редактор / Claude | Cmd+Esc | Ctrl+Esc |
| Новый разговор | Cmd+N | Ctrl+N |
Полезно знать: Claude Code для VS Code также работает с Cursor, Windsurf и VSCodium — процедура установки идентична. Для команд, использующих Amazon Bedrock или Google Vertex AI, добавьте соответствующие переменные окружения в файл settings.json VS Code для настройки альтернативного провайдера.
Nicolas,