Использование Claude Code в VS Code

• Просматривать и редактировать планы Claude перед их принятием
• Автоматически принимать правки по мере их внесения
• Использовать @-упоминания файлов с определёнными диапазонами строк из вашего выделения
• Получать доступ к истории диалога
• Открывать несколько диалогов в отдельных вкладках или окнах

​

Предварительные требования

• VS Code версии 1.94.0 или выше
• Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы войдёте с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud’s Agent Platform, см. Использование поставщиков третьей стороны для инструкций по настройке.

​

Установка расширения

• Установить для VS Code
• Установить для Cursor

• Другие форки VS Code: расширение также устанавливается в форках, таких как Devin Desktop или Kiro. Найдите «Claude Code» в представлении Extensions редактора или установите его из реестра Open VSX.
• Редакторы, в которые нельзя установить расширение: установите CLI и запускайте claude во встроенном терминале редактора. CLI работает в любом терминале.
• Dev-контейнеры: чтобы запустить Claude Code внутри dev-контейнера, см. раздел Контейнеры для разработки.

​

Начало работы

1

Откройте панель Claude Code

Во всём VS Code значок Spark обозначает Claude Code: Самый быстрый способ открыть Claude — нажать на значок Spark на панели инструментов редактора (правый верхний угол редактора). Значок отображается только тогда, когда у вас открыт файл.Другие способы открыть Claude Code:

• Панель действий (Activity Bar): нажмите на значок Spark на левой боковой панели, чтобы открыть список сессий. Нажмите на любую сессию, чтобы открыть её в предпочитаемом расположении, или начните новую. Этот значок всегда виден на панели действий.
• Палитра команд: Cmd+Shift+P (Mac) или Ctrl+Shift+P (Windows/Linux), введите «Claude Code» и выберите вариант, например «Open in New Tab»
• Строка состояния: нажмите ✻ Claude Code в правом нижнем углу окна. Это работает, даже когда ни один файл не открыт.

Вы можете перетащить панель Claude в любое место VS Code. Подробнее см. в разделе Настройка рабочего процесса.

2

Войдите в систему

При первом открытии панели появляется экран входа. Нажмите Sign in и завершите авторизацию в браузере.Если позже вы увидите Not logged in · Please run /login, расширение автоматически снова откроет экран входа. Если он не появился, перезагрузите окно из палитры команд с помощью Developer: Reload Window.Если в вашей оболочке задана переменная ANTHROPIC_API_KEY, но запрос на вход всё равно появляется, возможно, VS Code не унаследовал окружение вашей оболочки. Запустите VS Code из терминала командой code ., чтобы он унаследовал ваши переменные окружения, или вместо этого войдите с помощью своей учётной записи Claude.После входа появится контрольный список Learn Claude Code. Пройдите по каждому пункту, нажимая Show me, или закройте его с помощью X. Чтобы снова открыть его позже, снимите флажок Hide Onboarding в настройках VS Code в разделе Extensions > Claude Code.

3

Отправьте промпт

Попросите Claude помочь с вашим кодом или файлами — будь то объяснение того, как что-то работает, отладка проблемы или внесение изменений.

Claude автоматически видит выделенный вами текст. Нажмите Option+K (Mac) / Alt+K (Windows/Linux), чтобы также вставить в промпт ссылку с @-упоминанием (например, @file.ts#5-10).

Вот пример вопроса о конкретной строке в файле:

4

Просмотрите изменения

Проверьте режим разрешений, отображаемый в нижней части поля ввода промпта:

• В режиме Auto или Edit automatically Claude редактирует большинство файлов в вашей рабочей области, не спрашивая.
• В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного содержимого и предлагаемых изменений бок о бок, а затем запрашивает разрешение. Вы можете принять, отклонить изменения или сказать Claude, что сделать вместо этого. Если вы отредактируете предлагаемое содержимое непосредственно в представлении diff перед принятием, Claude получит информацию о том, что вы его изменили, чтобы он не предполагал, что файл соответствует его исходному предложению.

Чтобы просматривать предлагаемую правку по одному изменению за раз, используйте кнопки Accept this change и Reject this change под каждым изменением в diff. Отклонение изменения отменяет его в предлагаемом содержимом; принятие помечает его как просмотренное. Для просмотра по отдельным изменениям требуется Claude Code v2.1.275 или более поздней версии.Принятие или отклонение всего файла по-прежнему завершает просмотр. Diff, содержащий более 100 изменений, открывается без кнопок для отдельных изменений, поэтому просматривайте его как целый файл.Те же действия доступны в позиции курсора из контекстного меню редактора и из палитры команд как Claude Code: Accept Change at Cursor и Claude Code: Reject Change at Cursor.

​

Использование поля ввода промпта

• Режимы разрешений: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и более поздних версиях Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе как расширение выбирает начальный режим разрешений.
  • Auto: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе авторежим.
  • Manual: Claude запрашивает разрешение перед редактированием файлов и большинством shell-команд.
  • Plan: Claude описывает, что собирается сделать, и ждёт подтверждения, прежде чем вносить изменения. VS Code автоматически открывает план как полноценный документ Markdown, в котором можно добавлять встроенные комментарии, чтобы дать обратную связь до того, как Claude начнёт работу. Также можно ввести /plan в поле ввода промпта. Требуется Claude Code v2.1.280 или более поздней версии.
    • /plan: переключает в режим планирования. Если вы уже в режиме планирования, вместо этого показывает текущий план.
    • /plan с задачей, например /plan fix the auth bug: переключает в режим планирования и начинает планировать эту задачу.
    • /plan open: если вы уже в режиме планирования, открывает файл плана в редакторе.
  • Edit automatically: Claude вносит правки, не спрашивая.
• Модель: выберите Switch model… в меню команд, чтобы сменить модель посреди сессии. Также можно нажать на название модели внизу поля ввода промпта, чтобы открыть то же окно выбора. В Claude Code v2.1.284 и более поздних версиях окно выбора также открывается, если ввести в поле ввода промпта только /model. Если текущая модель поддерживает уровни effort, в окне выбора также отображается строка Effort, а на кнопке с названием модели показывается выбранный уровень. Если вы выбираете уровень, отличный от max, Claude Code сохраняет его для текущей модели как уровень по умолчанию в modelSettings в ваших пользовательских настройках; max применяется только к текущей сессии. Кнопка с названием модели и строка Effort требуют Claude Code v2.1.257 или более поздней версии. Если включены динамические рабочие процессы и текущая модель их поддерживает, под строкой Effort появляется переключатель Ultracode. Включите его, чтобы Claude планировал рабочий процесс для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается · Ultracode. Переключатель требует Claude Code v2.1.284 или более поздней версии.
• Меню команд: нажмите / или введите /, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение или отключение расширенного мышления. Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.
  • Чтобы просмотреть команды, такие как /usage или /remote-control, выберите Slash commands в разделе Customize. Откроется диалоговое окно со списком команд и полем фильтра. Выберите команду, чтобы выполнить её. Ввод / в поле ввода промпта по-прежнему предлагает команды прямо в строке. Требуется Claude Code v2.1.257 или более поздней версии. Ввод /skills также открывает это диалоговое окно. В каждой строке скилла отображается его видимость, например On или Name only. Нажмите на значение видимости, чтобы изменить его, за исключением строк с пометкой locked, например скиллов плагинов. Сокращение /skills и элементы управления видимостью требуют Claude Code v2.1.280 или более поздней версии.
  • Выберите Output styles в разделе Customize, чтобы выбрать стиль вывода, включая ваши пользовательские стили. Требуется Claude Code v2.1.257 или более поздней версии. Чтобы вместо этого создать пользовательский стиль, выберите Build a custom style в меню Output styles. Claude Code создаст для вас файл стиля на уровне проекта или пользователя. Требуется Claude Code v2.1.261 или более поздней версии.
  • Выберите Hooks в разделе Customize, чтобы просмотреть хуки, загруженные в сессии, сгруппированные по событиям. Можно добавлять, редактировать или удалять хуки, сохранённые в ваших файлах пользовательских, проектных и локальных настроек. Хуки из других источников, например из управляемых настроек или плагинов, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.
  • Выберите Permissions в разделе Customize, чтобы просмотреть правила разрешений сессии, сгруппированные на Allow, Ask и Deny. Можно добавлять правила в пользовательские, проектные или локальные настройки и удалять сохранённые там правила. Правила из других источников, например из управляемых настроек или подтверждений, данных только для этой сессии, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.
  • Выберите Memory в разделе Customize, чтобы включить или отключить автоматическую память. Пока она включена, можно также просматривать воспоминания, сохранённые Claude, и открывать папки, в которых они хранятся, в файловом менеджере. Требуется Claude Code v2.1.274 или более поздней версии. Нажмите на сохранённое воспоминание, чтобы прочитать его в диалоговом окне, где можно отредактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоговом окне требуют Claude Code v2.1.275 или более поздней версии.
  • Выберите Instructions в разделе Customize, чтобы редактировать файлы CLAUDE.md, которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл ещё не существует, Claude Code сначала создаст его. Требуется Claude Code v2.1.274 или более поздней версии.
  • Выберите Status в разделе Customize или введите /status, чтобы проверить версию Claude Code, учётную запись, модель и сведения о MCP-серверах для сессии. Требуется Claude Code v2.1.280 или более поздней версии.
  • Выберите Sandbox в разделе Customize или введите /sandbox, чтобы узнать, выполняются ли команды Bash от Claude в песочнице. Там же можно переключить режим песочницы и добавить исключённые команды. Требуется Claude Code v2.1.280 или более поздней версии.
  • Выберите Claude in Chrome в разделе Customize или введите /chrome, чтобы проверить подключение Claude in Chrome и управлять им. Оба способа требуют входа с учётной записью claude.ai. Требуется Claude Code v2.1.280 или более поздней версии.
  • Выберите Export conversation в разделе Context или введите /export, чтобы скопировать диалог как обычный текст или сохранить его в файл. Добавьте имя файла, например /export notes.txt, чтобы пропустить диалоговое окно и выбрать, куда сохранить файл. Требуется Claude Code v2.1.280 или более поздней версии.
  • Раздел Settings содержит пункт Enable Remote Control for all sessions, который задаёт remoteControlAtStartup и определяет, будут ли новые интерактивные сессии автоматически подключаться к Remote Control. Требуется Claude Code v2.1.203 или более поздней версии. Когда вы включаете или отключаете переключатель в окне VS Code, изменение касается не только сессий, которые вы запустите после этого. Оно также применяется к сессиям, уже открытым в этом окне VS Code. Если вы его отключите, открытые сессии отключатся. В Claude Code v2.1.261 и более поздних версиях изменение также распространяется на сессии, открытые в других ваших окнах VS Code.
  • Раздел Settings также содержит пункт Focus view, который скрывает вызовы инструментов, результаты инструментов и размышления за разворачиваемыми строками, оставляя ваши промпты и ответы Claude. Переключайте его там же, сочетанием Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) или из палитры команд с помощью Claude Code: Toggle Focus view. Изменение применяется ко всем открытым сессиям и сохраняется между сессиями. Требуется Claude Code v2.1.221 или более поздней версии. Последний список задач Claude остаётся видимым, как и текст, о котором спрашивает ожидающий ответа вопрос от Claude; для этого требуется Claude Code v2.1.225 или более поздней версии. Пока Claude запускает субагентов, под группой вызовов инструментов, которая их запустила, появляются строки с ходом выполнения в реальном времени и их последней активностью. Для этого требуется Claude Code v2.1.269 или более поздней версии.
  • Чтобы выйти из учётной записи Anthropic, выберите Sign out в разделе Settings или введите /logout. При использовании стороннего провайдера меню не предлагает ни того, ни другого. Требуется Claude Code v2.1.277 или более поздней версии.
  • Чтобы сообщить об ошибке, нажмите Report a problem внизу меню или введите /bug или /feedback с необязательным описанием, которым будет предварительно заполнен отчёт. Когда вы отправляете отчёт и при этом вошли в Anthropic через собственное подключение Anthropic, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или более поздней версии. При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как локальный архив в ~/.claude/feedback-bundles/, в котором известные шаблоны API-ключей и токенов скрыты. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или более поздней версии. После сохранения отчёта в подтверждении указывается имя файла и есть кнопка Show folder. Отправьте этот файл представителю вашей учётной записи в Anthropic или прикрепите его к обращению в службу поддержки. Если политика вашей организации отключает отзывы о продукте, пункт Report a problem не отображается в меню, а /bug и /feedback вместо открытия отчёта показывают уведомление Feedback is turned off by your organization's policy or this environment's settings.. В Claude Code v2.1.284 и более поздних версиях, если вы задали переменную окружения DISABLE_FEEDBACK_COMMAND или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, отзывы также отключаются, и при открытии отчёта вместо него показывается это уведомление.
• Побочные вопросы: введите /btw, а затем вопрос, чтобы спросить о вашей сессии, не добавляя его в диалог. Ответ открывается на панели рядом с чатом, где можно задавать уточняющие вопросы. Требуется Claude Code v2.1.227 или более поздней версии. Ветка сохраняется при перезагрузке окна. Claude Code хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию cleanupPeriodDays, если Claude Code может безопасно определить срок хранения. Чтобы очистить ветку, нажмите на значок корзины на панели.
• Копирование ответа: наведите курсор на ответ и нажмите Copy response, чтобы скопировать его в буфер обмена, или введите /copy, чтобы скопировать последний ответ. /copy 2 копирует предпоследний. Требуется Claude Code v2.1.277 или более поздней версии.
• Закладки: наведите курсор на ответ и нажмите Bookmark response, чтобы сохранить его, или нажмите Remove bookmark на сохранённом ответе, чтобы удалить закладку. Чтобы просмотреть сохранённые ответы, откройте панель Bookmarks. Можно нажать на значок закладки вверху панели Claude Code, выбрать Bookmarks в разделе Context меню команд или ввести /bookmarks. Требуется Claude Code v2.1.286 или более поздней версии.
• Файлы, которые отправляет вам Claude: когда сессия подключена к Remote Control и Claude отправляет вам файлы с помощью инструмента SendUserFile, в диалоге отображается строка вида Sent report.md, chart.png. Нажмите на имя файла, чтобы открыть его в редакторе.
• Индикатор контекста: поле ввода промпта показывает, какую часть контекстного окна Claude вы используете. Claude автоматически выполняет сжатие контекста при необходимости, или вы можете запустить /compact вручную.
• Часы кэша промптов: значок часов рядом с индикатором контекста оценивает, сколько времени осталось до истечения срока действия кэша промптов диалога. Он отсчитывает время от пятиминутного или часового срока жизни кэша, и каждый ответ, использующий кэш, перезапускает отсчёт. Помимо сжатия контекста, действия, которые делают кэш недействительным, не сбрасывают часы, поэтому после смены модели они всё ещё могут показывать оставшиеся минуты.
  • Пока отсчёт не закончился, значок показывает оставшиеся минуты, например 12m.
  • Когда отсчёт заканчивается, минуты исчезают, а значок становится красным или цвета ошибки вашей темы до следующего ответа. Срок действия кэша, скорее всего, истёк, поэтому ожидайте более медленный и более дорогой ответ на следующее сообщение, пока кэш перестраивается. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел Выбор TTL самостоятельно.
  • Сразу после сжатия диалога значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.
• Карта агентов: когда диалог включает субагентов, внизу поля ввода промпта появляется счётчик агентов, например 2 agents. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения. Нажмите на счётчик агентов, чтобы открыть карту агентов, на которой субагенты диалога изображены в виде дерева под основным агентом, у каждого — статус, затраченное время и количество токенов. Нажмите на субагента, чтобы увидеть его промпт и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требуется Claude Code v2.1.269 или более поздней версии. На карте также перечислены другие фоновые задачи сессии, такие как фоновые shell-команды и мониторы, под агентами. Нажмите на строку, чтобы открыть карточку задачи и остановить её там. Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не запустил субагентов, введите /tasks в поле ввода промпта. Фоновые задачи на карте и ввод /tasks требуют Claude Code v2.1.277 или более поздней версии. В Claude Code v2.1.286 и более поздних версиях, когда вы нажимаете Stop или клавишу Esc, текущий ход завершается. Фоновые агенты продолжают работать, пока не закончат или пока вы не остановите их с карты.
• Расширенное мышление: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (/). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите Ctrl+O, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе Расширенное мышление.
• Многострочный ввод: нажмите Shift+Enter, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.

​

Ссылки на файлы и папки

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

• Если файл находится внутри вашей рабочей области и соответствует настройкам files.exclude или search.exclude, Claude получает не более чем путь к файлу, но не выделенный вами текст.
• То же самое относится к файлу, который игнорируется git, при условии что настройка VS Code search.useIgnoreFiles и настройка respectGitIgnore расширения обе включены, что является значением по умолчанию.

• Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода промпта.
• Чтобы прикрепить файлы, перетащите их в поле ввода промпта, удерживая Shift.
• Чтобы удалить вложение из контекста, нажмите на X на нём.

​

Включение вывода терминала в промпты

​

Вставка текста

• Если при вставке появляется уведомление, например Removed 3 invisible characters from the pasted text, текст был вставлен без этих символов.
• Если уведомление об удалённых символах появляется при отправке, ничего не было отправлено. Очищенный текст возвращается в поле ввода промпта. Отправьте снова, чтобы отправить текст в том виде, в котором он отображается.

​

Математика LaTeX в ответах

• Выносные формулы: блок $$ … $$ или \[ … \] на отдельной строке или строках, а также огороженный блок кода с языком math
• Строчные формулы: $…$ или \(…\), которые открываются и закрываются на одной строке, например $E = mc^2$ или \(a^2 + b^2 = c^2\)

​

Возобновление прошлых диалогов

• Заголовки сессий: новые сессии получают сгенерированные ИИ заголовки на основе вашего первого сообщения.
• Переименование и архивация: наведите курсор на сессию, чтобы увидеть эти действия. Переименуйте её, чтобы дать описательный заголовок, или заархивируйте, чтобы переместить в группу Archived sessions внизу списка.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• Одна сессия: разверните Archived sessions и нажмите Unarchive session.
• Все заархивированные сессии сразу: наведите курсор на заголовок Archived sessions в списке сессий на панели действий и нажмите на его значок разархивации. Требуется Claude Code v2.1.277 или более поздней версии.

• Расширение выбирает начальный режим разрешений из claudeCode.initialPermissionMode или из выбора, перенесённого из более раннего диалога
• У вас настроен claudeCode.claudeProcessWrapper
• Правило запрета удаляет инструмент ExitPlanMode

​

Возобновление облачных сессий из claude.ai

​

Проверка учётной записи и использования

• Тариф claude.ai: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая полоса показывает, сколько времени осталось до сброса её лимита. Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа. Оно помечает модели поведения, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст и сессии с интенсивным использованием субагентов или высоким параллелизмом. Для каждого помеченного поведения даётся совет, как его сократить. Таблицы атрибуции показывают, сколько использования пришлось на каждый скилл, субагент, плагин и MCP-сервер. Используйте переключатель Day и Week, чтобы переключаться между последними 24 часами и последними 7 днями. Показатели приблизительны и вычисляются по локальным сессиям на этой машине, поэтому использование с других устройств или claude.ai не учитывается.
• Другие способы входа: когда лимиты тарифа не применяются к вашему способу входа, например при использовании стороннего провайдера или API-ключа, раздел Usage вместо этого показывает стоимость и использование токенов самой сессии. /usage в CLI показывает те же итоги в своём блоке Session. Список сессий на панели действий также показывает итоги активной сессии под заголовком Account & usage. Требуется Claude Code v2.1.277 или более поздней версии.

​

Откат с помощью чекпоинтов

• Fork conversation from here: начать новую ветку диалога с этого сообщения, сохранив все изменения кода
• Rewind code to here: откатить изменения файлов к этому моменту диалога, сохранив полную историю диалога
• Fork conversation and rewind code: начать новую ветку диалога и откатить изменения файлов к этому моменту

​

Настройка рабочего процесса

​

Выбор расположения Claude

• Вторичная боковая панель: правая часть окна. Claude остаётся на виду, пока вы пишете код.
• Основная боковая панель: левая боковая панель со значками Explorer, Search и т. д.
• Область редактора: Claude открывается как вкладка рядом с вашими файлами. Удобно для побочных задач.

​

Продолжение диалогов после перезагрузки

• Вкладка редактора: диалог возвращается вместе со своей вкладкой.
• Боковая панель: диалог возвращается, если в последние 10 минут вы отправили в нём сообщение или Claude ответил в нём. Если диалог не вернулся, возобновите его из истории сессий.

​

Прерванные шаги после перезагрузки

​

Отключение продолжения после перезагрузки

​

A conversation was not reopened

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• Чтобы всё равно открыть его: нажмите Open it anyway или выберите диалог в истории сессий. Если он откроется и панель продолжит работать, при последующих перезагрузках он будет возвращаться как обычно. Если панель снова перестанет отвечать, перезагрузите окно, чтобы вернуться к новому чату с уведомлением.
• Чтобы оставить его закрытым: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.

​

Несколько диалогов одновременно

​

Группировка сессий

• Добавление сессии в группу и удаление из неё: щёлкните сессию правой кнопкой мыши, чтобы создать на её основе группу, переместить её в существующую группу или удалить из группы. Каждая сессия одновременно принадлежит только одной группе, поэтому при перемещении в другую группу она удаляется из первой.
• Перемещение нескольких сессий сразу: щёлкните каждую сессию с Cmd (Mac) / Ctrl (Windows/Linux) или щёлкните с Shift, чтобы выбрать диапазон, затем щёлкните выделение правой кнопкой мыши.
• Добавление сессии в группу с её вкладки: выполните Claude Code: Add Session Tab to Group из палитры команд, затем выберите или создайте группу. Требуется Claude Code v2.1.257 или новее.
• Переименование или удаление группы: щёлкните заголовок группы правой кнопкой мыши. При удалении группы удаляется только сама группа, а её сессии возвращаются в список без группы.

​

Фильтрация списка сессий

• Active: включите этот переключатель, чтобы показывать только сессии, которые ожидают вашего ввода, выполняются или не прочитаны, а также сессию во вкладке Claude, на которой вы последний раз были в фокусе.
• Фильтр по статусу: щёлкните значок воронки, затем отметьте Needs input, Working или Completed, чтобы показать сессии в любом из этих состояний. Отметьте Open или Closed, чтобы отфильтровать сессии по тому, открыты ли они. Сессия считается открытой, если у неё есть вкладка в этом окне или она выполняется в другом процессе Claude Code на этом компьютере, например в терминале.

​

Переключение в режим терминала

​

Управление плагинами

​

Установка плагинов

• Установленные плагины отображаются вверху с переключателями для их включения или отключения.
  • Если вы отключаете плагин, который включён в общем файле .claude/settings.json вашего проекта, расширение сначала задаёт вопрос: Disable for me отключает его только для вас, а Disable for everyone изменяет общий файл.
  • Для плагина, который не удалось загрузить, в его строке отображается краткая причина. Нажмите на причину, чтобы узнать, что можно сделать, включая копирование полного сообщения об ошибке для поиска в разделе Устранение неполадок с плагинами.
• Доступные плагины из настроенных вами маркетплейсов отображаются ниже
• Используйте поиск, чтобы отфильтровать плагины по имени или описанию
• Нажмите Install у любого доступного плагина

• Install for you: доступен во всех ваших проектах (область действия пользователя)
• Install for this project: доступен участникам проекта (область действия проекта)
• Install locally: только для вас и только в этом репозитории (локальная область действия)

​

Удаление плагинов

• Плагин, который включён в общем файле .claude/settings.json вашего проекта: выберите Disable for me, чтобы плагин остался установленным для ваших коллег, или Uninstall for everyone, чтобы удалить установку проекта с флагом --keep-data, при этом каталог сохранённых данных плагина останется. Если вы уже отключили плагин для себя, значок корзины удаляет вашу собственную установку без вопроса.
• В остальных случаях — последняя установка плагина с сохранёнными данными: выберите, сохранить или удалить данные; по умолчанию выбрано Keep

​

Отправка ссылки на установку плагина

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

• Имя плагина: не более 100 символов, начинается с ASCII-буквы или цифры и в остальном содержит только ASCII-буквы, цифры, ., _ и -.
• Источник маркетплейса: только формы, перечисленные для параметра marketplace, то есть не локальный путь, не адрес http:// и не имя маркетплейса, например claude-plugins-official. URL https:// не может содержать имя пользователя, пароль или строку запроса.
• Git-ссылка (ref): чтобы закрепить маркетплейс за веткой или тегом, добавьте ref к источнику после %23 — закодированной формы #, например marketplace=owner/repo%23v1.0. Ссылка с незакодированным # не сработает. Маркетплейсы в организации GitHub anthropics нельзя закрепить в ссылке.

• В маркетплейсе нет плагина с таким именем: диалоговое окно сообщает, что плагин не найден. Сверьте значение plugin со списком маркетплейса.
• Плагин уже установлен: диалоговое окно сообщает об этом, и ничего не меняется.
• Уже добавлен другой маркетплейс с тем же именем: диалоговое окно сообщает, что маркетплейс из ссылки не был добавлен, и ничего не устанавливается.

​

Управление маркетплейсами

• Введите репозиторий GitHub, URL или локальный путь, чтобы добавить новый маркетплейс
• Нажмите значок обновления, чтобы обновить список плагинов маркетплейса
• Нажмите значок корзины, чтобы удалить маркетплейс. Его удаление удаляет все плагины, которые вы из него установили, поэтому сначала отображается подтверждение с перечнем этих плагинов

​

Плагины, которые отображают содержимое в панели

• Панель рядом с диалогом или над полем промпта
• Всплывающее уведомление или строку состояния над полем промпта
• Сообщение или вызов инструмента, отображённые собственным способом плагина

• From the token-chart plugin: плагин отобразил или вывел это, либо эта карточка — вопрос плагина к вам
• Edited by the token-chart plugin: плагин изменил что-то, что отображает Claude Code, например вызов инструмента
• Prompt from the token-chart plugin: плагин отправил это сообщение от вашего имени

​

Автоматизация задач в браузере с помощью Chrome

@browser go to localhost:3000 and check the console for errors

• Включение Chrome по умолчанию: каждая сессия будет подключаться к вашему браузеру при запуске без ввода @browser
• Запросы разрешений в сессиях VS Code: когда Claude Code спрашивает вас перед действием в браузере
• Использование Claude Code с Chrome: инструкции по настройке, полный список возможностей и устранение неполадок

​

Работа с git

​

Создание коммитов и pull request’ов

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

​

Выполнение работы в фоновом режиме

​

Перевод выполняющейся команды или субагента в фоновый режим

• Когда появляется: действие становится доступным, когда команда выполняется около двух секунд, или сразу после запуска субагента.
• После нажатия: Claude перестаёт ждать и продолжает ход. Команда или субагент продолжают работать как фоновая задача, которая уведомит Claude о завершении.

​

Отслеживание фоновых процессов

​

Команды и сочетания клавиш VS Code

​

Запуск вкладки VS Code из других инструментов

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

​

Настройка параметров

• Настройки расширения в VS Code: управляют поведением расширения внутри VS Code. Откройте их с помощью Cmd+, (Mac) или Ctrl+, (Windows/Linux), затем перейдите в Extensions > Claude Code. Также можно ввести / и выбрать General config…, чтобы открыть настройки.
• Настройки Claude Code в ~/.claude/settings.json: общие для расширения и CLI. Используйте их для разрешённых команд, переменных окружения, хуков и MCP-серверов. В Claude Code v2.1.283 и более поздних версиях они также являются одним из факторов, определяющих режим разрешений, в котором начинаются диалоги, а в более ранних версиях — только в планах Pro, Max и Team. Порядок приведён в разделе Переключение режимов разрешений. Подробнее см. в разделе Настройки.

​

Настройки расширения

​

Использование сторонних провайдеров

​

Использование программы чтения с экрана

• Ответы Claude: расширение озвучивает каждый ответ один раз, когда он завершён, и молчит, пока текст поступает потоком. Программа чтения с экрана зачитывает блоки кода в виде сводки с количеством строк, ссылки — по их подписи, а таблицы — ячейка за ячейкой; полный ответ остаётся доступным для чтения в транскрипте.
• Запросы разрешений и вопросы: расширение озвучивает запрос, когда появляется запрос разрешения, называя инструмент, который Claude хочет использовать. Аналогичным образом оно сообщает, когда Claude задаёт вам вопрос и когда Claude завершает план и ждёт вашей проверки.
• Изменения статуса: расширение сообщает, когда Claude начинает работу, когда Claude готов к вашему вводу и когда Claude Code начинает сжатие диалога.
• Сообщения в очереди: когда вы отправляете сообщение, пока Claude работает, расширение озвучивает для этого сообщения «Message queued.».
• Ошибки и запросы, связанные с моделью: расширение озвучивает ошибки в диалоге, а также сообщает о появлении запроса согласия на использование кредитов использования или запроса для помеченного запроса.

​

Использование панели чата с клавиатуры

• Ваши сообщения: «You»
• Сообщения Claude: «Claude»
• Шаги инструментов: «Claude» плюс название инструмента, например «Claude, Bash»
• Блоки размышлений: «Claude, thinking»

• Установив фокус на этом варианте, нажмите клавишу со стрелкой Left или Right. Расширение озвучивает каждое место сохранения при переходе к нему. Клавиши со стрелками требуют Claude Code v2.1.268 или новее.
• Щёлкните место сохранения в подписи.

​

Расширение VS Code и Claude Code CLI

​

Запуск CLI в VS Code

​

Переключение между расширением и CLI

​

Подключение к внешним инструментам с помощью MCP

• Добавлять серверы
• Удалять серверы, сохранённые в локальной, пользовательской или проектной области действия
• Включать или отключать серверы
• Переподключаться к серверу
• Управлять аутентификацией OAuth

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

​

Встроенный MCP-сервер IDE

• Открывает diff во встроенном средстве просмотра diff в VS Code
• Считывает ваше текущее выделение для @-упоминаний
• Просит VS Code выполнить ячейки, когда вы работаете в блокноте Jupyter

• Сообщения в очереди: если вы ставите сообщение в очередь, пока Claude работает, оно сохраняет выделение, которое было у вас в момент нажатия Enter, независимо от того, что вы выделите после этого.
• Конфиденциальные файлы: чтобы исключить конфиденциальный файл, например .env, добавьте запрещающее правило Read для его пути. Соответствующее запрещающее правило не позволяет ни выделенному тексту, ни уведомлению об открытом файле для этого файла попасть к Claude.
• Настройка Attach Open File отключена: если вы отключите настройку Attach Open File, CLI получает путь к активному файлу только тогда, когда в нём выделен текст.

• Транспорт: незашифрованный ws://. Поскольку сокет доступен только через loopback, любой процесс, способный перехватить трафик, может также прочитать токен из lock-файла, поэтому TLS не добавил бы защиты.
• Токен аутентификации: при каждой активации расширение генерирует новый случайный токен аутентификации и записывает его в lock-файл ~/.claude/ide/<port>.lock. Для подключения CLI должен предъявить токен в заголовке X-Claude-Code-Ide-Authorization.
• Права доступа к lock-файлу: lock-файл имеет права доступа 0600 в каталоге с правами 0700, поэтому прочитать его может только пользователь, запустивший VS Code. Если задана переменная CLAUDE_CONFIG_DIR, lock-файл вместо этого записывается в $CLAUDE_CONFIG_DIR/ide/.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. Код вставляется как новая ячейка в конец активного блокнота.
2. VS Code прокручивает представление к этой ячейке.
3. Встроенное окно Quick Pick предлагает выбрать Execute или Cancel.

​

Устранение распространённых проблем

​

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

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

​

Значок Spark не отображается

1. Откройте файл: для отображения значка должен быть открыт файл. Открытой папки недостаточно.
2. Проверьте версию VS Code: требуется 1.94.0 или новее. Проверьте в разделе Help > About
3. Перезапустите VS Code: выполните «Developer: Reload Window» из палитры команд
4. Отключите конфликтующие расширения: временно отключите другие AI-расширения (Cline, Continue и т. д.)
5. Проверьте доверие к рабочей области: расширение не работает в ограниченном режиме (Restricted Mode)

​

Cmd+Esc ничего не делает в macOS

1. Откройте System Settings
2. Перейдите в Keyboard, затем Keyboard Shortcuts, затем Game Controllers
3. Снимите флажок Game Overlay

​

Возобновлённый диалог сначала пуст

​

Панель перестаёт отвечать каждый раз, когда перезагрузка заново открывает диалог

​

Формула отображается как исходный LaTeX

• Она читается не как математика: текст $…$, который читается как слово, остаётся в исходном виде, например $O(n log n)$. Текст $…$, начинающийся с цифры, например $30$ или $1/N$, также остаётся в исходном виде, если только такой символ, как =, + или ^, не помечает его как математику. Вместо этого попросите Claude оформить блок $$ на отдельных строках — панель отображает его в наборе без этой проверки.
• Она содержит пробелы по краям, слишком длинная или разбита на строки: $ x^2 $ с пробелами внутри знаков доллара, содержимое $…$ длиннее 60 символов, а также $…$ или \(…\), разбитые на две строки, не отображаются в наборе. Вместо этого попросите Claude оформить блок $$ на отдельных строках — у него нет ни одного из этих ограничений.
• TeX невозможно набрать: формула с синтаксической ошибкой, определением макроса, например \newcommand или \def, или неэкранированным % отображается в исходном виде. Попросите Claude переписать её с исправленной ошибкой, без макроса или с \% для знака процента.
• Она слишком большая: формула длиннее 8 192 символов или формула, которая при отрисовке получилась бы намного больше своего исходного текста, отображается в исходном виде. Попросите Claude разбить её на формулы поменьше или записать компактнее.
• Она следует за большим объёмом математики: в пределах одного текстового блока ответа панель отображает формулы в наборе по порядку до определённого предела. Последующая формула, которая превысила бы этот предел, отображается в исходном виде. Попросите Claude отправить нужную вам формулу ещё раз отдельно.

​

Claude Code не отвечает

1. Проверьте подключение к интернету: убедитесь, что у вас стабильное подключение к интернету
2. Начните новый диалог: попробуйте начать новый диалог, чтобы проверить, сохраняется ли проблема
3. Попробуйте CLI: запустите claude в терминале, чтобы увидеть более подробные сообщения об ошибках

​

Удаление расширения

1. Нажмите Cmd+Shift+X на Mac или Ctrl+Shift+X на Windows/Linux, чтобы открыть представление Extensions
2. Найдите «Claude Code»
3. Нажмите Uninstall

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

​

Дальнейшие шаги

• Изучите распространённые рабочие процессы, чтобы получить максимум от Claude Code
• Настройте MCP-серверы, чтобы расширить возможности Claude с помощью внешних инструментов. Добавляйте их и управляйте ими с помощью /mcp в панели чата.
• Настройте параметры Claude Code, чтобы настроить разрешённые команды, хуки и многое другое. Эти настройки являются общими для расширения и CLI.
• Ознакомьтесь с мерами безопасности и использованием данных в Claude Code