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

Установите и настройте расширение Claude Code для VS Code. Получите помощь AI при кодировании с встроенными diff, @-упоминаниями, проверкой плана и сочетаниями клавиш.

Редактор VS Code с открытой панелью расширения Claude Code справа, показывающей диалог с Claude

Расширение VS Code предоставляет собственный графический интерфейс для Claude Code, интегрированный непосредственно в вашу IDE. Это рекомендуемый способ использования 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, см. Использование поставщиков третьей стороны для инструкций по настройке.

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

Нажмите на ссылку для вашей IDE, чтобы установить расширение напрямую:

Или в VS Code нажмите Cmd+Shift+X (Mac) или Ctrl+Shift+X (Windows/Linux), чтобы открыть представление Extensions, найдите «Claude Code» и нажмите Install.

Номер версии расширения соответствует версии Claude Code, которая в него входит. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее; её можно увидеть в представлении Extensions.

Claude Code также работает в других редакторах и контейнерах:

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

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

После установки вы можете начать использовать Claude Code через интерфейс VS Code:

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

Во всём VS Code значок Spark обозначает Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Значок Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

Самый быстрый способ открыть 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. Подробнее см. в разделе Настройка рабочего процесса.

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

При первом открытии панели появляется экран входа. Нажмите 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.

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

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

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

Редактор VS Code с выделенными строками 2–3 в файле Python и панель Claude Code с вопросом об этих строках, содержащим ссылку с @-упоминанием

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

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

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

VS Code с 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, см. в разделе Типичные рабочие процессы.

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

Поле ввода промпта поддерживает несколько функций:

Режимы разрешений: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В 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» в диалоговых окнах с вопросами.

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

Используйте @-упоминания, чтобы дать Claude контекст о конкретных файлах или папках. Когда вы вводите @, а затем имя файла или папки, Claude читает это содержимое и может отвечать на вопросы о нём или вносить в него изменения. Claude Code поддерживает нечёткое сопоставление, поэтому можно вводить частичные имена, чтобы найти нужное:

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

Для больших PDF-файлов можно попросить Claude прочитать определённые страницы вместо всего файла. Запросите одну страницу, диапазон, например страницы 1–10, или открытый диапазон, например со страницы 3 и далее. Чтение определённых страниц требует наличия poppler-utils на машине, где работает Claude Code.

Когда вы выделяете текст в редакторе, Claude автоматически видит выделенный код. В нижней части поля ввода промпта показывается, сколько строк выделено. Нажмите Option+K (Mac) / Alt+K (Windows/Linux), чтобы вставить @-упоминание с путём к файлу и номерами строк, например @app.ts#5-10. Нажмите X на индикаторе выделения, чтобы убрать его, и тогда Claude не получит выделение. Индикатор вернётся, когда вы выделите другой текст.

Расширение не передаёт выделенный текст из некоторых файлов:

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

Этот фильтр распространяется только на панель чата. Когда Claude Code работает во встроенном терминале, CLI отправляет выделенный текст независимо от файла. Чтобы скрыть содержимое файла от Claude в этом случае, добавьте правило запрета Read.

Claude также видит, какой файл открыт в редакторе, даже если ничего не выделено, и поле ввода промпта показывает его имя. Чтобы добавлять только выделенный текст, отключите настройку Attach Open File. Эта настройка требует Claude Code v2.1.271 или более поздней версии.

Также можно прикреплять к сообщению изображения и файлы:

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

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

Ссылайтесь на вывод терминала в промптах с помощью @terminal:name, где name — заголовок терминала. Это позволяет Claude видеть вывод команд, сообщения об ошибках или логи без копирования и вставки.

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

Вставленный текст остаётся видимым в поле ввода промпта, а не сворачивается в заполнитель, как это происходит в терминале. В сессиях, где Claude Code помечает вставленный текст, Claude по-прежнему видит большой фрагмент как вставленный вами текст, а не набранный.

Claude Code также удаляет невидимые символы Unicode из текста, который вы вставляете в поле ввода промпта, и из всего остального, что вы отправляете:

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

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

Панель чата отображает математические выражения LaTeX в ответах Claude в виде свёрстанных формул. Отрисовка математики требует Claude Code v2.1.301 или более поздней версии. В режиме терминала математика не верстается. Панель верстает как выносные, так и строчные формулы:

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

Панель пытается отличать математику от других вариантов использования тех же символов, поэтому такой текст, как $HOME, цена вроде $5 или sed 's/$foo$/\1/', не верстается. Не верстается и текст внутри фрагмента кода или внутри любого блока кода, кроме огороженного блока math. Если формула отображается в исходном виде, хотя вы ожидали её свёрстанной, см. раздел Формула отображается как необработанный LaTeX.

Когда вы выделяете и копируете текст, содержащий свёрстанную формулу, вы получаете исходный код TeX формулы в разделителях $…$ или $$…$$, а не отрисованные символы. Copy response и /copy дают ответ в том виде, в котором его написал Claude, включая исходный код TeX.

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

Нажмите кнопку Session history вверху панели Claude Code, чтобы получить доступ к истории диалогов. Можно искать по ключевому слову или просматривать по времени.

Нажмите на любой диалог, чтобы возобновить его с полной историей сообщений. Если диалог уже открыт в другой вкладке текущего окна, нажатие переключит на эту вкладку. Если сообщения поначалу остаются пустыми, см. раздел почему они пустые и когда появляются. Подробнее о возобновлении сессий см. в разделе Управление сессиями.

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

Если диалог открыт в другом процессе Claude Code, например claude в терминале или в другом окне VS Code, вместо поля ввода промпта появляется следующее уведомление:

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

Чтобы продолжить здесь, закройте диалог в другом месте, а затем нажмите Open here anyway. Если нажать, не закрыв его, диалог будет открыт в обоих местах. Если задана настройка claudeProcessWrapper, расширение пропускает эту проверку и открывает диалог напрямую.

По умолчанию сессия без активности в течение 14 дней автоматически перемещается в Archived sessions, если она не открыта, не является непрочитанной и не находится в группе. Автоматическая архивация требует Claude Code v2.1.265 или более поздней версии. Чтобы изменить период или отключить её, откройте настройку Archive Inactive Sessions и выберите количество дней или Never.

Чтобы восстановить заархивированные сессии:

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

До v2.1.257 это действие называлось Delete session и скрывало сессию без возможности восстановления. Сессии, которые вы тогда удалили, после обновления появятся в разделе Archived sessions.

Если возобновляемый диалог завершился в режиме планирования, Claude Code восстанавливает режим планирования. Требуется Claude Code v2.1.246 или более поздней версии. Claude Code не восстанавливает его в следующих случаях:

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

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

Если вы запускаете облачные сессии, их можно возобновлять прямо в VS Code. Для этого требуется вход с помощью Claude.ai Subscription, а не Anthropic Console.

Откройте историю сессий

Нажмите кнопку Session history вверху панели Claude Code.

Выберите вкладку Web

В диалоговом окне отображаются две вкладки: Local и Web. Нажмите Web, чтобы увидеть сессии из claude.ai.

Выберите сессию для возобновления

Просмотрите сессии или найдите нужную. Нажмите на сессию, чтобы продолжить диалог локально.

На вкладке Web также перечислены ваши сессии Remote Control. Если нажать на сессию, которая выполнялась в открытой у вас папке, расширение откроет этот локальный диалог вместо загрузки копии. Расширение переходит на вкладку, в которой он уже отображается, если такая есть. Если расширение не может исключить, что диалог открыт другим процессом Claude, вместо этого вы получите загруженную копию.

Если какую-либо часть диалога не удаётся загрузить, появляется ошибка и копия не сохраняется. Выберите сессию снова, чтобы повторить попытку. Если вы выбираете сессию, в которой ещё нет диалога для загрузки, ошибка сообщит, где его можно продолжить.

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

Выполните /usage, чтобы открыть диалоговое окно Account & usage, в котором отображаются учётная запись, с которой вы вошли, и ваше использование. Показатели использования зависят от способа входа:

Тариф claude.ai: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая полоса показывает, сколько времени осталось до сброса её лимита.

Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа. Оно помечает модели поведения, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст и сессии с интенсивным использованием субагентов или высоким параллелизмом. Для каждого помеченного поведения даётся совет, как его сократить. Таблицы атрибуции показывают, сколько использования пришлось на каждый скилл, субагент, плагин и MCP-сервер.

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

Подробнее об отслеживании и сокращении использования см. в разделе Отслеживание расходов.

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

Расширение VS Code поддерживает чекпоинты, которые отслеживают правки файлов, сделанные Claude, и позволяют вернуться к предыдущему состоянию. Наведите курсор на любое сообщение, чтобы увидеть кнопку отката, затем выберите один из трёх вариантов:

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

Подробнее о том, как работают чекпоинты, и об их ограничениях см. в разделе Чекпоинты.

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

Вы можете переместить панель Claude, вести несколько диалогов, группировать или фильтровать список сессий, а также переключиться в режим терминала.

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

Вы можете перетащить панель Claude в любое место в VS Code. Захватите вкладку или заголовок панели и перетащите её в одно из следующих мест:

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

Когда Claude открывает вкладку в новой группе редакторов, расширение блокирует эту группу. Файлы, которые вы открываете, пока вкладка Claude в фокусе, в этом случае попадают в другую группу, а не рядом с ней.

Чтобы расширение не блокировало группы, отключите настройку Lock Editor Groups. Уже заблокированные группы остаются заблокированными, пока вы их не разблокируете. Для этой настройки требуется Claude Code v2.1.274 или новее.

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

После выполнения Developer: Reload Window или перезапуска VS Code проверьте, где был открыт диалог:

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

Если диалог всё ещё открыт в другом процессе Claude Code, перед его открытием здесь вас спросят об этом с тем же уведомлением Open here anyway, что и при возобновлении из истории сессий. Если сообщения поначалу пустые, см. раздел о том, почему они пустые и когда появятся.

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

Если перезагрузка прервала Claude посреди шага, Claude продолжит этот шаг, когда диалог вернётся, а уведомление в чате отметит продолжение. Требуется Claude Code v2.1.274 или новее. Если шаг был прерван более часа назад или сессия открыта в другом месте, диалог вернётся в неактивном состоянии.

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

Чтобы Claude не продолжал прерванный шаг после перезагрузки, откройте настройку Continue After Reload и снимите флажок.

Если вы задали CLAUDE_CODE_RESUME_INTERRUPTED_TURN или любую другую переменную CLAUDE_CODE_RESUME_ в окружении VS Code или в настройке environmentVariables, это не повлияет на панель. Дело в том, что расширение удаляет эти переменные перед запуском сессий панели.

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 или выберите диалог в истории сессий. Если он откроется и панель продолжит работать, при последующих перезагрузках он будет возвращаться как обычно. Если панель снова перестанет отвечать, перезагрузите окно, чтобы вернуться к новому чату с уведомлением.
Чтобы оставить его закрытым: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.

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

Используйте Open in New Tab или Open in New Window из палитры команд, чтобы начать дополнительные диалоги. Каждый диалог хранит собственную историю и контекст, что позволяет работать над разными задачами параллельно.

При использовании вкладок небольшая цветная точка на значке искры показывает статус: синяя означает ожидающий запрос разрешения, оранжевая — что Claude завершил работу, пока вкладка была скрыта.

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

В списке сессий на панели действий можно объединять связанные сессии в именованные сворачиваемые группы. Требуется Claude Code v2.1.229 или новее.

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

Расширение сохраняет группы для каждой папки рабочей области, поэтому они сохраняются после перезагрузки окна и отображаются в каждом окне, где открыта та же папка. При поиске по списку расширение показывает совпадения единым плоским списком по всем группам.

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

Чтобы сократить длинный список сессий на панели действий, используйте два элемента фильтрации в верхней части списка. Требуется Claude Code v2.1.271 или новее. Архивированные сессии не отображаются, пока включён любой из фильтров.

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

Когда Active включён и вы отмечаете статус, Open или Closed, в списке также отображаются все сессии, соответствующие отмеченным условиям. Заданные вами фильтры сохраняются после перезагрузки окна.

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

По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте настройку Use Terminal и установите флажок.

Также можно нажать Cmd+, на Mac или Ctrl+, на Windows/Linux, чтобы открыть настройки VS Code, перейти в Extensions > Claude Code и отметить Use Terminal.

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

Расширение VS Code включает графический интерфейс для установки плагинов и управления ими. Введите /plugins в поле промпта, чтобы открыть интерфейс Manage plugins.

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

В диалоговом окне плагинов есть две вкладки: Plugins и Marketplaces.

На вкладке Plugins:

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

При установке плагина выберите область действия установки:

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

После завершения установки появляется форма, запрашивающая те параметры конфигурации плагина, которые ещё не заданы. Чтобы просмотреть или изменить параметры позже, нажмите значок шестерёнки в строке плагина.

Конфиденциальные текстовые поля маскируются, а для ранее сохранённого секрета отображается (unchanged). Оставьте поле пустым, чтобы сохранить прежнее значение. После сохранения изменений открытые сессии перезагружают свои плагины, а в диалоговом окне отображается Restart Claude to apply plugin changes.

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

В каждой строке установленного плагина указана область действия, на уровне которой он установлен. Чтобы удалить эту установку, нажмите значок корзины в строке. Затемнённый значок корзины отмечает строку, которую нельзя удалить из этой рабочей области, например плагин, управляемый вашей организацией, или плагин, установленный для другого проекта.

Расширение сначала задаёт вопрос в двух случаях:

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

Чтобы сразу направить кого-либо к установке определённого плагина, отправьте ему URL расширения install-plugin. При открытии ссылки запускается или выводится на передний план VS Code, открывается панель Claude Code и диалоговое окно Manage plugins на выборе области действия для этого плагина. Ничего не устанавливается, пока человек не выберет область действия. Если маркетплейс плагина ещё не настроен в его Claude Code, диалоговое окно сначала предложит его добавить.

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

URL принимает два параметра запроса:

Параметр	Описание
`plugin`	Имя плагина в том виде, в каком оно указано в маркетплейсе. Обязательный.
`marketplace`	Источник маркетплейса: `owner/repo` на GitHub, URL `https://` или SSH-адрес git, например `git@github.com:owner/repo.git`. Если не указан, по умолчанию используется `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 нельзя закрепить в ссылке.

Тот, кто откроет ссылку, нарушающую эти правила, увидит ошибку, начинающуюся с Invalid plugin installation URL. Панель Claude Code и диалоговое окно не открываются, и ничего не устанавливается. Если имя вашего плагина или маркетплейс нельзя поместить в ссылку, попросите пользователей добавить маркетплейс на вкладке Marketplaces, а затем установить плагин на вкладке Plugins.

В следующих случаях вместо выбора области действия в диалоговом окне отображается сообщение:

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

README и issues на GitHub, а также некоторые другие платформы для markdown удаляют ссылки, схема которых не http или https, поэтому ссылка vscode:// там отображается как обычный текст. На таких платформах помещайте URL в блок кода, как описано в разделе Ссылка отображается как обычный текст, а не как кликабельная для ссылок claude-cli://.

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

Перейдите на вкладку Marketplaces, чтобы добавить или удалить источники плагинов:

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

Изменения плагинов, внесённые в диалоговом окне, сразу применяются к сессиям Claude Code, открытым в этом окне VS Code.

Если сессия, из которой вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезапустить Claude в этой сессии.

Подробнее о системе плагинов см. в разделах Плагины и Маркетплейсы плагинов.

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

Плагин, содержащий мод, может отображать содержимое в панели чата. Для этого требуется расширение версии 2.1.299 или новее и сессия, которая получает флаги функций. От такого плагина вы можете увидеть:

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

Когда установленный вами плагин добавляет или изменяет что-либо в панели, это обозначается меткой с формулировками, например такими:

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

Чтобы запретить плагину отображать содержимое, отключите плагин в диалоговом окне плагинов.

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

Подключите Claude к браузеру Chrome, чтобы тестировать веб-приложения, выполнять отладку с помощью логов консоли и автоматизировать рабочие процессы в браузере, не покидая VS Code. Для этого требуется расширение Claude in Chrome версии 1.0.36 или новее.

Введите @browser в поле промпта, а затем опишите, что должен сделать Claude:

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

Вы также можете открыть меню вложений, чтобы выбрать конкретные инструменты браузера, например открытие новой вкладки или чтение содержимого страницы.

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

Подробнее о работе с браузером см.:

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

Работа с git

Claude Code интегрируется с git для помощи в рабочих процессах контроля версий прямо в VS Code. Попросите Claude совершить коммиты, создать pull request'ы или работать между ветками. Чтобы запустить Claude в изолированном worktree с собственными файлами и веткой, см. Запуск параллельных сеансов с worktrees.

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

Claude может подготавливать изменения, писать сообщения коммитов и создавать 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

При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

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

Отправьте длительную команду или субагента в фоновый режим, а затем проверяйте их состояние из поля ввода промпта.

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

Когда команда или субагент заставляет Claude ждать дольше, чем вам хотелось бы, нажмите Run in background под соответствующим вызовом инструмента в диалоге. Требуется Claude Code v2.1.287 или новее.

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

Чтобы тем временем проверить состояние задачи или остановить её, введите /tasks в поле ввода промпта, чтобы открыть карту агентов. Субагент сохраняет своё место в дереве агентов, а команда отображается под агентами с последним выводом на её карточке.

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

Введите /tasks в поле ввода промпта, чтобы открыть карту агентов, где перечислены фоновые задачи сессии, например dev-сервер, который Claude оставил работать как фоновую shell-команду. Нажмите на задачу, чтобы открыть её карточку, где её можно остановить. Требуется Claude Code v2.1.277 или новее.

Для фоновой shell-команды или монитора, который запускает команду, карточка также показывает последний вывод команды и обновляет его, пока команда выполняется.

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

Чтобы открыть палитру команд, нажмите Cmd+Shift+P на Mac или Ctrl+Shift+P на Windows/Linux. Введите там «Claude Code», чтобы увидеть все доступные команды VS Code для расширения Claude Code.

Некоторые сочетания клавиш зависят от того, какая панель находится «в фокусе» (получает ввод с клавиатуры). Когда курсор находится в файле с кодом, в фокусе редактор. Когда курсор находится в поле ввода промпта Claude, в фокусе Claude. Используйте Cmd+Esc / Ctrl+Esc для переключения между ними.

Команда	Сочетание клавиш	Описание
Focus Input	`Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux)	Переключить фокус между редактором и Claude
Focus last message	-	Переместить фокус клавиатуры на самое новое сообщение в диалоге или на ожидающий запрос разрешения, чтобы читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в режиме терминала. Требуется Claude Code v2.1.268 или новее
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 был в фокусе, а `enableNewConversationShortcut` имел значение `true`
Reopen Closed Session	`Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux)	Повторно открыть последнюю закрытую вкладку сессии Claude. Если последняя закрытая вкладка не была сессией Claude, выполняется стандартное повторное открытие закрытого редактора VS Code. Отключается с помощью `enableReopenClosedSessionShortcut`
Insert @-Mention Reference	`Option+K` (Mac) / `Alt+K` (Windows/Linux)	Вставить ссылку на текущий файл и выделение (требуется, чтобы редактор был в фокусе)
Accept Change at Cursor	-	Принять изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее
Reject Change at Cursor	-	Отменить изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее
Toggle Focus view	`Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux)	Скрыть или показать активность инструментов в диалоге. Работает, когда видна панель или боковая панель Claude. Требуется Claude Code v2.1.221 или новее
Rename Session Tab	-	Переименовать сессию в активной вкладке Claude. Требуется Claude Code v2.1.257 или новее
Add Session Tab to Group	-	Добавить сессию из активной вкладки Claude в группу сессий, которую вы выберете или создадите. Требуется Claude Code v2.1.257 или новее
Mark Session as Unread	-	Отметить сессию в активной вкладке Claude как непрочитанную в списке сессий. Требуется Claude Code v2.1.257 или новее
Show Logs	-	Просмотреть отладочные логи расширения
Logout	-	Выйти из учётной записи Anthropic

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

Расширение регистрирует обработчик URI по адресу vscode://anthropic.claude-code/open. Используйте его, чтобы открыть новую вкладку Claude Code из собственных инструментов: псевдонима оболочки, букмарклета браузера или любого скрипта, который может открыть URL. Если VS Code ещё не запущен, открытие URL сначала запустит его. Если VS Code уже запущен, URL откроется в том окне, которое сейчас находится в фокусе.

Вызовите обработчик с помощью средства открытия URL вашей операционной системы.

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

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

Команда xdg-open входит в пакет xdg-utils. Если оболочка сообщает, что команда не найдена, см. раздел xdg-open не найден в Linux.

В PowerShell:

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

В cmd.exe команда start воспринимает первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:

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

Обработчик принимает два необязательных параметра запроса:

Параметр Описание

prompt Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически.

session ID сессии, которую нужно возобновить вместо начала нового диалога. Сессия должна принадлежать рабочей области, открытой в данный момент в VS Code. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел Продолжение диалогов.

Параметр	Описание
`prompt`	Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически.
`session`	ID сессии, которую нужно возобновить вместо начала нового диалога. Сессия должна принадлежать рабочей области, открытой в данный момент в VS Code. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел Продолжение диалогов.

Например, чтобы открыть вкладку с предварительно заполненным текстом «review my changes»:

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

Расширение также обрабатывает vscode://anthropic.claude-code/install-plugin, который открывает диалоговое окно плагинов для одного плагина. Чтобы запустить сессию в терминале вместо вкладки VS Code, используйте обработчик claude-cli:// из CLI. См. раздел Запуск сессий по ссылкам.

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

Расширение настраивается в двух местах: в настройках расширения VS Code и в файле настроек Claude Code:

Настройки расширения в 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. Порядок приведён в разделе Переключение режимов разрешений. Подробнее см. в разделе Настройки.

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

VS Code считывает initialPermissionMode из ваших пользовательских настроек и игнорирует значения рабочей области. До v2.1.225 VS Code по умолчанию устанавливал для этой настройки значение default и применял значения рабочей области.

Настройка	По умолчанию	Описание
`useTerminal`	`false`	Запускать Claude в режиме терминала вместо графической панели
`initialPermissionMode`	-	Управляет запросами подтверждения для новых диалогов: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` — псевдоним для `default`, он выбирает режим с меткой Manual в индикаторе режима. Если настройка не задана, расширение выбирает начальный режим разрешений так, как описано в разделе Переключение режимов разрешений.
`preferredLocation`	`panel`	Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка)
`lockEditorGroups`	`true`	Блокировать группы редактора, которые Claude создаёт для своих вкладок, чтобы файлы, открываемые, когда в фокусе вкладка Claude, попадали в другую группу. Если отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или более поздней версии
`autosave`	`true`	Автоматически сохранять файлы перед тем, как Claude читает или записывает их
`attachOpenFile`	`true`	Добавлять файл, открытый в редакторе, к вашим сообщениям и показывать его в поле ввода промпта. Если отключено, добавляется только выделенный текст. Требуется Claude Code v2.1.271 или более поздней версии
`useCtrlEnterToSend`	`false`	Использовать Ctrl/Cmd+Enter вместо Enter для отправки промптов
`scrollToBottomOnSend`	`true`	Прокручивать диалог вниз при отправке сообщения. Если отключено, диалог остаётся там, где вы его оставили. Требуется Claude Code v2.1.275 или более поздней версии
`showMessageTimestamps`	`true`	Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место, где меняется день. Требуется Claude Code v2.1.284 или более поздней версии. До v2.1.290 значение по умолчанию было `false`
`spinnerVerbs`	`{"mode": "append", "verbs": []}`	Задаёт глаголы, которые поочерёдно отображает индикатор выполнения диалога во время хода, с теми же полями `mode` и `verbs`, что и в настройке CLI `spinnerVerbs`.
`enableNewConversationShortcut`	`false`	Включить Cmd/Ctrl+N для начала нового диалога
`enableReopenClosedSessionShortcut`	`true`	Использовать Cmd/Ctrl+Shift+T для повторного открытия последней закрытой вкладки сессии Claude. Если последняя закрытая вкладка не была сессией Claude, сочетание клавиш выполняет обычную команду VS Code для повторного открытия закрытого редактора.
`archiveInactiveSessions`	`14`	Автоматически архивировать сессию после указанного количества дней без активности: `1`, `2`, `7` или `14`. Установите `0`, чтобы отключить. Требуется Claude Code v2.1.265 или более поздней версии
`continueAfterReload`	`true`	После перезагрузки окна Claude продолжает прерванный шаг в восстановленной сессии. Требуется Claude Code v2.1.274 или более поздней версии
`hideOnboarding`	`false`	Скрыть контрольный список знакомства (значок выпускной шапочки)
`focusView`	`false`	Скрывать вызовы инструментов, результаты инструментов и размышления за раскрываемыми строками, оставляя ваши промпты и ответы Claude. Последний список задач Claude остаётся видимым; для этого требуется Claude Code v2.1.225 или более поздней версии. Режим Focus view также можно переключать из меню команд. Требуется Claude Code v2.1.221 или более поздней версии
`respectGitIgnore`	`true`	Исключать шаблоны .gitignore из поиска файлов и из контекста выделения
`usePythonEnvironment`	`true`	Активировать окружение Python рабочей области при запуске Claude. Требуется расширение Python.
`environmentVariables`	`[]`	Задать переменные окружения для процесса Claude. Для общей конфигурации используйте вместо этого настройки Claude Code. Запись `CLAUDE_CONFIG_DIR` применяется только в том случае, если её значение — абсолютный путь; расширение не раскрывает `~` и игнорирует относительное значение.
`disableLoginPrompt`	`false`	Пропускать запросы аутентификации (для конфигураций со сторонними провайдерами)
`allowDangerouslySkipPermissions`	`false`	Добавляет Bypass permissions в селектор режимов. Используйте только в песочницах без доступа к интернету.
`claudeProcessWrapper`	-	Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному бинарному файлу передаётся как аргумент, если он присутствует. Укажите здесь отдельно установленный бинарный файл `claude`, если сборка расширения не содержит его для вашей платформы.

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

По умолчанию Claude Code подключается напрямую к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего провайдера:

Отключите промпт входа

Откройте настройку Disable Login Prompt и установите флажок.

Вы также можете нажать Cmd+, на Mac или Ctrl+, на Windows/Linux, чтобы открыть настройки VS Code, выполнить поиск по запросу "Claude Code login" и установить флажок Disable Login Prompt.

Настройте провайдера

Следуйте руководству по настройке для вашего провайдера:

В этих руководствах описана настройка провайдера в ~/.claude/settings.json, что гарантирует общие настройки для расширения VS Code и CLI.

При использовании стороннего провайдера расширение не предоставляет функции, для которых требуется учётная запись claude.ai, например шкалы использования плана, голосовую диктовку и вкладку Web для облачных сессий. О том, что показывает диалог Account & usage при таких способах входа, см. раздел Проверка учётной записи и использования.

Вход в claude.ai, оставшийся от предыдущего выполнения /login, не используется: расширение не отправляет его ни с одним запросом.

Панель чата расширения работает с программами чтения с экрана. Вам не нужно ничего включать: расширение озвучивает активность в диалоге для всех пользователей, без каких-либо визуальных изменений. Это не связано с режимом чтения с экрана в CLI, который включается вручную и адаптирует интерфейс терминала.

Поддержка программ чтения с экрана в панели чата требует Claude Code v2.1.236 или новее.

Во время диалога расширение озвучивает:

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

Пока Claude работает, программа чтения с экрана зачитывает текстовую метку вместо анимации индикатора выполнения.

Когда вы повторно открываете сессию или переключаетесь на другую, расширение ничего не озвучивает: восстановленная история, ожидающие запросы разрешений и статус выполнения остаются без озвучивания, пока не произойдёт что-то новое.

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

Каждый ход в транскрипте начинается с визуально скрытого заголовка, подписанного промптом, с которого начался этот ход. Используйте навигацию по заголовкам в вашей программе чтения с экрана, чтобы переходить между ходами.

Внутри хода программа чтения с экрана по мере перемещения сообщает, чьё сообщение перед вами:

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

Поскольку расширение представляет транскрипт как помеченную область, вы также можете переместить фокус на сам транскрипт с помощью Tab и читать его в удобном вам темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, выполните Claude Code: Focus last message из палитры команд.

Когда вариант в запросе разрешения сохраняет правило разрешений или доступ к каталогу, его подпись заканчивается указанием места сохранения подтверждения, например «all projects» или «this session». Чтобы изменить место сохранения:

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

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

Claude Code доступен как в виде расширения VS Code (графическая панель), так и в виде CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, запустите claude во встроенном терминале VS Code. Для этого требуется автономная установка CLI: расширение не добавляет claude в ваш PATH. См. раздел Запуск CLI в VS Code.

Функция	CLI	Расширение VS Code
Команды и скиллы	Все	Часть (введите `/`, чтобы увидеть доступные)
Настройка MCP-серверов	Да	Да: добавляйте серверы и управляйте ими с помощью `/mcp` в панели чата
Чекпоинты	Да	Да
Ярлык `!` для Bash	Да	Нет
Автодополнение по Tab	Да	Нет

Запуск CLI в VS Code

Чтобы использовать CLI, не выходя из VS Code, нажмите Ctrl+` в Windows/Linux или Cmd+` на Mac, чтобы открыть встроенный терминал, а затем выполните claude. CLI автоматически интегрируется с вашей IDE для таких функций, как просмотр diff и передача диагностики. Если вы используете внешний терминал, выполните /ide внутри Claude Code, чтобы подключить его к VS Code.

Установка расширения не добавляет claude в PATH вашей оболочки. Расширение содержит собственную копию CLI для своей панели чата, но для ввода claude в терминале требуется автономная установка CLI. Выполните установку один раз, и команды на этой странице, включая claude mcp add и claude --resume, будут работать в любом терминале. Если после установки claude по-прежнему не найден, проверьте ваш PATH.

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

Расширение и CLI используют общую историю диалогов. Чтобы продолжить диалог из расширения в CLI, выполните claude --resume в терминале. Откроется интерактивное окно выбора, в котором вы можете найти и выбрать нужный диалог.

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

MCP-серверы (Model Context Protocol) предоставляют Claude доступ к внешним инструментам, базам данных и API.

Чтобы управлять MCP-серверами, не выходя из VS Code, введите /mcp на панели чата. В открывшемся диалоговом окне вы можете:

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

Для добавления и удаления серверов в диалоговом окне требуется Claude Code v2.1.261 или более поздней версии.

Вы также можете выполнить claude mcp add во встроенном терминале VS Code (Ctrl+` или Cmd+`). Диалоговое окно и команда терминала сохраняют данные в одну и ту же конфигурацию MCP, и изменения, внесённые любым из способов, вступают в силу в диалогах, которые вы начнёте после этого. В примере ниже добавляется удалённый MCP-сервер GitHub, который выполняет аутентификацию с помощью персонального токена доступа, передаваемого в заголовке:

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

Замените YOUR_GITHUB_PAT своим персональным токеном доступа. Команда claude mcp add сохраняет конфигурацию без проверки учётных данных, поэтому значение-заполнитель здесь будет принято, но позже сервер не сможет подключиться. Чтобы проверить подключение, начните новый диалог, введите /mcp и убедитесь, что у сервера отображается статус Connected. Для сервера с неверными учётными данными отображается Failed.

После настройки попросите Claude использовать инструменты (например, «Review PR #456»).

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

Когда расширение активно, оно запускает локальный MCP-сервер, к которому CLI подключается автоматически. Через этот сервер CLI:

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

Сервер называется ide и скрыт из /mcp, поскольку в нём нечего настраивать. Однако если ваша организация использует хук PreToolUse для ведения списка разрешённых инструментов MCP, вам нужно знать о его существовании.

Контекст выделения и открытого файла. Пока CLI подключён, он включает ваше текущее выделение в редакторе и путь к активному файлу в качестве контекста в каждый отправляемый вами промпт. Когда это происходит, в транскрипте отображается строка ⧉ Selected N lines from <file>. Следующие случаи изменяют этот контекст:

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

Транспорт и аутентификация. Сервер привязывается к 127.0.0.1 на случайном порту в диапазоне 10000–65535, и этот порт нельзя настроить. Транспорт и токен аутентификации работают следующим образом:

Транспорт: незашифрованный 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/.

Инструменты, доступные модели. Сервер предоставляет около дюжины инструментов, но модели видны только два. Остальные — это внутренние RPC, которые CLI использует для собственного интерфейса, например для открытия diff, чтения выделения и сохранения файлов. Они отфильтровываются до того, как список инструментов попадает к Claude.

Имя инструмента (как его видят хуки)	Что он делает	Только для чтения
`mcp__ide__getDiagnostics`	Возвращает диагностику языкового сервера: ошибки и предупреждения из панели Problems в VS Code. При необходимости может ограничиваться одним файлом.	Да
`mcp__ide__executeCode`	Выполняет код Python в ядре активного блокнота Jupyter. См. процесс подтверждения ниже.	Нет

Диагностика в панели чата. В панели чата при использовании Claude Code v2.1.285 или более поздней версии Claude считывает панель Problems в VS Code через отдельный встроенный сервер с именем claude-vscode. Claude может запросить у него текущие ошибки и предупреждения в одном файле или во всех файлах, для которых у VS Code есть диагностика.

Хуки и правила разрешений видят инструмент диагностики панели чата как mcp__claude-vscode__getDiagnostics. Чтобы охватить диагностику и в CLI, и в панели чата, укажите в хуке или правиле оба имени: mcp__ide__getDiagnostics и mcp__claude-vscode__getDiagnostics.

Этот пример settings.json запрещает оба инструмента:

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

Запрещающее правило Read не распространяется ни на один из этих инструментов, поэтому блокируйте их по имени с помощью запрещающего правила, как показано в примере.

Выполнение в Jupyter всегда требует подтверждения. mcp__ide__executeCode не может ничего выполнить незаметно. Каждый вызов проходит следующие шаги:

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

Отмена или закрытие окна выбора клавишей Esc возвращает Claude ошибку, и ничего не выполняется. Инструмент также сразу отказывает в выполнении, если нет активного блокнота, если не установлено расширение Jupyter (ms-toolsai.jupyter) или если ядро не Python.

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

Ошибкам входа, сети и запуска посвящены отдельные разделы на страницах устранения неполадок установки и справочника ошибок. Найдите в таблице то, что вы видите, и перейдите по ссылке.

Что вы видите	Куда перейти
`API Error: 403 Request not allowed` после входа	403 Forbidden после входа
Вас просят войти снова, хотя вы уже вошли	Вход не выполнен или срок действия токена истёк
Учётные данные облачного провайдера работают в терминале, но не в расширении	Учётные данные Bedrock, Agent Platform или Foundry не загружаются
`SSL certificate verification failed` или `Self-signed certificate detected`	Ошибки SSL-сертификатов
`Claude Code process exited with code 1` или другой код	Claude Code process exited with code N
`Could not locate the Claude CLI on PATH`	Could not locate the Claude CLI on PATH
`The connection to Claude Code ended before this message completed`	The connection to Claude Code ended before this message completed
`claude` не найден во встроенном терминале VS Code	Запуск CLI в VS Code

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

Убедитесь, что у вас совместимая версия VS Code (1.94.0 или новее)

Проверьте, что у VS Code есть разрешение на установку расширений

Попробуйте установить расширение напрямую из VS Code Marketplace

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

Значок Spark появляется на панели инструментов редактора (в правом верхнем углу редактора), когда у вас открыт файл. Если вы его не видите:

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

Кроме того, можно нажать ✻ Claude Code в строке состояния в правом нижнем углу окна. Это работает даже без открытого файла. Также можно открыть палитру команд (Cmd+Shift+P / Ctrl+Shift+P) и ввести «Claude Code».

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

В macOS Tahoe и новее системное сочетание клавиш Game Overlay по умолчанию назначено на Cmd+Esc и перехватывает нажатие до того, как оно дойдёт до VS Code. Чтобы освободить это сочетание клавиш:

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

Либо назначьте расширению другое сочетание клавиш: откройте в VS Code редактор сочетаний клавиш (Cmd+K Cmd+S), найдите Claude Code: Focus input и назначьте новое сочетание.

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

Когда вы возобновляете прошлый диалог или диалог восстанавливается после перезагрузки, его сообщения могут оставаться пустыми, пока запускается процесс Claude Code для этого диалога. Примерно через секунду на пустом месте появляется Waiting for your plugins….

Ничего делать не нужно. Сообщения появятся, как только процесс запустится и подтвердит, что ни одному плагину не нужно предварительно их проверить, либо через 20 секунд, если запуск занимает больше времени.

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

Если вся панель аварийно завершает работу, зависает или показывает только Something went wrong каждый раз, когда вы перезагружаете окно и ваш диалог восстанавливается, обновите расширение до v2.1.301 или новее. Затем снова перезагрузите окно или перезапустите VS Code. После того как диалогу дважды подряд не удастся полностью открыться, вместо него вы получите новый чат с уведомлением о том, что он не был открыт заново.

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

Если никакие математические выражения в ответах Claude не отображаются в наборе, проверьте версию расширения в представлении Extensions, поскольку отображение математики требует версии 2.1.301 или новее. Если вы используете режим терминала, который не отображает математику независимо от версии, снимите флажок настройки Use Terminal, чтобы Claude Code открывался в панели чата.

Если одна формула отображается в исходном виде, а соседние — в наборе, проверьте её на следующие причины:

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

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

Если Claude Code не отвечает на ваши промпты:

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

Если проблемы не исчезают, создайте issue на GitHub с подробным описанием ошибки.

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

Чтобы удалить расширение Claude Code:

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

Если вы запускаете claude во встроенном терминале VS Code, Claude Code автоматически переустанавливает расширение. Чтобы оно оставалось удалённым, отключите Auto-install IDE extension в /config или задайте для autoInstallIdeExtension значение false. Также можно задать для переменной окружения CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL значение 1.

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

В macOS:

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

В Linux:

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

В Windows, в PowerShell:

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

Дополнительную помощь см. в руководстве по устранению неполадок.

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

Теперь, когда вы настроили Claude Code в VS Code:

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

vs-code.md +514 −451

6 6

7> Установите и настройте расширение Claude Code для VS Code. Получите помощь AI при кодировании с встроенными diff, @-упоминаниями, проверкой плана и сочетаниями клавиш.7> Установите и настройте расширение Claude Code для VS Code. Получите помощь AI при кодировании с встроенными diff, @-упоминаниями, проверкой плана и сочетаниями клавиш.

8 8

9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Редактор VS Code с открытой панелью расширения Claude Code справа, показывающей беседу с Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Редактор VS Code с открытой панелью расширения Claude Code справа, показывающей диалог с Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />

10 10

11Расширение VS Code предоставляет собственный графический интерфейс для Claude Code, интегрированный непосредственно в вашу IDE. Это рекомендуемый способ использования Claude Code в VS Code.11Расширение VS Code предоставляет собственный графический интерфейс для Claude Code, интегрированный непосредственно в вашу IDE. Это рекомендуемый способ использования Claude Code в VS Code.

12 12

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

15* Просматривать и редактировать планы Claude перед их принятием

16* Автоматически принимать правки по мере их внесения

17* Использовать @-упоминания файлов с определёнными диапазонами строк из вашего выделения

18* Получать доступ к истории диалога

19* Открывать несколько диалогов в отдельных вкладках или окнах

14 20

15<h2 id="prerequisites">21<h2 id="prerequisites">

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

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

30</h2>36</h2>

31 37

~~32Нажмите на ссылку для вашей IDE, чтобы установить напрямую:~~38Нажмите на ссылку для вашей IDE, чтобы установить расширение напрямую:

33 39

34* [Установить для VS Code](vscode:extension/anthropic.claude-code)40* [Установить для VS Code](vscode:extension/anthropic.claude-code)

35* [Установить для Cursor](cursor:extension/anthropic.claude-code)41* [Установить для Cursor](cursor:extension/anthropic.claude-code)

36 42

37Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление расширений, найдите "Claude Code" и нажмите **Установить**.43Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление Extensions, найдите «Claude Code» и нажмите **Install**.

38 44

39Номер версии расширения соответствует версии Claude Code, которую оно включает. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее, которая отображается в представлении расширений.45Номер версии расширения соответствует версии Claude Code, которая в него входит. Например, для функции, требующей Claude Code v2.1.286 или новее, нужна версия расширения 2.1.286 или новее; её можно увидеть в представлении Extensions.

40 46

41Расширение также устанавливается в других форках VS Code, таких как Devin Desktop или Kiro. Найдите "Claude Code" в представлении расширений вашего редактора или установите из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Если ваш редактор не может установить расширение, [установите CLI](/docs/ru/quickstart) и запустите `claude` в его встроенном терминале. CLI работает в любом терминале.47Claude Code также работает в других редакторах и контейнерах:

42 48

~~43Чтобы запустить Claude Code внутри контейнера разработки, см. [Контейнеры разработки](/docs/ru/devcontainer).~~49* **Другие форки VS Code**: расширение также устанавливается в форках, таких как Devin Desktop или Kiro. Найдите «Claude Code» в представлении Extensions редактора или установите его из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code).

50* **Редакторы, в которые нельзя установить расширение**: [установите CLI](/docs/ru/quickstart) и запускайте `claude` во встроенном терминале редактора. CLI работает в любом терминале.

51* **Dev-контейнеры**: чтобы запустить Claude Code внутри dev-контейнера, см. раздел [Контейнеры для разработки](/docs/ru/devcontainer).

44 52

45<Note>Если расширение не появляется после установки, перезагрузите VS Code или выполните "Developer: Reload Window" из палитры команд.</Note>53<Note>Если расширение не появилось после установки, перезапустите VS Code или выполните «Developer: Reload Window» из палитры команд.</Note>

46 54

47<h2 id="get-started">55<h2 id="get-started">

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

52 60

53<Steps>61<Steps>

54 <Step title="Откройте панель Claude Code">62 <Step title="Откройте панель Claude Code">

55 По всему VS Code значок Spark указывает на Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 Во всём VS Code значок Spark обозначает Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Значок Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64

57 Самый быстрый способ открыть Claude — нажать значок Spark на **панели инструментов редактора** (верхний правый угол редактора). Значок появляется только при открытом файле.65 Самый быстрый способ открыть Claude — нажать на значок Spark на **панели инструментов редактора** (правый верхний угол редактора). Значок отображается только тогда, когда у вас открыт файл.

58 66

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code editor showing the Spark icon in the Editor Toolbar" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="Редактор VS Code со значком Spark на панели инструментов редактора" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68

61 Другие способы открыть Claude Code:69 Другие способы открыть Claude Code:

62 70

63 * **Activity Bar**: нажмите значок Spark на левой боковой панели, чтобы открыть список сеансов. Нажмите на любой сеанс, чтобы открыть его в вашем [предпочитаемом месте](#extension-settings), или начните новый. Этот значок всегда виден на Activity Bar.71 * **Панель действий (Activity Bar)**: нажмите на значок Spark на левой боковой панели, чтобы открыть список сессий. Нажмите на любую сессию, чтобы открыть её в [предпочитаемом расположении](#extension-settings), или начните новую. Этот значок всегда виден на панели действий.

~~64 * **Command Palette**: `Cmd+Shift+P` (Mac) или `Ctrl+Shift+P` (Windows/Linux), введите "Claude Code" и выберите опцию, например "Open in New Tab"~~72 * **Палитра команд**: `Cmd+Shift+P` (Mac) или `Ctrl+Shift+P` (Windows/Linux), введите «Claude Code» и выберите вариант, например «Open in New Tab»

~~65 * **Status Bar**: нажмите **✻ Claude Code** в нижнем правом углу окна. Это работает даже при отсутствии открытого файла.~~73 * **Строка состояния**: нажмите **✻ Claude Code** в правом нижнем углу окна. Это работает, даже когда ни один файл не открыт.

66 74

67 Вы можете перетащить панель Claude в любое место VS Code. Подробнее см. в разделе [Настройка вашего рабочего процесса](#customize-your-workflow).75 Вы можете перетащить панель Claude в любое место VS Code. Подробнее см. в разделе [Настройка рабочего процесса](#customize-your-workflow).

68 </Step>76 </Step>

69 77

70 <Step title="Войдите в систему">78 <Step title="Войдите в систему">

71 При первом открытии панели появляется экран входа. Нажмите **Sign in** и завершите авторизацию в браузере.79 При первом открытии панели появляется экран входа. Нажмите **Sign in** и завершите авторизацию в браузере.

72 80

73 Если позже вы увидите **Not logged in · Please run /login**, расширение автоматически откроет экран входа. Если это не произойдет, перезагрузите окно из Command Palette с помощью **Developer: Reload Window**.81 Если позже вы увидите **Not logged in · Please run /login**, расширение автоматически снова откроет экран входа. Если он не появился, перезагрузите окно из палитры команд с помощью **Developer: Reload Window**.

74 82

75 Если у вас установлена переменная `ANTHROPIC_API_KEY` в оболочке, но вы все еще видите приглашение входа, VS Code может не унаследовать переменные окружения вашей оболочки. Запустите VS Code из терминала с помощью `code .`, чтобы он унаследовал переменные окружения, или вместо этого войдите с помощью своей учетной записи Claude.83 Если в вашей оболочке задана переменная `ANTHROPIC_API_KEY`, но запрос на вход всё равно появляется, возможно, VS Code не унаследовал окружение вашей оболочки. Запустите VS Code из терминала командой `code .`, чтобы он унаследовал ваши переменные окружения, или вместо этого войдите с помощью своей учётной записи Claude.

76 84

77 После входа появляется контрольный список **Learn Claude Code**. Пройдите каждый пункт, нажав **Show me**, или закройте его с помощью X. Чтобы открыть его позже, снимите флажок **Hide Onboarding** в параметрах VS Code в разделе Extensions → Claude Code.85 После входа появится контрольный список **Learn Claude Code**. Пройдите по каждому пункту, нажимая **Show me**, или закройте его с помощью X. Чтобы снова открыть его позже, снимите флажок **Hide Onboarding** в настройках VS Code в разделе **Extensions > Claude Code**.

78 </Step>86 </Step>

79 87

~~80 <Step title="Отправьте запрос">~~88 <Step title="Отправьте промпт">

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

82 90

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

84 92

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

86 94

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code editor with lines 2-3 selected in a Python file, and the Claude Code panel showing a question about those lines with an @-mention reference" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="Редактор VS Code с выделенными строками 2–3 в файле Python и панель Claude Code с вопросом об этих строках, содержащим ссылку с @-упоминанием" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97

~~90 <Step title="Проверьте изменения">~~98 <Step title="Просмотрите изменения">

91 То, что вы видите, зависит от [режима разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), показанного в нижней части поля запроса:99 <span id="security-considerations" />

100

101 <span id="security-and-privacy" />

102

103 Проверьте [режим разрешений](/docs/ru/permission-modes#which-mode-a-session-starts-in), отображаемый в нижней части поля ввода промпта:

92 104

~~93 * В режиме Auto или Edit automatically Claude редактирует большинство файлов в вашем рабочем пространстве без запроса.~~105 * В режиме Auto или Edit automatically Claude редактирует [большинство файлов](/docs/ru/permission-modes#protected-paths) в вашей рабочей области, не спрашивая.

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

95 107

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code showing a diff of Claude's proposed changes with a permission prompt asking whether to make the edit" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code с diff предлагаемых Claude изменений и запросом разрешения на внесение правки" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109

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

99 111

100 Те же действия доступны в курсоре из контекстного меню редактора и из Command Palette как **Claude Code: Accept Change at Cursor** и **Claude Code: Reject Change at Cursor**.112 Принятие или отклонение всего файла по-прежнему завершает просмотр. Diff, содержащий более 100 изменений, открывается без кнопок для отдельных изменений, поэтому просматривайте его как целый файл.

113

114 Те же действия доступны в позиции курсора из контекстного меню редактора и из палитры команд как **Claude Code: Accept Change at Cursor** и **Claude Code: Reject Change at Cursor**.

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117

104Для получения дополнительных идей о том, что вы можете делать с Claude Code, см. [Распространенные рабочие процессы](/docs/ru/common-workflows).118Больше идей о том, что можно делать с Claude Code, см. в разделе [Типичные рабочие процессы](/docs/ru/common-workflows).

105 119

106<Tip>120<Tip>

107 Запустите "Claude Code: Open Walkthrough" из Command Palette для пошагового руководства по основам.121 Запустите «Claude Code: Open Walkthrough» из палитры команд, чтобы пройти пошаговый обзор основ.

108</Tip>122</Tip>

109 123

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

113 127

114Поле ввода промпта поддерживает несколько функций:128Поле ввода промпта поддерживает несколько функций:

115 129

116* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и новее Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes).130* **Режимы разрешений**: нажмите на индикатор режима внизу поля ввода промпта, чтобы переключить режим разрешений. В Claude Code v2.1.283 и более поздних версиях Auto является встроенным начальным режимом разрешений, а в более ранних версиях — только на тарифах Pro, Max и Team. О том, что на это влияет, и обо всех режимах разрешений, которые предлагает индикатор, см. в разделе [как расширение выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes).

117 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).131 * **Auto**: классификатор проверяет большинство действий вместо того, чтобы спрашивать вас. О том, что он проверяет и блокирует, см. в разделе [авторежим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).

118 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и выполнением большинства shell-команд.132 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством shell-команд.

119 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения перед внесением изменений. VS Code автоматически открывает план как полноценный Markdown-документ, в котором можно добавлять встроенные комментарии, чтобы оставить отзыв до того, как Claude начнёт работу.133 * **Plan**: Claude описывает, что собирается сделать, и ждёт подтверждения, прежде чем вносить изменения. VS Code автоматически открывает план как полноценный документ Markdown, в котором можно добавлять встроенные комментарии, чтобы дать обратную связь до того, как Claude начнёт работу.

120 134

121 Также можно ввести `/plan` в поле ввода промпта. Требуется Claude Code v2.1.280 или новее.135 Также можно ввести `/plan` в поле ввода промпта. Требуется Claude Code v2.1.280 или более поздней версии.

122 136

123 * `/plan`: переключает в режим планирования. Если вы уже находитесь в режиме планирования, вместо этого показывает текущий план.137 * `/plan`: переключает в режим планирования. Если вы уже в режиме планирования, вместо этого показывает текущий план.

124 * `/plan` с задачей, например `/plan fix the auth bug`: переключает в режим планирования и начинает планирование этой задачи.138 * `/plan` с задачей, например `/plan fix the auth bug`: переключает в режим планирования и начинает планировать эту задачу.

125 * `/plan open`: если вы уже находитесь в режиме планирования, открывает файл плана в редакторе.139 * `/plan open`: если вы уже в режиме планирования, открывает файл плана в редакторе.

126 * **Edit automatically**: Claude вносит правки, не спрашивая.140 * **Edit automatically**: Claude вносит правки, не спрашивая.

127* **Модель**: выберите **Switch model…** в меню команд, чтобы сменить модель посреди сессии. Также можно нажать на название модели в нижней части поля ввода промпта, чтобы открыть то же окно выбора. В Claude Code v2.1.284 и новее окно выбора также открывается, если ввести в поле ввода промпта `/model` без аргументов.141* **Модель**: выберите **Switch model…** в меню команд, чтобы сменить модель посреди сессии. Также можно нажать на название модели внизу поля ввода промпта, чтобы открыть то же окно выбора. В Claude Code v2.1.284 и более поздних версиях окно выбора также открывается, если ввести в поле ввода промпта только `/model`.

128 142

129 Если текущая модель поддерживает [уровни effort](/docs/ru/model-config#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показан выбранный уровень. Когда вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в разделе [`modelSettings`](/docs/ru/settings-reference#modelsettings) ваших пользовательских настроек; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или новее.143 Если текущая модель поддерживает [уровни effort](/docs/ru/model-config#adjust-effort-level), в окне выбора также отображается строка **Effort**, а на кнопке с названием модели показывается выбранный уровень. Если вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как уровень по умолчанию в [`modelSettings`](/docs/ru/settings-reference#modelsettings) в ваших пользовательских настройках; `max` применяется только к текущей сессии. Кнопка с названием модели и строка **Effort** требуют Claude Code v2.1.257 или более поздней версии.

130 144

131 Когда включены [динамические рабочие процессы](/docs/ru/workflows) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](/docs/ru/workflows#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или новее.145 Если включены [динамические рабочие процессы](/docs/ru/workflows) и текущая модель их поддерживает, под строкой **Effort** появляется переключатель **Ultracode**. Включите его, чтобы Claude планировал [рабочий процесс](/docs/ru/workflows#let-claude-decide-with-ultracode) для каждой содержательной задачи в этой сессии с выбранным уровнем effort. Пока он включён, на кнопке с названием модели после уровня отображается `· Ultracode`. Переключатель требует Claude Code v2.1.284 или более поздней версии.

132* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение расширенного мышления.146* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Среди вариантов — прикрепление файлов, переключение моделей и включение или отключение расширенного мышления.

133 147

134 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.148 Раздел Customize содержит такие пункты, как MCP-серверы, команды, стили вывода, хуки, память, инструкции, разрешения и плагины. Пункты со значком терминала открываются во встроенном терминале.

135 149

136 * Чтобы просмотреть команды, такие как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Откроется диалоговое окно со списком команд и полем фильтра. Выберите команду, чтобы запустить её. При вводе `/` в поле ввода промпта команды по-прежнему предлагаются прямо в строке. Требуется Claude Code v2.1.257 или новее.150 * Чтобы просмотреть команды, такие как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Откроется диалоговое окно со списком команд и полем фильтра. Выберите команду, чтобы выполнить её. Ввод `/` в поле ввода промпта по-прежнему предлагает команды прямо в строке. Требуется Claude Code v2.1.257 или более поздней версии.

151

152 Ввод `/skills` также открывает это диалоговое окно. В каждой строке [скилла](/docs/ru/skills) отображается его [видимость](/docs/ru/skills#override-skill-visibility-from-settings), например **On** или **Name only**. Нажмите на значение видимости, чтобы изменить его, за исключением строк с пометкой **locked**, например скиллов плагинов. Сокращение `/skills` и элементы управления видимостью требуют Claude Code v2.1.280 или более поздней версии.

153 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требуется Claude Code v2.1.257 или более поздней версии.

137 154

138 Ввод `/skills` также открывает это диалоговое окно. В каждой строке [скилла](/docs/ru/skills) показана его [видимость](/docs/ru/skills#override-skill-visibility-from-settings), например **On** или **Name only**. Нажмите на значение видимости, чтобы изменить его, — кроме строк с пометкой **locked**, таких как скиллы плагинов. Сокращение `/skills` и элементы управления видимостью требуют Claude Code v2.1.280 или новее.155 Чтобы вместо этого создать пользовательский стиль, выберите **Build a custom style** в меню **Output styles**. Claude Code создаст для вас [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) на уровне проекта или пользователя. Требуется Claude Code v2.1.261 или более поздней версии.

139 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требуется Claude Code v2.1.257 или новее.156 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [хуки](/docs/ru/hooks), загруженные в сессии, сгруппированные по событиям. Можно добавлять, редактировать или удалять хуки, сохранённые в ваших файлах пользовательских, проектных и локальных настроек. Хуки из других источников, например из управляемых настроек или плагинов, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.

157 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сессии, сгруппированные на Allow, Ask и Deny. Можно добавлять правила в пользовательские, проектные или локальные настройки и удалять сохранённые там правила. Правила из других источников, например из управляемых настроек или подтверждений, данных только для этой сессии, доступны только для чтения. Требуется Claude Code v2.1.269 или более поздней версии.

158 * Выберите **Memory** в разделе Customize, чтобы включить или отключить [автоматическую память](/docs/ru/memory#auto-memory). Пока она включена, можно также просматривать воспоминания, сохранённые Claude, и открывать папки, в которых они хранятся, в файловом менеджере. Требуется Claude Code v2.1.274 или более поздней версии.

140 159

141 Чтобы вместо этого создать пользовательский стиль, выберите **Build a custom style** в меню **Output styles**. Claude Code сам создаст [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) на уровне проекта или пользователя. Требуется Claude Code v2.1.261 или новее.160 Нажмите на сохранённое воспоминание, чтобы прочитать его в диалоговом окне, где можно отредактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоговом окне требуют Claude Code v2.1.275 или более поздней версии.

142 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [хуки](/docs/ru/hooks), загруженные в сессии, сгруппированные по событиям. Вы можете добавлять, редактировать и удалять хуки, сохранённые в файлах пользовательских, проектных и локальных настроек. Хуки из других источников, например из управляемых настроек или плагинов, доступны только для чтения. Требуется Claude Code v2.1.269 или новее.161 * Выберите **Instructions** в разделе Customize, чтобы редактировать [файлы CLAUDE.md](/docs/ru/memory#claude-md-files), которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл ещё не существует, Claude Code сначала создаст его. Требуется Claude Code v2.1.274 или более поздней версии.

143 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сессии, сгруппированные по категориям Allow, Ask и Deny. Вы можете добавлять правила в пользовательские, проектные или локальные настройки и удалять сохранённые там правила. Правила из других источников, например из управляемых настроек или подтверждений, данных только для этой сессии, доступны только для чтения. Требуется Claude Code v2.1.269 или новее.162 * Выберите **Status** в разделе Customize или введите `/status`, чтобы проверить версию Claude Code, учётную запись, модель и сведения о MCP-серверах для сессии. Требуется Claude Code v2.1.280 или более поздней версии.

144 * Выберите **Memory** в разделе Customize, чтобы включить или отключить [автоматическую память](/docs/ru/memory#auto-memory). Пока она включена, вы также можете просматривать воспоминания, сохранённые Claude, и открывать папки, в которых они хранятся, в файловом менеджере. Требуется Claude Code v2.1.274 или новее.163 * Выберите **Sandbox** в разделе Customize или введите `/sandbox`, чтобы узнать, выполняются ли команды Bash от Claude [в песочнице](/docs/ru/sandboxing). Там же можно переключить режим песочницы и добавить [исключённые команды](/docs/ru/settings-reference#sandbox-excludedcommands). Требуется Claude Code v2.1.280 или более поздней версии.

164 * Выберите **Claude in Chrome** в разделе Customize или введите `/chrome`, чтобы проверить подключение [Claude in Chrome](/docs/ru/chrome) и управлять им. Оба способа требуют входа с учётной записью claude.ai. Требуется Claude Code v2.1.280 или более поздней версии.

165 * Выберите **Export conversation** в разделе Context или введите `/export`, чтобы скопировать диалог как обычный текст или сохранить его в файл. Добавьте имя файла, например `/export notes.txt`, чтобы пропустить диалоговое окно и выбрать, куда сохранить файл. Требуется Claude Code v2.1.280 или более поздней версии.

166 * Раздел Settings содержит пункт **Enable Remote Control for all sessions**, который задаёт [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) и определяет, будут ли [новые интерактивные сессии автоматически подключаться к Remote Control](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или более поздней версии.

145 167

146 Нажмите на сохранённое воспоминание, чтобы прочитать его в диалоговом окне, где можно отредактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоговом окне требуют Claude Code v2.1.275 или новее.168 Когда вы включаете или отключаете переключатель в окне VS Code, изменение касается не только сессий, которые вы запустите после этого. Оно также применяется к сессиям, уже открытым в этом окне VS Code. Если вы его отключите, открытые сессии отключатся. В Claude Code v2.1.261 и более поздних версиях изменение также распространяется на сессии, открытые в других ваших окнах VS Code.

147 * Выберите **Instructions** в разделе Customize, чтобы отредактировать [файлы CLAUDE.md](/docs/ru/memory#claude-md-files), которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл ещё не существует, Claude Code сначала создаст его. Требуется Claude Code v2.1.274 или новее.169 * Раздел Settings также содержит пункт **Focus view**, который скрывает вызовы инструментов, результаты инструментов и размышления за разворачиваемыми строками, оставляя ваши промпты и ответы Claude. Переключайте его там же, сочетанием `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) или из палитры команд с помощью **Claude Code: Toggle Focus view**. Изменение применяется ко всем открытым сессиям и сохраняется между сессиями. Требуется Claude Code v2.1.221 или более поздней версии.

148 * Выберите **Status** в разделе Customize или введите `/status`, чтобы проверить версию Claude Code, аккаунт, модель и сведения об MCP-серверах для сессии. Требуется Claude Code v2.1.280 или новее.

149 * Выберите **Sandbox** в разделе Customize или введите `/sandbox`, чтобы узнать, выполняются ли команды Bash от Claude [в песочнице](/docs/ru/sandboxing). Там же можно переключить режим песочницы и добавить [исключённые команды](/docs/ru/settings-reference#sandbox-excludedcommands). Требуется Claude Code v2.1.280 или новее.

150 * Выберите **Claude in Chrome** в разделе Customize или введите `/chrome`, чтобы проверить подключение [Claude in Chrome](/docs/ru/chrome) и управлять им. Оба способа требуют входа с аккаунтом claude.ai. Требуется Claude Code v2.1.280 или новее.

151 * Выберите **Export conversation** в разделе Context или введите `/export`, чтобы скопировать диалог как обычный текст или сохранить его в файл. Добавьте имя файла, например `/export notes.txt`, чтобы пропустить диалоговое окно и выбрать, куда сохранить файл. Требуется Claude Code v2.1.280 или новее.

152 * Раздел Settings содержит пункт **Enable Remote Control for all sessions**, который задаёт настройку [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup), определяющую, [подключаются ли новые интерактивные сессии к Remote Control автоматически](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или новее.

153 170

154 Когда вы включаете или отключаете этот переключатель в окне VS Code, изменение применяется к сессиям, уже открытым в этом окне VS Code, а не только к сессиям, которые вы запустите после этого. Если вы его отключите, открытые сессии отключатся. В Claude Code v2.1.261 и новее изменение также применяется к сессиям, открытым в других ваших окнах VS Code.171 Последний список задач Claude остаётся видимым, как и текст, о котором спрашивает ожидающий ответа вопрос от Claude; для этого требуется Claude Code v2.1.225 или более поздней версии. Пока Claude запускает [субагентов](/docs/ru/sub-agents), под группой вызовов инструментов, которая их запустила, появляются строки с ходом выполнения в реальном времени и их последней активностью. Для этого требуется Claude Code v2.1.269 или более поздней версии.

155 * Раздел Settings также содержит пункт **Focus view**, который скрывает вызовы инструментов, результаты инструментов и размышления за раскрываемыми строками, оставляя ваши промпты и ответы Claude. Переключить его можно там же, сочетанием клавиш `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) или из палитры команд с помощью **Claude Code: Toggle Focus view**. Изменение применяется ко всем открытым сессиям и сохраняется между сессиями. Требуется Claude Code v2.1.221 или новее.172 * Чтобы выйти из учётной записи Anthropic, выберите **Sign out** в разделе Settings или введите `/logout`. При использовании [стороннего провайдера](#use-third-party-providers) меню не предлагает ни того, ни другого. Требуется Claude Code v2.1.277 или более поздней версии.

173 * Чтобы сообщить об ошибке, нажмите **Report a problem** внизу меню или введите `/bug` или `/feedback` с необязательным описанием, которым будет предварительно заполнен отчёт. Когда вы отправляете отчёт и при этом вошли в Anthropic через собственное подключение Anthropic, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или более поздней версии.

156 174

157 Последний список задач Claude остаётся видимым, как и текст, о котором спрашивает ожидающий ответа вопрос от Claude; это требует Claude Code v2.1.225 или новее. Пока Claude выполняет [субагентов](/docs/ru/sub-agents), строки с их текущим прогрессом и последней активностью отображаются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или новее.175 При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как [локальный архив в `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), в котором известные шаблоны API-ключей и токенов скрыты. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или более поздней версии.

158 * Чтобы выйти из аккаунта Anthropic, выберите **Sign out** в разделе Settings или введите `/logout`. При использовании [стороннего провайдера](#use-third-party-providers) меню не предлагает ни того, ни другого. Требуется Claude Code v2.1.277 или новее.

159 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню или введите `/bug` либо `/feedback` с необязательным описанием, которое предварительно заполнит отчёт. Когда вы отправляете отчёт, будучи авторизованным в Anthropic через прямое подключение, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или новее.

160 176

161 При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как [локальный архив в `~/.claude/feedback-bundles/`](/docs/ru/data-usage#telemetry-services), в котором скрыты известные шаблоны API-ключей и токенов. Отправьте этот файл представителю вашего аккаунта в Anthropic или прикрепите его к обращению в поддержку. В подтверждении указано имя файла и есть кнопка **Show folder**. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или новее.177 После сохранения отчёта в подтверждении указывается имя файла и есть кнопка **Show folder**. Отправьте этот файл представителю вашей учётной записи в Anthropic или прикрепите его к обращению в службу поддержки.

162 178

163 Если политика вашей организации отключает отзывы о продукте, пункт **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`, отзывы также отключаются, и при открытии отчёта вместо него отображается это уведомление.179 Если политика вашей организации отключает отзывы о продукте, пункт **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`, отзывы также отключаются, и при открытии отчёта вместо него показывается это уведомление.

164* **Побочные вопросы**: введите `/btw`, а затем вопрос, чтобы спросить о своей сессии, [не добавляя его в диалог](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается на панели рядом с чатом, где можно задавать уточняющие вопросы. Ветка сохраняется при перезагрузке окна. Claude Code хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), если Claude Code может [безопасно определить срок хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить ветку, нажмите на значок корзины на панели. Требуется Claude Code v2.1.227 или новее.180* **Побочные вопросы**: введите `/btw`, а затем вопрос, чтобы спросить о вашей сессии, [не добавляя его в диалог](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается на панели рядом с чатом, где можно задавать уточняющие вопросы. Требуется Claude Code v2.1.227 или более поздней версии.

165* **Копирование ответа**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует предпоследний. Требуется Claude Code v2.1.277 или новее.181

182 Ветка сохраняется при перезагрузке окна. Claude Code хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), если Claude Code может [безопасно определить срок хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить ветку, нажмите на значок корзины на панели.

183* **Копирование ответа**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует предпоследний. Требуется Claude Code v2.1.277 или более поздней версии.

166* **Закладки**: наведите курсор на ответ и нажмите **Bookmark response**, чтобы сохранить его, или нажмите **Remove bookmark** на сохранённом ответе, чтобы удалить закладку.184* **Закладки**: наведите курсор на ответ и нажмите **Bookmark response**, чтобы сохранить его, или нажмите **Remove bookmark** на сохранённом ответе, чтобы удалить закладку.

167 185

168 Чтобы просмотреть сохранённые ответы, откройте панель Bookmarks: нажмите на значок закладки в верхней части панели Claude Code, выберите **Bookmarks** в разделе Context меню команд или введите `/bookmarks`. Требуется Claude Code v2.1.286 или новее.186 Чтобы просмотреть сохранённые ответы, откройте панель Bookmarks. Можно нажать на значок закладки вверху панели Claude Code, выбрать **Bookmarks** в разделе Context меню команд или ввести `/bookmarks`. Требуется Claude Code v2.1.286 или более поздней версии.

169* **Файлы, которые вам отправляет Claude**: когда сессия подключена к [Remote Control](/docs/ru/remote-control#start-a-remote-control-session) и Claude отправляет вам файлы с помощью [инструмента `SendUserFile`](/docs/ru/tools-reference), в диалоге отображается строка, например **Sent report.md, chart.png**. Нажмите на имя файла, чтобы открыть его в редакторе.187* **Файлы, которые отправляет вам Claude**: когда сессия подключена к [Remote Control](/docs/ru/remote-control#start-a-remote-control-session) и Claude отправляет вам файлы с помощью [инструмента `SendUserFile`](/docs/ru/tools-reference), в диалоге отображается строка вида **Sent report.md, chart.png**. Нажмите на имя файла, чтобы открыть его в редакторе.

170* **Индикатор контекста**: поле ввода промпта показывает, какая часть контекстного окна Claude используется. Claude автоматически выполняет сжатие контекста при необходимости, или вы можете запустить `/compact` вручную.188* **Индикатор контекста**: поле ввода промпта показывает, какую часть контекстного окна Claude вы используете. Claude автоматически выполняет сжатие контекста при необходимости, или вы можете запустить `/compact` вручную.

171* **Часы кэша промптов**: значок часов рядом с индикатором контекста показывает приблизительное время, оставшееся до истечения [кэша промптов](/docs/ru/prompt-caching) диалога. Отсчёт идёт от пятиминутного или часового [срока жизни](/docs/ru/prompt-caching#cache-lifetime) кэша, и каждый ответ, использующий кэш, перезапускает отсчёт. Помимо сжатия контекста, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому после смены модели они всё ещё могут показывать оставшиеся минуты.189* **Часы кэша промптов**: значок часов рядом с индикатором контекста оценивает, сколько времени осталось до истечения срока действия [кэша промптов](/docs/ru/prompt-caching) диалога. Он отсчитывает время от пятиминутного или часового [срока жизни](/docs/ru/prompt-caching#cache-lifetime) кэша, и каждый ответ, использующий кэш, перезапускает отсчёт. Помимо сжатия контекста, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому после смены модели они всё ещё могут показывать оставшиеся минуты.

172 * Пока отсчёт не закончился, значок показывает оставшиеся минуты, например **12m**.190 * Пока отсчёт не закончился, значок показывает оставшиеся минуты, например **12m**.

173 * Когда отсчёт заканчивается, минуты исчезают, а значок становится красным (или цвета ошибки в вашей теме) до следующего ответа. Кэш, скорее всего, истёк, поэтому ожидайте более медленного и дорогого ответа на следующее сообщение, пока кэш создаётся заново. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел [Выбор TTL вручную](/docs/ru/prompt-caching#choose-the-ttl-yourself).191 * Когда отсчёт заканчивается, минуты исчезают, а значок становится красным или цвета ошибки вашей темы до следующего ответа. Срок действия кэша, скорее всего, истёк, поэтому ожидайте более медленный и более дорогой ответ на следующее сообщение, пока кэш перестраивается. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел [Выбор TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself).

174 * Сразу после [сжатия](/docs/ru/prompt-caching#compacting-the-conversation) диалога значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.192 * Сразу после [сжатия диалога](/docs/ru/prompt-caching#compacting-the-conversation) значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.

175* **Карта агентов**: когда диалог включает [субагентов](/docs/ru/sub-agents), в нижней части поля ввода промпта появляется счётчик агентов, например **2 agents**. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения.193* **Карта агентов**: когда диалог включает [субагентов](/docs/ru/sub-agents), внизу поля ввода промпта появляется счётчик агентов, например **2 agents**. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения.

176 194

177 Нажмите на счётчик агентов, чтобы открыть карту агентов, которая отображает субагентов диалога в виде дерева под основным агентом, с указанием статуса, затраченного времени и количества токенов для каждого. Нажмите на субагента, чтобы увидеть его промпт и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требуется Claude Code v2.1.269 или новее.195 Нажмите на счётчик агентов, чтобы открыть карту агентов, на которой субагенты диалога изображены в виде дерева под основным агентом, у каждого — статус, затраченное время и количество токенов. Нажмите на субагента, чтобы увидеть его промпт и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требуется Claude Code v2.1.269 или более поздней версии.

178 196

179 Под агентами на карте также перечислены другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сессии, например фоновые shell-команды и [мониторы](/docs/ru/tools-reference#monitor-tool). Нажмите на строку, чтобы открыть карточку задачи и остановить её там.197 На карте также перечислены другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сессии, такие как фоновые shell-команды и [мониторы](/docs/ru/tools-reference#monitor-tool), под агентами. Нажмите на строку, чтобы открыть карточку задачи и остановить её там.

180 198

181 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или новее.199 Чтобы открыть карту, когда счётчик агентов не отображается, например когда Claude запустил фоновую оболочку, но не запустил субагентов, введите `/tasks` в поле ввода промпта. Фоновые задачи на карте и ввод `/tasks` требуют Claude Code v2.1.277 или более поздней версии.

182 200

183 В Claude Code v2.1.286 и новее, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не завершатся или пока вы не остановите их с карты.201 В Claude Code v2.1.286 и более поздних версиях, когда вы нажимаете **Stop** или клавишу `Esc`, текущий ход завершается. Фоновые агенты продолжают работать, пока не закончат или пока вы не остановите их с карты.

184* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (`/`). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе [Расширенное мышление](/docs/ru/model-config#extended-thinking).202* **Расширенное мышление**: позволяет Claude тратить больше времени на рассуждения над сложными задачами. Включите его через меню команд (`/`). Размышления Claude отображаются в диалоге в виде свёрнутых блоков: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть все блоки размышлений в сессии. Подробнее см. в разделе [Расширенное мышление](/docs/ru/model-config#extended-thinking).

185* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.203* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного ввода «Other» в диалоговых окнах с вопросами.

186 204

195What's in @src/components/ (include a trailing slash for folders)213What's in @src/components/ (include a trailing slash for folders)

196```214```

197 215

198Для больших PDF-файлов можно попросить Claude прочитать определённые страницы вместо всего файла: одну страницу, диапазон, например страницы 1–10, или открытый диапазон, например начиная со страницы 3. Чтение определённых страниц требует наличия [poppler-utils](/docs/ru/tools-reference#read-tool-behavior) на машине, где работает Claude Code.216Для больших PDF-файлов можно попросить Claude прочитать определённые страницы вместо всего файла. Запросите одну страницу, диапазон, например страницы 1–10, или открытый диапазон, например со страницы 3 и далее. Чтение определённых страниц требует наличия [poppler-utils](/docs/ru/tools-reference#read-tool-behavior) на машине, где работает Claude Code.

217

218Когда вы выделяете текст в редакторе, Claude автоматически видит выделенный код. В нижней части поля ввода промпта показывается, сколько строк выделено. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путём к файлу и номерами строк, например `@app.ts#5-10`. Нажмите **X** на индикаторе выделения, чтобы убрать его, и тогда Claude не получит выделение. Индикатор вернётся, когда вы выделите другой текст.

219

220Расширение не передаёт выделенный текст из некоторых файлов:

199 221

200Когда вы выделяете текст в редакторе, Claude автоматически видит выделенный код. В нижней части поля ввода промпта отображается количество выделенных строк. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путём к файлу и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы убрать его, и тогда Claude не получит выделенный фрагмент. Индикатор появится снова, когда вы выделите другой текст.222* Если файл находится внутри вашей рабочей области и соответствует настройкам `files.exclude` или `search.exclude`, Claude получает не более чем путь к файлу, но не выделенный вами текст.

223* То же самое относится к файлу, который игнорируется git, при условии что настройка VS Code `search.useIgnoreFiles` и [настройка `respectGitIgnore`](#extension-settings) расширения обе включены, что является значением по умолчанию.

201 224

202Расширение не передаёт выделенный текст из некоторых файлов. Если файл находится внутри вашей рабочей области и соответствует настройкам `files.exclude` или `search.exclude`, Claude получает не более чем путь к файлу, но не выделенный вами текст. То же относится к файлу, который игнорирует git, при условии что настройка VS Code `search.useIgnoreFiles` и [настройка расширения `respectGitIgnore`](#extension-settings) обе включены, что является поведением по умолчанию. Этот фильтр действует только для панели чата: когда Claude Code работает во встроенном терминале, CLI отправляет выделенный текст независимо от файла, поэтому добавьте [правило запрета `Read`](#the-built-in-ide-mcp-server), чтобы скрыть содержимое файла от Claude в этом случае.225Этот фильтр распространяется только на панель чата. Когда Claude Code работает во встроенном терминале, CLI отправляет выделенный текст независимо от файла. Чтобы скрыть содержимое файла от Claude в этом случае, добавьте [правило запрета `Read`](#the-built-in-ide-mcp-server).

203 226

204Claude также видит, какой файл открыт в редакторе, даже когда ничего не выделено, а поле ввода промпта показывает его имя. Чтобы добавлять только выделенный текст, отключите [настройку Attach Open File](vscode://settings/claudeCode.attachOpenFile). Эта настройка требует Claude Code v2.1.271 или новее.227Claude также видит, какой файл открыт в редакторе, даже если ничего не выделено, и поле ввода промпта показывает его имя. Чтобы добавлять только выделенный текст, отключите [настройку Attach Open File](vscode://settings/claudeCode.attachOpenFile). Эта настройка требует Claude Code v2.1.271 или более поздней версии.

205 228

206Вы также можете прикреплять к сообщению изображения и файлы:229Также можно прикреплять к сообщению изображения и файлы:

207 230

208* Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода промпта.231* Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода промпта.

209* Чтобы прикрепить файлы, перетащите их в поле ввода промпта, удерживая `Shift`.232* Чтобы прикрепить файлы, перетащите их в поле ввода промпта, удерживая `Shift`.

210* Чтобы удалить вложение из контекста, нажмите на X на нём.233* Чтобы удалить вложение из контекста, нажмите на X на нём.

211 234

235<h3 id="include-terminal-output-in-prompts">

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

237</h3>

238

239Ссылайтесь на вывод терминала в промптах с помощью `@terminal:name`, где `name` — заголовок терминала. Это позволяет Claude видеть вывод команд, сообщения об ошибках или логи без копирования и вставки.

240

212<h3 id="paste-text">241<h3 id="paste-text">

213 Вставка текста242 Вставка текста

214</h3>243</h3>

215 244

216Вставленный текст остаётся видимым в поле ввода промпта, а не сворачивается в заполнитель, как это происходит [в терминале](/docs/ru/terminal-config#paste-large-content). В сессиях, где Claude Code [помечает вставленный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text), Claude по-прежнему воспринимает большую вставку как вставленный, а не набранный вами текст.245Вставленный текст остаётся видимым в поле ввода промпта, а не сворачивается в заполнитель, как это происходит [в терминале](/docs/ru/terminal-config#paste-large-content). В сессиях, где Claude Code [помечает вставленный текст](/docs/ru/terminal-config#how-claude-treats-pasted-text), Claude по-прежнему видит большой фрагмент как вставленный вами текст, а не набранный.

217 246

218Claude Code также удаляет [невидимые символы Unicode](/docs/ru/interactive-mode#invisible-characters-in-prompts) из текста, который вы вставляете в поле ввода промпта, и из всего остального, что вы отправляете:247Claude Code также удаляет [невидимые символы Unicode](/docs/ru/interactive-mode#invisible-characters-in-prompts) из текста, который вы вставляете в поле ввода промпта, и из всего остального, что вы отправляете:

219 248

220* Если при вставке появляется уведомление вида `Removed 3 invisible characters from the pasted text`, текст был вставлен без этих символов.249* Если при вставке появляется уведомление, например `Removed 3 invisible characters from the pasted text`, текст был вставлен без этих символов.

221* Если уведомление об удалённых символах появляется при отправке, ничего не было отправлено. Очищенный текст возвращается в поле ввода промпта. Отправьте ещё раз, чтобы отправить текст в показанном виде.250* Если уведомление об удалённых символах появляется при отправке, ничего не было отправлено. Очищенный текст возвращается в поле ввода промпта. Отправьте снова, чтобы отправить текст в том виде, в котором он отображается.

222 251

223<h3 id="latex-math-in-responses">252<h3 id="latex-math-in-responses">

224 Математические формулы LaTeX в ответах253 Математика LaTeX в ответах

225</h3>254</h3>

226 255

227Панель чата отображает математические формулы LaTeX в ответах Claude в виде свёрстанных формул. Отображение формул требует Claude Code v2.1.301 или новее. В [режиме терминала](#switch-to-terminal-mode) формулы не верстаются. Панель верстает как выносные, так и строчные формулы:256Панель чата отображает математические выражения LaTeX в ответах Claude в виде свёрстанных формул. Отрисовка математики требует Claude Code v2.1.301 или более поздней версии. В [режиме терминала](#switch-to-terminal-mode) математика не верстается. Панель верстает как выносные, так и строчные формулы:

228 257

229* **Выносные формулы**: блок `$$ … $$` или `\[ … \]` на отдельной строке или строках, а также огороженный блок кода с языком `math`258* **Выносные формулы**: блок `$$ … $$` или `\[ … \]` на отдельной строке или строках, а также огороженный блок кода с языком `math`

230* **Строчные формулы**: `$…$` или `$…$`, которые открываются и закрываются в одной строке, например `$E = mc^2$` или `$a^2 + b^2 = c^2$`259* **Строчные формулы**: `$…$` или `$…$`, которые открываются и закрываются на одной строке, например `$E = mc^2$` или `$a^2 + b^2 = c^2$`

231 260

232Панель пытается отличать формулы от других случаев использования тех же символов, поэтому такой текст, как `$HOME`, цена вроде `$5` или `sed 's/$foo$/\1/'`, не верстается. Не верстается и текст внутри фрагмента кода или внутри любого блока кода, кроме огороженного блока `math`. Если формула отображается в исходном виде, хотя вы ожидали свёрстанную, см. раздел [Формула отображается как необработанный LaTeX](#a-formula-shows-as-raw-latex).261Панель пытается отличать математику от других вариантов использования тех же символов, поэтому такой текст, как `$HOME`, цена вроде `$5` или `sed 's/$foo$/\1/'`, не верстается. Не верстается и текст внутри фрагмента кода или внутри любого блока кода, кроме огороженного блока `math`. Если формула отображается в исходном виде, хотя вы ожидали её свёрстанной, см. раздел [Формула отображается как необработанный LaTeX](#a-formula-shows-as-raw-latex).

233 262

234Когда вы выделяете и копируете текст, содержащий свёрстанную формулу, вы получаете исходный код TeX этой формулы в разделителях `$…$` или `$$…$$`, а не отрисованные символы. [**Copy response**](#use-the-prompt-box) и `/copy` выдают ответ в том виде, в каком его написал Claude, включая исходный код TeX.263Когда вы выделяете и копируете текст, содержащий свёрстанную формулу, вы получаете исходный код TeX формулы в разделителях `$…$` или `$$…$$`, а не отрисованные символы. [**Copy response**](#use-the-prompt-box) и `/copy` дают ответ в том виде, в котором его написал Claude, включая исходный код TeX.

235 264

236<h3 id="resume-past-conversations">265<h3 id="resume-past-conversations">

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

238</h3>267</h3>

239 268

240Нажмите кнопку **Session history** в верхней части панели Claude Code, чтобы открыть историю диалогов. Можно искать по ключевому слову или просматривать по времени.269Нажмите кнопку **Session history** вверху панели Claude Code, чтобы получить доступ к истории диалогов. Можно искать по ключевому слову или просматривать по времени.

270

271Нажмите на любой диалог, чтобы возобновить его с полной историей сообщений. Если диалог уже открыт в другой вкладке текущего окна, нажатие переключит на эту вкладку. Если сообщения поначалу остаются пустыми, см. раздел [почему они пустые и когда появляются](#a-resumed-conversation-is-blank-at-first). Подробнее о возобновлении сессий см. в разделе [Управление сессиями](/docs/ru/sessions).

241 272

242Нажмите на любой диалог, чтобы возобновить его с полной историей сообщений. Если диалог уже открыт в другой вкладке текущего окна, нажатие переключит вас на эту вкладку. Если сообщения поначалу остаются пустыми, см. раздел [почему они пусты и когда появятся](#a-resumed-conversation-is-blank-at-first). Подробнее о возобновлении сессий см. в разделе [Управление сессиями](/docs/ru/sessions).273* **Заголовки сессий**: новые сессии получают сгенерированные ИИ заголовки на основе вашего первого сообщения.

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

243 275

244* **Названия сессий**: новые сессии получают названия, сгенерированные ИИ на основе вашего первого сообщения.276Если диалог открыт в другом процессе Claude Code, например `claude` в терминале или в другом окне VS Code, вместо поля ввода промпта появляется следующее уведомление:

245* **Переименование и архивирование**: наведите курсор на сессию, чтобы увидеть эти действия. Переименуйте её, чтобы дать описательное название, или заархивируйте, чтобы переместить в группу **Archived sessions** в нижней части списка.

246 277

247Если диалог (сам разговор с Claude, а не окно) открыт в другом процессе Claude Code, например в `claude` в терминале или в другом окне VS Code, вместо поля ввода промпта появляется уведомление: `This conversation is still open somewhere else. Using it in two places at once can mix up its messages.` Чтобы продолжить здесь, закройте этот диалог в другом месте, а затем нажмите **Open here anyway**. Если нажать, не закрыв его, диалог будет открыт в обоих местах. Если задана настройка [`claudeProcessWrapper`](#extension-settings), расширение пропускает эту проверку и сразу открывает диалог.278```text theme={null}

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

280```

248 281

249По умолчанию сессия без активности в течение 14 дней автоматически перемещается в **Archived sessions**, если она не открыта, не является непрочитанной и не находится в [группе](#organize-sessions-into-groups). Автоматическое архивирование требует Claude Code v2.1.265 или новее. Чтобы изменить период или отключить эту функцию, откройте [настройку Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.282Чтобы продолжить здесь, закройте диалог в другом месте, а затем нажмите **Open here anyway**. Если нажать, не закрыв его, диалог будет открыт в обоих местах. Если задана настройка [`claudeProcessWrapper`](#extension-settings), расширение пропускает эту проверку и открывает диалог напрямую.

250 283

251Чтобы восстановить заархивированную сессию, разверните **Archived sessions** и нажмите **Unarchive session**. Чтобы восстановить все заархивированные сессии сразу, наведите курсор на заголовок **Archived sessions** в списке сессий на панели действий и нажмите на его значок разархивирования; для этого требуется Claude Code v2.1.277 или новее. До v2.1.257 это действие называлось **Delete session** и скрывало сессию без возможности её восстановить. Удалённые тогда сессии появятся в **Archived sessions** после обновления.284По умолчанию сессия без активности в течение 14 дней автоматически перемещается в **Archived sessions**, если она не открыта, не является непрочитанной и не находится в [группе](#organize-sessions-into-groups). Автоматическая архивация требует Claude Code v2.1.265 или более поздней версии. Чтобы изменить период или отключить её, откройте [настройку Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.

252 285

253Если возобновляемый диалог завершился в режиме планирования, Claude Code восстанавливает режим планирования. Требуется Claude Code v2.1.246 или новее. Claude Code не восстанавливает его в следующих случаях:286Чтобы восстановить заархивированные сессии:

287

288* **Одна сессия**: разверните **Archived sessions** и нажмите **Unarchive session**.

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

290

291До v2.1.257 это действие называлось **Delete session** и скрывало сессию без возможности восстановления. Сессии, которые вы тогда удалили, после обновления появятся в разделе **Archived sessions**.

292

293Если возобновляемый диалог завершился в режиме планирования, Claude Code восстанавливает режим планирования. Требуется Claude Code v2.1.246 или более поздней версии. Claude Code не восстанавливает его в следующих случаях:

254 294

255* Расширение [выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes) из `claudeCode.initialPermissionMode` или из выбора, перенесённого из более раннего диалога295* Расширение [выбирает начальный режим разрешений](/docs/ru/permission-modes#switch-permission-modes) из `claudeCode.initialPermissionMode` или из выбора, перенесённого из более раннего диалога

256* У вас настроен `claudeCode.claudeProcessWrapper`296* У вас настроен `claudeCode.claudeProcessWrapper`

257* [Правило запрета](/docs/ru/permissions#manage-permissions) удаляет инструмент [`ExitPlanMode`](/docs/ru/tools-reference)297* [Правило запрета](/docs/ru/permissions#manage-permissions) удаляет инструмент [`ExitPlanMode`](/docs/ru/tools-reference)

258 298

259<h3 id="resume-cloud-sessions-from-claude-ai">299<h3 id="resume-cloud-sessions-from-claude-ai">

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

261</h3>301</h3>

262 302

263Если вы используете [облачные сессии](/docs/ru/claude-code-on-the-web), их можно возобновлять прямо в VS Code. Для этого требуется вход через **Claude.ai Subscription**, а не Anthropic Console.303Если вы запускаете [облачные сессии](/docs/ru/claude-code-on-the-web), их можно возобновлять прямо в VS Code. Для этого требуется вход с помощью **Claude.ai Subscription**, а не Anthropic Console.

264 304

265<Steps>305<Steps>

266 <Step title="Откройте историю сессий">306 <Step title="Откройте историю сессий">

267 Нажмите кнопку **Session history** в верхней части панели Claude Code.307 Нажмите кнопку **Session history** вверху панели Claude Code.

268 </Step>308 </Step>

269 309

270 <Step title="Выберите вкладку Web">310 <Step title="Выберите вкладку Web">

271 В диалоговом окне есть две вкладки: Local и Web. Нажмите **Web**, чтобы увидеть сессии из claude.ai.311 В диалоговом окне отображаются две вкладки: Local и Web. Нажмите **Web**, чтобы увидеть сессии из claude.ai.

272 </Step>312 </Step>

273 313

274 <Step title="Выберите сессию для возобновления">314 <Step title="Выберите сессию для возобновления">

275 Просмотрите сессии или выполните поиск. Нажмите на одну из них, чтобы продолжить диалог локально.315 Просмотрите сессии или найдите нужную. Нажмите на сессию, чтобы продолжить диалог локально.

276 </Step>316 </Step>

277</Steps>317</Steps>

278 318

282 При возобновлении облачной сессии расширение загружает копию истории диалога; изменения не синхронизируются обратно с claude.ai.322 При возобновлении облачной сессии расширение загружает копию истории диалога; изменения не синхронизируются обратно с claude.ai.

283</Note>323</Note>

284 324

285На вкладке Web также перечислены ваши сессии [Remote Control](/docs/ru/remote-control). Если вы нажмёте на сессию, которая выполнялась в открытой у вас папке, расширение откроет этот локальный диалог вместо загрузки копии и переключится на вкладку, где он уже отображается, если такая есть. Если расширение не может исключить, что диалог открыт в другом процессе Claude, вместо этого вы получите загруженную копию.325На вкладке Web также перечислены ваши сессии [Remote Control](/docs/ru/remote-control). Если нажать на сессию, которая выполнялась в открытой у вас папке, расширение откроет этот локальный диалог вместо загрузки копии. Расширение переходит на вкладку, в которой он уже отображается, если такая есть. Если расширение не может исключить, что диалог открыт другим процессом Claude, вместо этого вы получите загруженную копию.

286 326

287Если какую-либо часть диалога не удаётся загрузить, появляется ошибка, и копия не сохраняется. Выберите сессию снова, чтобы повторить попытку. Если вы выберете сессию, в которой ещё нет диалога для загрузки, в сообщении об ошибке будет указано, где её продолжить.327Если какую-либо часть диалога не удаётся загрузить, появляется ошибка и копия не сохраняется. Выберите сессию снова, чтобы повторить попытку. Если вы выбираете сессию, в которой ещё нет диалога для загрузки, ошибка сообщит, где его можно продолжить.

288 328

289<h3 id="check-account-and-usage">329<h3 id="check-account-and-usage">

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

291</h3>331</h3>

292 332

293Выполните `/usage`, чтобы открыть диалоговое окно Account & usage. В нём показан аккаунт, с которым вы вошли, а отображаемые данные об использовании зависят от способа входа:333Выполните `/usage`, чтобы открыть диалоговое окно Account & usage, в котором отображаются учётная запись, с которой вы вошли, и ваше использование. Показатели использования зависят от способа входа:

334

335* **Тариф claude.ai**: полосы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая полоса показывает, сколько времени осталось до сброса её лимита.

294 336

295* **Тариф claude.ai**: шкалы использования для лимитов вашего тарифа, например для текущей сессии и недели. Каждая шкала показывает, сколько времени осталось до сброса её лимита.337 Диалоговое окно также показывает разбивку того, что влияет на лимиты тарифа. Оно помечает модели поведения, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст и сессии с интенсивным использованием субагентов или высоким параллелизмом. Для каждого помеченного поведения даётся совет, как его сократить. Таблицы атрибуции показывают, сколько использования пришлось на каждый скилл, субагент, плагин и MCP-сервер.

296 338

297 Диалоговое окно также показывает, что влияет на расход лимитов тарифа. Оно помечает действия, на которые приходится 10% или более недавнего использования, например промахи кэша, длинный контекст, а также сессии с активным использованием субагентов или высоким параллелизмом, и для каждого даёт совет, как его снизить. Таблицы атрибуции показывают, какая доля использования пришлась на каждый скилл, субагент, плагин и MCP-сервер.339 Используйте переключатель Day и Week, чтобы переключаться между последними 24 часами и последними 7 днями. Показатели приблизительны и вычисляются по локальным сессиям на этой машине, поэтому использование с других устройств или claude.ai не учитывается.

340* **Другие способы входа**: когда лимиты тарифа не применяются к вашему способу входа, например при использовании [стороннего провайдера](#use-third-party-providers) или API-ключа, раздел Usage вместо этого показывает стоимость и использование токенов самой сессии. `/usage` в CLI показывает те же итоги в своём [блоке Session](/docs/ru/costs#track-your-costs). Список сессий на панели действий также показывает итоги активной сессии под заголовком **Account & usage**. Требуется Claude Code v2.1.277 или более поздней версии.

298 341

299 Используйте переключатель Day и Week, чтобы переключаться между последними 24 часами и последними 7 днями. Цифры приблизительные и рассчитываются по локальным сессиям на этой машине, поэтому использование с других устройств или claude.ai не учитывается.342Подробнее об отслеживании и сокращении использования см. в разделе [Отслеживание расходов](/docs/ru/costs#track-your-costs).

300* **Другие способы входа**: когда лимиты тарифа не применяются к вашему способу входа, например при использовании [стороннего провайдера](#use-third-party-providers) или API-ключа, в разделе Usage вместо этого отображаются стоимость и использование токенов самой сессии. Команда `/usage` в CLI показывает те же итоги в своём [блоке Session](/docs/ru/costs#track-your-costs). Список сессий на панели действий также показывает итоги активной сессии под заголовком **Account & usage**. Требуется Claude Code v2.1.277 или новее.

301 343

302Подробнее об отслеживании и сокращении использования см. в разделе [Отслеживание затрат](/docs/ru/costs#track-your-costs).344<h3 id="rewind-with-checkpoints">

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

346</h3>

347

348Расширение VS Code поддерживает чекпоинты, которые отслеживают правки файлов, сделанные Claude, и позволяют вернуться к предыдущему состоянию. Наведите курсор на любое сообщение, чтобы увидеть кнопку отката, затем выберите один из трёх вариантов:

349

350* **Fork conversation from here**: начать новую ветку диалога с этого сообщения, сохранив все изменения кода

351* **Rewind code to here**: откатить изменения файлов к этому моменту диалога, сохранив полную историю диалога

352* **Fork conversation and rewind code**: начать новую ветку диалога и откатить изменения файлов к этому моменту

353

354Подробнее о том, как работают чекпоинты, и об их ограничениях см. в разделе [Чекпоинты](/docs/ru/checkpointing).

303 355

304<h2 id="customize-your-workflow">356<h2 id="customize-your-workflow">

305 Настройте свой рабочий процесс357 Настройка рабочего процесса

306</h2>358</h2>

307 359

308Вы можете переместить панель Claude, запустить несколько разговоров, сгруппировать или отфильтровать список сеансов или переключиться в режим терминала.360Вы можете переместить панель Claude, вести несколько диалогов, группировать или фильтровать список сессий, а также переключиться в режим терминала.

309 361

310<h3 id="choose-where-claude-lives">362<h3 id="choose-where-claude-lives">

311 Выберите, где находится Claude363 Выбор расположения Claude

312</h3>364</h3>

313 365

314Вы можете перетащить панель Claude, чтобы переместить её в любое место в VS Code. Возьмитесь за вкладку или заголовок панели и перетащите её в:366Вы можете перетащить панель Claude в любое место в VS Code. Захватите вкладку или заголовок панели и перетащите её в одно из следующих мест:

315 367

316* **Вторичная боковая панель**: правая сторона окна. Держит Claude видимым во время кодирования.368* **Вторичная боковая панель**: правая часть окна. Claude остаётся на виду, пока вы пишете код.

317* **Основная боковая панель**: левая боковая панель со значками для Explorer, Search и т. д.369* **Основная боковая панель**: левая боковая панель со значками Explorer, Search и т. д.

318* **Область редактора**: открывает Claude как вкладку рядом с вашими файлами. Полезно для дополнительных задач.370* **Область редактора**: Claude открывается как вкладка рядом с вашими файлами. Удобно для побочных задач.

319 371

320Когда Claude открывает вкладку в новой группе редактора, расширение блокирует эту группу, поэтому файлы, которые вы открываете, пока вкладка Claude сфокусирована, переходят в другую группу вместо того, чтобы находиться рядом с ней.372Когда Claude открывает вкладку в новой группе редакторов, расширение блокирует эту группу. Файлы, которые вы открываете, пока вкладка Claude в фокусе, в этом случае попадают в другую группу, а не рядом с ней.

321 373

322Чтобы остановить расширение от блокировки групп, отключите [параметр Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Группы, которые уже заблокированы, остаются заблокированными, пока вы их не разблокируете. Этот параметр требует Claude Code v2.1.274 или более поздней версии.374Чтобы расширение не блокировало группы, отключите [настройку Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Уже заблокированные группы остаются заблокированными, пока вы их не разблокируете. Для этой настройки требуется Claude Code v2.1.274 или новее.

323 375

324<Tip>376<Tip>

325 Используйте боковую панель для вашего основного сеанса Claude и открывайте дополнительные вкладки для дополнительных задач. Claude запоминает ваше предпочтительное местоположение. Значок списка сеансов на панели действий отделён от панели Claude: список сеансов всегда виден на панели действий, а значок панели Claude появляется там только тогда, когда панель закреплена на левой боковой панели.377 Используйте боковую панель для основной сессии Claude и открывайте дополнительные вкладки для побочных задач. Claude запоминает выбранное вами расположение. Значок списка сессий на панели действий (Activity Bar) не связан с панелью Claude. Список сессий всегда доступен на панели действий, а значок панели Claude появляется там, только когда панель закреплена на левой боковой панели.

326</Tip>378</Tip>

327 379

328<h3 id="continue-conversations-after-a-reload">380<h3 id="continue-conversations-after-a-reload">

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

330</h3>382</h3>

331 383

332После запуска **Developer: Reload Window** или перезагрузки VS Code, вернётся ли разговор со своей историей разговора, зависит от того, где он был открыт:384После выполнения **Developer: Reload Window** или перезапуска VS Code проверьте, где был открыт диалог:

333 385

334* **Вкладка редактора**: разговор возвращается со своей вкладкой.386* **Вкладка редактора**: диалог возвращается вместе со своей вкладкой.

335* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не вернётся, возобновите разговор из [истории сеансов](#resume-past-conversations).387* **Боковая панель**: диалог возвращается, если в последние 10 минут вы отправили в нём сообщение или Claude ответил в нём. Если диалог не вернулся, возобновите его из [истории сессий](#resume-past-conversations).

336 388

337Если другой процесс Claude Code всё ещё держит этот диалог открытым, перед его открытием здесь у вас запросят подтверждение с тем же уведомлением **Open here anyway**, что и при [возобновлении из истории сессий](#resume-past-conversations). Если сообщения поначалу остаются пустыми, см. [почему они пустые и когда они появятся](#a-resumed-conversation-is-blank-at-first).389Если диалог всё ещё открыт в другом процессе Claude Code, перед его открытием здесь вас спросят об этом с тем же уведомлением **Open here anyway**, что и при [возобновлении из истории сессий](#resume-past-conversations). Если сообщения поначалу пустые, см. раздел [о том, почему они пустые и когда появятся](#a-resumed-conversation-is-blank-at-first).

390

391<h4 id="interrupted-steps-after-a-reload">

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

393</h4>

394

395Если перезагрузка прервала Claude посреди шага, Claude продолжит этот шаг, когда диалог вернётся, а уведомление в чате отметит продолжение. Требуется Claude Code v2.1.274 или новее. Если шаг был прерван более часа назад или сессия открыта в другом месте, диалог вернётся в неактивном состоянии.

396

397<h4 id="turn-off-continuation-after-a-reload">

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

399</h4>

338 400

339Если перезагрузка прервала Claude в середине шага, Claude продолжит этот шаг, когда разговор вернётся, и уведомление в чате отметит продолжение. Требует Claude Code v2.1.274 или более поздней версии. Если шаг был прерван более часа назад или сеанс открыт в другом месте, разговор вернётся в режиме ожидания.401Чтобы Claude не продолжал прерванный шаг после перезагрузки, откройте [настройку Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок.

340 402

341Чтобы отключить продолжение, откройте [настройку Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок. Установка [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables) или любой другой переменной `CLAUDE_CODE_RESUME_` в окружении VS Code или в [настройке `environmentVariables`](#extension-settings) не влияет на панель, поскольку расширение удаляет эти переменные перед запуском сессий панели.403Если вы задали [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ru/env-vars#variables) или любую другую переменную `CLAUDE_CODE_RESUME_` в окружении VS Code или в [настройке `environmentVariables`](#extension-settings), это не повлияет на панель. Дело в том, что расширение удаляет эти переменные перед запуском сессий панели.

342 404

343<h4 id="a-conversation-was-not-reopened">405<h4 id="a-conversation-was-not-reopened">

344 Диалог не был открыт повторно406 A conversation was not reopened

345</h4>407</h4>

346 408

347Если после перезагрузки появляется новый чат с подобным уведомлением над полем ввода промпта, это означает, что панель оставила ваш диалог закрытым, поскольку два последних открытия этого диалога не завершились:409Если после перезагрузки открылся новый чат с подобным уведомлением над полем ввода промпта, значит, панель оставила ваш диалог закрытым, потому что два последних его открытия не завершились:

348 410

349```text theme={null}411```text theme={null}

350“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.412“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.

351```413```

352 414

353Открытие не завершается, если панель аварийно завершает работу или перестаёт отвечать во время загрузки диалога, либо если вы перезагружаете или закрываете окно примерно в течение трёх секунд после его открытия. Ничего не теряется: диалог остаётся без изменений и сохраняется в [истории сессий](#resume-past-conversations).415Открытие не завершается, если панель аварийно завершает работу или перестаёт отвечать во время загрузки диалога, либо если вы перезагружаете или закрываете окно примерно в течение трёх секунд после его открытия. Диалог не изменяется и остаётся в [истории сессий](#resume-past-conversations).

354 416

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

356* **Чтобы оставить его закрытым**: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.418* **Чтобы оставить его закрытым**: продолжайте работать в новом чате. Уведомление исчезнет, как только вы отправите промпт.

357 419

358<h3 id="run-multiple-conversations">420<h3 id="run-multiple-conversations">

359 Запустите несколько разговоров421 Несколько диалогов одновременно

360</h3>422</h3>

361 423

362Используйте **Open in New Tab** или **Open in New Window** из палитры команд, чтобы начать дополнительные разговоры. Каждый разговор сохраняет свою собственную историю и контекст, позволяя вам работать над различными задачами параллельно.424Используйте **Open in New Tab** или **Open in New Window** из палитры команд, чтобы начать дополнительные диалоги. Каждый диалог хранит собственную историю и контекст, что позволяет работать над разными задачами параллельно.

363 425

364При использовании вкладок небольшая цветная точка на значке искры указывает статус: синий означает, что запрос разрешения ожидает, оранжевый означает, что Claude завершил работу, пока вкладка была скрыта.426При использовании вкладок небольшая цветная точка на значке искры показывает статус: синяя означает ожидающий запрос разрешения, оранжевая — что Claude завершил работу, пока вкладка была скрыта.

365 427

366<h3 id="organize-sessions-into-groups">428<h3 id="organize-sessions-into-groups">

367 Организуйте сеансы в группы429 Группировка сессий

368</h3>430</h3>

369 431

370В списке сеансов на панели действий вы можете собрать связанные сеансы в именованные, сворачиваемые группы. Требует Claude Code v2.1.229 или более поздней версии.432В списке сессий на панели действий можно объединять связанные сессии в именованные сворачиваемые группы. Требуется Claude Code v2.1.229 или новее.

371 433

372* **Сгруппировать или разгруппировать сеанс**: щёлкните правой кнопкой мыши на сеансе, чтобы создать группу из него, переместить его в существующую группу или удалить его из его группы. Каждый сеанс принадлежит одной группе одновременно, поэтому перемещение его в другую группу удаляет его из первой.434* **Добавление сессии в группу и удаление из неё**: щёлкните сессию правой кнопкой мыши, чтобы создать на её основе группу, переместить её в существующую группу или удалить из группы. Каждая сессия одновременно принадлежит только одной группе, поэтому при перемещении в другую группу она удаляется из первой.

373* **Переместить несколько сеансов одновременно**: `Cmd`-щелчок (Mac) / `Ctrl`-щелчок (Windows/Linux) на каждом сеансе или `Shift`-щелчок для выбора диапазона, затем щёлкните правой кнопкой мыши на выборе.435* **Перемещение нескольких сессий сразу**: щёлкните каждую сессию с `Cmd` (Mac) / `Ctrl` (Windows/Linux) или щёлкните с `Shift`, чтобы выбрать диапазон, затем щёлкните выделение правой кнопкой мыши.

374* **Сгруппировать сеанс из его вкладки**: запустите **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требует Claude Code v2.1.257 или более поздней версии.436* **Добавление сессии в группу с её вкладки**: выполните **Claude Code: Add Session Tab to Group** из палитры команд, затем выберите или создайте группу. Требуется Claude Code v2.1.257 или новее.

375* **Переименовать или удалить группу**: щёлкните правой кнопкой мыши на заголовке группы. Удаление группы удаляет только группу, и её сеансы возвращаются в список несгруппированных.437* **Переименование или удаление группы**: щёлкните заголовок группы правой кнопкой мыши. При удалении группы удаляется только сама группа, а её сессии возвращаются в список без группы.

376 438

377Расширение сохраняет группы для каждой папки рабочего пространства, поэтому они сохраняются при перезагрузке окна и появляются в каждом окне, где вы открываете одну и ту же папку. Когда вы ищете в списке, расширение показывает совпадения в одном плоском списке во всех группах.439Расширение сохраняет группы для каждой папки рабочей области, поэтому они сохраняются после перезагрузки окна и отображаются в каждом окне, где открыта та же папка. При поиске по списку расширение показывает совпадения единым плоским списком по всем группам.

378 440

379<h3 id="filter-the-sessions-list">441<h3 id="filter-the-sessions-list">

380 Отфильтруйте список сеансов442 Фильтрация списка сессий

381</h3>443</h3>

382 444

383Чтобы сузить длинный список сеансов на панели действий, используйте два элемента управления фильтром в верхней части списка. Требует Claude Code v2.1.271 или более поздней версии. Архивированные сеансы не отображаются, пока включен какой-либо фильтр.445Чтобы сократить длинный список сессий на панели действий, используйте два элемента фильтрации в верхней части списка. Требуется Claude Code v2.1.271 или новее. Архивированные сессии не отображаются, пока включён любой из фильтров.

384 446

385* **Active**: включите этот переключатель, чтобы показать только сеансы, которые требуют вашего ввода, работают или не прочитаны, плюс сеанс на вкладке Claude, на которой вы в последний раз сфокусировались.447* **Active**: включите этот переключатель, чтобы показывать только сессии, которые ожидают вашего ввода, выполняются или не прочитаны, а также сессию во вкладке Claude, на которой вы последний раз были в фокусе.

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

387 449

388Когда **Active** включен и вы устанавливаете флажок на статус, **Open** или **Closed**, список также показывает каждый сеанс, который соответствует вашим проверкам. Фильтры, которые вы установили, сохраняются при перезагрузке окна.450Когда **Active** включён и вы отмечаете статус, **Open** или **Closed**, в списке также отображаются все сессии, соответствующие отмеченным условиям. Заданные вами фильтры сохраняются после перезагрузки окна.

389 451

390<h3 id="switch-to-terminal-mode">452<h3 id="switch-to-terminal-mode">

391 Переключитесь в режим терминала453 Переключение в режим терминала

392</h3>454</h3>

393 455

394По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте [параметр Use Terminal](vscode://settings/claudeCode.useTerminal) и установите флажок.456По умолчанию расширение открывает графическую панель чата. Если вы предпочитаете интерфейс в стиле CLI, откройте [настройку Use Terminal](vscode://settings/claudeCode.useTerminal) и установите флажок.

395 457

396Вы также можете открыть параметры VS Code (`Cmd+,` на Mac или `Ctrl+,` на Windows/Linux), перейти в Extensions → Claude Code и установить флажок **Use Terminal**.458Также можно нажать `Cmd+,` на Mac или `Ctrl+,` на Windows/Linux, чтобы открыть настройки VS Code, перейти в **Extensions > Claude Code** и отметить **Use Terminal**.

397 459

398<h2 id="manage-plugins">460<h2 id="manage-plugins">

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

400</h2>462</h2>

401 463

402Расширение VS Code включает графический интерфейс для установки и управления [плагинами](/docs/ru/plugins/overview). Введите `/plugins` в поле подсказки, чтобы открыть интерфейс **Управление плагинами**.464Расширение VS Code включает графический интерфейс для установки [плагинов](/docs/ru/plugins/overview) и управления ими. Введите `/plugins` в поле промпта, чтобы открыть интерфейс **Manage plugins**.

403 465

404<h3 id="install-plugins">466<h3 id="install-plugins">

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

406</h3>468</h3>

407 469

408Диалоговое окно плагина показывает две вкладки: **Плагины** и **Маркетплейсы**.470В диалоговом окне плагинов есть две вкладки: **Plugins** и **Marketplaces**.

409 471

410На вкладке Плагины:472На вкладке Plugins:

411 473

412* **Установленные плагины** отображаются в верхней части с переключателями для их включения или отключения.474* **Установленные плагины** отображаются вверху с переключателями для их включения или отключения.

413 * Если вы отключите плагин, который включен в общем файле `.claude/settings.json` вашего проекта, расширение сначала спросит: **Отключить для меня** отключает его только для вас, а **Отключить для всех** изменяет общий файл.475 * Если вы отключаете плагин, который включён в общем файле `.claude/settings.json` вашего проекта, расширение сначала задаёт вопрос: **Disable for me** отключает его только для вас, а **Disable for everyone** изменяет общий файл.

414 * Для плагина, который не удалось загрузить, в его строке отображается краткая причина. Нажмите на причину, чтобы узнать, что можно сделать, включая копирование полного сообщения об ошибке для поиска в разделе [Устранение неполадок с плагинами](/docs/ru/plugins/troubleshooting).476 * Для плагина, который не удалось загрузить, в его строке отображается краткая причина. Нажмите на причину, чтобы узнать, что можно сделать, включая копирование полного сообщения об ошибке для поиска в разделе [Устранение неполадок с плагинами](/docs/ru/plugins/troubleshooting).

415* **Доступные плагины** из ваших настроенных маркетплейсов отображаются ниже477* **Доступные плагины** из настроенных вами маркетплейсов отображаются ниже

416* Используйте поиск для фильтрации плагинов по названию или описанию478* Используйте поиск, чтобы отфильтровать плагины по имени или описанию

417* Нажмите **Установить** на любом доступном плагине479* Нажмите **Install** у любого доступного плагина

418 480

419При установке плагина выберите область установки:481При установке плагина выберите область действия установки:

420 482

421* **Установить для вас**: доступно во всех ваших проектах (область пользователя)483* **Install for you**: доступен во всех ваших проектах (область действия пользователя)

422* **Установить для этого проекта**: общее использование с сотрудниками проекта (область проекта)484* **Install for this project**: доступен участникам проекта (область действия проекта)

423* **Установить локально**: только для вас, только в этом репозитории (локальная область)485* **Install locally**: только для вас и только в этом репозитории (локальная область действия)

424 486

425После завершения установки форма запрашивает любые [параметры конфигурации](/docs/ru/plugins/components#user-configuration) плагина, которые еще не установлены. Чтобы позже просмотреть или изменить параметры, нажмите значок шестеренки в строке плагина.487После завершения установки появляется форма, запрашивающая те [параметры конфигурации](/docs/ru/plugins/components#user-configuration) плагина, которые ещё не заданы. Чтобы просмотреть или изменить параметры позже, нажмите значок шестерёнки в строке плагина.

426 488

427Чувствительные текстовые поля скрыты, а сохраненный ранее секрет отображается как **(без изменений)**. Оставьте поле пустым, чтобы сохранить сохраненное значение.489Конфиденциальные текстовые поля маскируются, а для ранее сохранённого секрета отображается **(unchanged)**. Оставьте поле пустым, чтобы сохранить прежнее значение. После сохранения изменений открытые сессии перезагружают свои плагины, а в диалоговом окне отображается **Restart Claude to apply plugin changes**.

~~428~~

429После сохранения изменений открытые сеансы перезагружают свои плагины, и диалоговое окно показывает **Перезагрузите Claude, чтобы применить изменения плагинов**.

430 490

431<h3 id="uninstall-plugins">491<h3 id="uninstall-plugins">

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

433</h3>493</h3>

434 494

435Каждая установленная строка указывает [область](/docs/ru/plugins/install#choose-an-install-scope), в которой она установлена. Чтобы удалить эту установку, нажмите значок корзины в строке. Затемненный значок корзины отмечает строку, которую вы не можете удалить из этого рабочего пространства, например плагин, которым управляет ваша организация, или плагин, установленный для другого проекта.495В каждой строке установленного плагина указана [область действия](/docs/ru/plugins/install#choose-an-install-scope), на уровне которой он установлен. Чтобы удалить эту установку, нажмите значок корзины в строке. Затемнённый значок корзины отмечает строку, которую нельзя удалить из этой рабочей области, например плагин, управляемый вашей организацией, или плагин, установленный для другого проекта.

436 496

437Расширение спрашивает в двух случаях:497Расширение сначала задаёт вопрос в двух случаях:

438 498

439* **Плагин, который включен в файле `.claude/settings.json` вашего проекта**: выберите **Отключить для меня**, что сохраняет плагин установленным для ваших сотрудников, или **Удалить для всех**, что удаляет установку проекта с помощью [`--keep-data`](/docs/ru/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), поэтому сохраненный каталог данных плагина остается. Если вы уже отключили плагин для себя, значок корзины удаляет вашу собственную установку без вопроса.499* **Плагин, который включён в общем файле `.claude/settings.json` вашего проекта**: выберите **Disable for me**, чтобы плагин остался установленным для ваших коллег, или **Uninstall for everyone**, чтобы удалить установку проекта с флагом [`--keep-data`](/docs/ru/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), при этом каталог сохранённых данных плагина останется. Если вы уже отключили плагин для себя, значок корзины удаляет вашу собственную установку без вопроса.

440* **В противном случае, последняя установка плагина с сохраненными данными**: выберите, сохранить или удалить данные; **Сохранить** — это значение по умолчанию500* **В остальных случаях — последняя установка плагина с сохранёнными данными**: выберите, сохранить или удалить данные; по умолчанию выбрано **Keep**

441 501

442<h3 id="share-a-plugin-install-link">502<h3 id="share-a-plugin-install-link">

443 Поделиться ссылкой на установку плагина503 Отправка ссылки на установку плагина

444</h3>504</h3>

445 505

446Чтобы отправить кому-то прямую ссылку на установку конкретного плагина, дайте им URL `install-plugin` расширения. При открытии он запускает или фокусирует VS Code, открывает панель Claude Code и открывает диалоговое окно **Управление плагинами** с выбором области этого плагина. Ничего не устанавливается, пока пользователь не выберет область. Если маркетплейс плагина еще не настроен в Claude Code, диалоговое окно сначала попросит его добавить.506Чтобы сразу направить кого-либо к установке определённого плагина, отправьте ему URL расширения `install-plugin`. При открытии ссылки запускается или выводится на передний план VS Code, открывается панель Claude Code и диалоговое окно **Manage plugins** на выборе области действия для этого плагина. Ничего не устанавливается, пока человек не выберет область действия. Если маркетплейс плагина ещё не настроен в его Claude Code, диалоговое окно сначала предложит его добавить.

447 507

448```text theme={null}508```text theme={null}

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

453 513

454| Параметр | Описание |514| Параметр | Описание |

455| - | - |515| - | - |

457| `marketplace` | [Источник](/docs/ru/plugins/install#add-a-marketplace) маркетплейса: репозиторий GitHub `owner/repo`, URL `https://` или git SSH-адрес, например `git@github.com:owner/repo.git`. По умолчанию используется `anthropics/claude-plugins-official`, если не указано. |517| `marketplace` | [Источник](/docs/ru/plugins/install#add-a-marketplace) маркетплейса: `owner/repo` на GitHub, URL `https://` или SSH-адрес git, например `git@github.com:owner/repo.git`. Если не указан, по умолчанию используется `anthropics/claude-plugins-official`. |

458 518

459Расширение проверяет оба значения, прежде чем что-либо открыть:519Расширение проверяет оба значения, прежде чем что-либо открыть:

460 520

461* **Имя плагина**: не более 100 символов, начинается с буквы ASCII или цифры, а в остальном содержит только буквы ASCII, цифры, `.`, `_` и `-`.521* **Имя плагина**: не более 100 символов, начинается с ASCII-буквы или цифры и в остальном содержит только ASCII-буквы, цифры, `.`, `_` и `-`.

462* **Источник маркетплейса**: только формы, перечисленные для параметра `marketplace`, то есть не локальный путь, не адрес `http://` и не имя маркетплейса, например `claude-plugins-official`. URL `https://` не может содержать имя пользователя, пароль или строку запроса.522* **Источник маркетплейса**: только формы, перечисленные для параметра `marketplace`, то есть не локальный путь, не адрес `http://` и не имя маркетплейса, например `claude-plugins-official`. URL `https://` не может содержать имя пользователя, пароль или строку запроса.

463* **Git ref**: чтобы закрепить маркетплейс за веткой или тегом, добавьте ref к источнику после `%23` — закодированной формы `#`, например `marketplace=owner/repo%23v1.0`. Ссылка с незакодированным `#` не сработает. Маркетплейсы в организации GitHub `anthropics` нельзя закрепить в ссылке.523* **Git-ссылка (ref)**: чтобы закрепить маркетплейс за веткой или тегом, добавьте ref к источнику после `%23` — закодированной формы `#`, например `marketplace=owner/repo%23v1.0`. Ссылка с незакодированным `#` не сработает. Маркетплейсы в организации GitHub `anthropics` нельзя закрепить в ссылке.

464 524

465Пользователь, открывший ссылку, нарушающую эти правила, увидит ошибку, начинающуюся с `Invalid plugin installation URL`. Панель Claude Code и диалоговое окно не открываются, и ничего не устанавливается. Если имя вашего плагина или маркетплейс нельзя поместить в ссылку, попросите пользователей добавить маркетплейс на вкладке **Маркетплейсы**, а затем установить плагин с вкладки **Плагины**.525Тот, кто откроет ссылку, нарушающую эти правила, увидит ошибку, начинающуюся с `Invalid plugin installation URL`. Панель Claude Code и диалоговое окно не открываются, и ничего не устанавливается. Если имя вашего плагина или маркетплейс нельзя поместить в ссылку, попросите пользователей добавить маркетплейс на вкладке **Marketplaces**, а затем установить плагин на вкладке **Plugins**.

466 526

467Следующие случаи заканчиваются сообщением в диалоговом окне вместо выбора области действия:527В следующих случаях вместо выбора области действия в диалоговом окне отображается сообщение:

468 528

469* **Маркетплейс не содержит плагин с таким названием**: диалоговое окно сообщает, что плагин не найден. Проверьте значение `plugin` в списке маркетплейса.529* **В маркетплейсе нет плагина с таким именем**: диалоговое окно сообщает, что плагин не найден. Сверьте значение `plugin` со списком маркетплейса.

470* **Плагин уже установлен**: диалоговое окно это указывает, и ничего не меняется.530* **Плагин уже установлен**: диалоговое окно сообщает об этом, и ничего не меняется.

471* **Уже добавлен другой маркетплейс с таким же именем**: диалоговое окно сообщает, что маркетплейс из ссылки не был добавлен, и ничего не устанавливается.531* **Уже добавлен другой маркетплейс с тем же именем**: диалоговое окно сообщает, что маркетплейс из ссылки не был добавлен, и ничего не устанавливается.

472 532

473README на GitHub, проблемы и некоторые другие хосты Markdown удаляют ссылки, схема которых не `http` или `https`, поэтому ссылка `vscode://` там отображается как простой текст. Поместите URL в блок кода на этих хостах, как описано в разделе [Ссылка отображается как простой текст вместо того, чтобы быть кликабельной](/docs/ru/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) для ссылок `claude-cli://`.533README и issues на GitHub, а также некоторые другие платформы для markdown удаляют ссылки, схема которых не `http` или `https`, поэтому ссылка `vscode://` там отображается как обычный текст. На таких платформах помещайте URL в блок кода, как описано в разделе [Ссылка отображается как обычный текст, а не как кликабельная](/docs/ru/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) для ссылок `claude-cli://`.

474 534

475<h3 id="manage-marketplaces">535<h3 id="manage-marketplaces">

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

477</h3>537</h3>

478 538

479Перейдите на вкладку **Маркетплейсы**, чтобы добавить или удалить источники плагинов:539Перейдите на вкладку **Marketplaces**, чтобы добавить или удалить источники плагинов:

480 540

481* Введите репозиторий GitHub, URL или локальный путь для добавления нового маркетплейса541* Введите репозиторий GitHub, URL или локальный путь, чтобы добавить новый маркетплейс

482* Нажмите значок обновления, чтобы обновить список плагинов маркетплейса542* Нажмите значок обновления, чтобы обновить список плагинов маркетплейса

483* Нажмите значок корзины, чтобы удалить маркетплейс. Его удаление [удаляет все плагины, которые вы установили из него](/docs/ru/plugins/install#manage-marketplaces), поэтому подтверждение сначала называет эти плагины543* Нажмите значок корзины, чтобы удалить маркетплейс. Его удаление [удаляет все плагины, которые вы из него установили](/docs/ru/plugins/install#manage-marketplaces), поэтому сначала отображается подтверждение с перечнем этих плагинов

484 544

485Изменения плагинов, которые вы вносите в диалоговом окне, применяются сразу же к сеансам Claude Code, открытым в этом окне VS Code.545Изменения плагинов, внесённые в диалоговом окне, сразу применяются к сессиям Claude Code, открытым в этом окне VS Code.

486 546

487Если сеанс, из которого вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезагрузить Claude в этом сеансе.547Если сессия, из которой вы открыли диалоговое окно, не может перезагрузить свои плагины, диалоговое окно предлагает повторить попытку или перезапустить Claude в этой сессии.

488 548

489<Note>549<Note>

490 Управление плагинами в VS Code использует те же команды CLI под капотом. Плагины и маркетплейсы, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.550 Расширение управляет плагинами, выполняя те же команды, что и CLI. Плагины и маркетплейсы, настроенные в расширении, также доступны в CLI, и наоборот.

491</Note>551</Note>

492 552

493Дополнительную информацию о системе плагинов см. в разделах [Плагины](/docs/ru/plugins/overview) и [Маркетплейсы плагинов](/docs/ru/plugins/overview).553Подробнее о системе плагинов см. в разделах [Плагины](/docs/ru/plugins/overview) и [Маркетплейсы плагинов](/docs/ru/plugins/overview).

494 554

495<h3 id="plugins-that-draw-in-the-panel">555<h3 id="plugins-that-draw-in-the-panel">

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

497</h3>557</h3>

498 558

499Плагин, содержащий [мод](/docs/ru/plugins/mods/overview), может рисовать в панели чата. Для рисования требуется расширение версии 2.1.299 или новее и сессия, которая [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). От такого плагина вы можете увидеть:559Плагин, содержащий [мод](/docs/ru/plugins/mods/overview), может отображать содержимое в панели чата. Для этого требуется расширение версии 2.1.299 или новее и сессия, которая [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). От такого плагина вы можете увидеть:

500 560

501* Панель рядом с диалогом или над полем промпта561* Панель рядом с диалогом или над полем промпта

502* Всплывающее уведомление или строку состояния над полем промпта562* Всплывающее уведомление или строку состояния над полем промпта

503* Сообщение или вызов инструмента, отрисованные собственным способом плагина563* Сообщение или вызов инструмента, отображённые собственным способом плагина

504 564

505Когда установленный вами плагин добавляет или изменяет что-либо в панели, метка называет его, например такими фразами:565Когда установленный вами плагин добавляет или изменяет что-либо в панели, это обозначается меткой с формулировками, например такими:

506 566

507* **Из плагина token-chart**: плагин нарисовал или вывел это, либо эта карточка — это плагин, который что-то у вас спрашивает567* **From the token-chart plugin**: плагин отобразил или вывел это, либо эта карточка — вопрос плагина к вам

508* **Изменено плагином token-chart**: плагин изменил что-то, что рисует Claude Code, например вызов инструмента568* **Edited by the token-chart plugin**: плагин изменил что-то, что отображает Claude Code, например вызов инструмента

509* **Промпт от плагина token-chart**: плагин отправил это сообщение от вашего имени569* **Prompt from the token-chart plugin**: плагин отправил это сообщение от вашего имени

510 570

511Чтобы запретить плагину рисовать, отключите плагин в [диалоговом окне плагинов](#install-plugins).571Чтобы запретить плагину отображать содержимое, отключите плагин в [диалоговом окне плагинов](#install-plugins).

512 572

513<h2 id="automate-browser-tasks-with-chrome">573<h2 id="automate-browser-tasks-with-chrome">

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

515</h2>575</h2>

516 576

517Подключите Claude к вашему браузеру Chrome для тестирования веб-приложений, отладки с помощью логов консоли и автоматизации рабочих процессов браузера, не покидая VS Code. Это требует расширение [Claude in Chrome extension](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или выше.577Подключите Claude к браузеру Chrome, чтобы тестировать веб-приложения, выполнять отладку с помощью логов консоли и автоматизировать рабочие процессы в браузере, не покидая VS Code. Для этого требуется [расширение Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) версии 1.0.36 или новее.

518 578

519Введите `@browser` в поле промпта, а затем то, что вы хотите, чтобы Claude сделал:579Введите `@browser` в поле промпта, а затем опишите, что должен сделать Claude:

520 580

521```text wrap theme={null}581```text wrap theme={null}

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

523```583```

524 584

525Вы также можете открыть меню вложений, чтобы выбрать конкретные инструменты браузера, такие как открытие новой вкладки или чтение содержимого страницы.585Вы также можете открыть меню вложений, чтобы выбрать конкретные инструменты браузера, например открытие новой вкладки или чтение содержимого страницы.

586

587Claude открывает новые вкладки для задач в браузере и использует состояние входа вашего браузера, поэтому может получить доступ к любому сайту, на котором вы уже авторизованы.

526 588

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

528 590

529Чтобы каждая сессия подключалась к вашему браузеру при запуске без ввода `@browser`, см. раздел [Включение Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default). О том, когда Claude Code запрашивает у вас подтверждение перед действием в браузере, см. раздел [Запросы разрешений в сессиях VS Code](/docs/ru/chrome#permission-prompts-in-vs-code-sessions).591* [Включение Chrome по умолчанию](/docs/ru/chrome#enable-chrome-by-default): каждая сессия будет подключаться к вашему браузеру при запуске без ввода `@browser`

592* [Запросы разрешений в сессиях VS Code](/docs/ru/chrome#permission-prompts-in-vs-code-sessions): когда Claude Code спрашивает вас перед действием в браузере

593* [Использование Claude Code с Chrome](/docs/ru/chrome): инструкции по настройке, полный список возможностей и устранение неполадок

530 594

531Инструкции по настройке, полный список возможностей и устранение неполадок см. в разделе [Use Claude Code with Chrome](/docs/ru/chrome).595<h2 id="work-with-git">

596 Работа с git

597</h2>

598

599Claude Code интегрируется с git для помощи в рабочих процессах контроля версий прямо в VS Code. Попросите Claude совершить коммиты, создать pull request'ы или работать между ветками. Чтобы запустить Claude в изолированном worktree с собственными файлами и веткой, см. [Запуск параллельных сеансов с worktrees](/docs/ru/worktrees).

600

601<h3 id="create-commits-and-pull-requests">

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

603</h3>

604

605Claude может подготавливать изменения, писать сообщения коммитов и создавать pull request'ы на основе вашей работы:

606

607```text wrap theme={null}

608commit my changes with a descriptive message

609create a pr for this feature

610summarize the changes I've made to the auth module

611```

612

613При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

614

615<h2 id="run-work-in-the-background">

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

617</h2>

618

619Отправьте длительную команду или субагента в фоновый режим, а затем проверяйте их состояние из поля ввода промпта.

620

621<h3 id="move-a-running-command-or-subagent-to-the-background">

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

623</h3>

624

625Когда команда или [субагент](/docs/ru/sub-agents) заставляет Claude ждать дольше, чем вам хотелось бы, нажмите **Run in background** под соответствующим вызовом инструмента в диалоге. Требуется Claude Code v2.1.287 или новее.

626

627* **Когда появляется**: действие становится доступным, когда команда выполняется около двух секунд, или сразу после запуска субагента.

628* **После нажатия**: Claude перестаёт ждать и продолжает ход. Команда или субагент продолжают работать как [фоновая задача](/docs/ru/tools-reference#background-commands), которая уведомит Claude о завершении.

629

630Чтобы тем временем проверить состояние задачи или остановить её, введите `/tasks` в поле ввода промпта, чтобы открыть [карту агентов](#use-the-prompt-box). Субагент сохраняет своё место в дереве агентов, а команда отображается под агентами с [последним выводом на её карточке](#monitor-background-processes).

631

632<h3 id="monitor-background-processes">

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

634</h3>

635

636Введите `/tasks` в поле ввода промпта, чтобы открыть [карту агентов](#use-the-prompt-box), где перечислены фоновые задачи сессии, например dev-сервер, который Claude оставил работать как фоновую shell-команду. Нажмите на задачу, чтобы открыть её карточку, где её можно остановить. Требуется Claude Code v2.1.277 или новее.

637

638Для фоновой shell-команды или [монитора](/docs/ru/tools-reference#monitor-tool), который запускает команду, карточка также показывает последний вывод команды и обновляет его, пока команда выполняется.

532 639

533<h2 id="vs-code-commands-and-shortcuts">640<h2 id="vs-code-commands-and-shortcuts">

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

535</h2>642</h2>

536 643

537Откройте палитру команд (`Cmd+Shift+P` на Mac или `Ctrl+Shift+P` на Windows/Linux) и введите "Claude Code", чтобы увидеть все доступные команды VS Code для расширения Claude Code.644Чтобы открыть палитру команд, нажмите `Cmd+Shift+P` на Mac или `Ctrl+Shift+P` на Windows/Linux. Введите там «Claude Code», чтобы увидеть все доступные команды VS Code для расширения Claude Code.

538 645

539Некоторые сочетания клавиш зависят от того, какая панель находится в "фокусе" (получает ввод с клавиатуры). Когда ваш курсор находится в файле кода, редактор находится в фокусе. Когда ваш курсор находится в поле подсказки Claude, Claude находится в фокусе. Используйте `Cmd+Esc` / `Ctrl+Esc` для переключения между ними.646Некоторые сочетания клавиш зависят от того, какая панель находится «в фокусе» (получает ввод с клавиатуры). Когда курсор находится в файле с кодом, в фокусе редактор. Когда курсор находится в поле ввода промпта Claude, в фокусе Claude. Используйте `Cmd+Esc` / `Ctrl+Esc` для переключения между ними.

540 647

541<Note>648<Note>

542 Это команды VS Code для управления расширением. Не все встроенные команды Claude Code доступны в расширении. Подробнее см. в разделе [VS Code extension vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli).649 Это команды VS Code для управления расширением. Не все встроенные команды Claude Code доступны в расширении. Подробнее см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).

543</Note>650</Note>

544 651

546| - | - | - |653| - | - | - |

548| Focus last message | - | Переместить фокус клавиатуры на самое новое сообщение в разговоре или на ожидающий запрос разрешения, чтобы вы могли читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в [режиме терминала](#switch-to-terminal-mode). Требует Claude Code v2.1.268 или позже |655| Focus last message | - | Переместить фокус клавиатуры на самое новое сообщение в диалоге или на ожидающий запрос разрешения, чтобы читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в [режиме терминала](#switch-to-terminal-mode). Требуется Claude Code v2.1.268 или новее |

549| Open in Side Bar | - | Открыть Claude на боковой панели |656| Open in Side Bar | - | Открыть Claude на боковой панели |

550| Open in Terminal | - | Открыть Claude в режиме терминала |657| Open in Terminal | - | Открыть Claude в режиме терминала |

552| Open in New Window | - | Открыть новый разговор в отдельном окне |659| Open in New Window | - | Открыть новый диалог в отдельном окне |

553| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый разговор. Требует, чтобы Claude был в фокусе и `enableNewConversationShortcut` был установлен на `true` |660| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый диалог. Требуется, чтобы Claude был в фокусе, а `enableNewConversationShortcut` имел значение `true` |

554| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть самую недавно закрытую вкладку сеанса Claude. Переходит к обычному переоткрытию закрытого редактора VS Code, если последняя закрытая вкладка не была сеансом Claude. Отключить с помощью `enableReopenClosedSessionShortcut` |661| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть последнюю закрытую вкладку сессии Claude. Если последняя закрытая вкладка не была сессией Claude, выполняется стандартное повторное открытие закрытого редактора VS Code. Отключается с помощью `enableReopenClosedSessionShortcut` |

556| Accept Change at Cursor | - | Принять изменение в позиции курсора при [проверке предложенного редактирования](#get-started) одно изменение за раз. Требует Claude Code v2.1.275 или позже |663| Accept Change at Cursor | - | Принять изменение в позиции курсора при [просмотре предложенной правки](#get-started) по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

557| Reject Change at Cursor | - | Отменить изменение в позиции курсора при проверке предложенного редактирования одно изменение за раз. Требует Claude Code v2.1.275 или позже |664| Reject Change at Cursor | - | Отменить изменение в позиции курсора при просмотре предложенной правки по одному изменению за раз. Требуется Claude Code v2.1.275 или новее |

558| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в разговоре. Работает, когда видна панель Claude или боковая панель. Требует Claude Code v2.1.221 или позже |665| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в диалоге. Работает, когда видна панель или боковая панель Claude. Требуется Claude Code v2.1.221 или новее |

559| Rename Session Tab | - | Переименовать сеанс на активной вкладке Claude. Требует Claude Code v2.1.257 или позже |666| Rename Session Tab | - | Переименовать сессию в активной вкладке Claude. Требуется Claude Code v2.1.257 или новее |

560| Add Session Tab to Group | - | Добавить сеанс на активной вкладке Claude в [группу сеансов](#organize-sessions-into-groups), которую вы выберете или создадите. Требует Claude Code v2.1.257 или позже |667| Add Session Tab to Group | - | Добавить сессию из активной вкладки Claude в [группу сессий](#organize-sessions-into-groups), которую вы выберете или создадите. Требуется Claude Code v2.1.257 или новее |

561| Mark Session as Unread | - | Отметить сеанс на активной вкладке Claude как непрочитанный в списке сеансов. Требует Claude Code v2.1.257 или позже |668| Mark Session as Unread | - | Отметить сессию в активной вкладке Claude как непрочитанную в списке сессий. Требуется Claude Code v2.1.257 или новее |

562| Show Logs | - | Просмотр журналов отладки расширения |669| Show Logs | - | Просмотреть отладочные логи расширения |

563| Logout | - | Выйти из своей учетной записи Anthropic |670| Logout | - | Выйти из учётной записи Anthropic |

564 671

565<h3 id="launch-a-vs-code-tab-from-other-tools">672<h3 id="launch-a-vs-code-tab-from-other-tools">

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

567</h3>674</h3>

568 675

569Расширение регистрирует обработчик URI по адресу `vscode://anthropic.claude-code/open`. Используйте его для открытия новой вкладки Claude Code из вашего собственного инструмента: псевдонима оболочки, букмарклета браузера или любого скрипта, который может открыть URL. Если VS Code еще не запущен, открытие URL сначала запускает его. Если VS Code уже запущен, URL открывается в окне, которое в данный момент находится в фокусе.676Расширение регистрирует обработчик URI по адресу `vscode://anthropic.claude-code/open`. Используйте его, чтобы открыть новую вкладку Claude Code из собственных инструментов: псевдонима оболочки, букмарклета браузера или любого скрипта, который может открыть URL. Если VS Code ещё не запущен, открытие URL сначала запустит его. Если VS Code уже запущен, URL откроется в том окне, которое сейчас находится в фокусе.

570 677

571Вызовите обработчик с помощью открывателя URL вашей операционной системы.678Вызовите обработчик с помощью средства открытия URL вашей операционной системы.

572 679

573<Tabs>680<Tabs>

574 <Tab title="macOS">681 <Tab title="macOS">

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

583 ```690 ```

584 691

585 Команда `xdg-open` поступает из пакета `xdg-utils`. Если оболочка сообщает, что она не найдена, см. [xdg-open is not found on Linux](/docs/ru/deep-links#xdg-open-is-not-found-on-linux).692 Команда `xdg-open` входит в пакет `xdg-utils`. Если оболочка сообщает, что команда не найдена, см. раздел [xdg-open не найден в Linux](/docs/ru/deep-links#xdg-open-is-not-found-on-linux).

586 </Tab>693 </Tab>

587 694

588 <Tab title="Windows">695 <Tab title="Windows">

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

593 ```700 ```

594 701

595 В `cmd.exe`, `start` рассматривает свой первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:702 В `cmd.exe` команда `start` воспринимает первый аргумент в кавычках как заголовок окна, поэтому передайте пустой заголовок перед URL:

596 703

597 ```cmd theme={null}704 ```cmd theme={null}

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

604 711

605| Параметр | Описание |712| Параметр | Описание |

606| - | - |713| - | - |

607| `prompt` | Текст для предварительного заполнения в поле подсказки. Должен быть закодирован в URL. Подсказка предварительно заполняется, но не отправляется автоматически. |714| `prompt` | Текст для предварительного заполнения поля ввода промпта. Должен быть закодирован для URL. Промпт подставляется, но не отправляется автоматически. |

608| `session` | Идентификатор сеанса для возобновления вместо начала нового разговора. Сеанс должен принадлежать рабочей области, которая в данный момент открыта в VS Code. Если сеанс не найден, вместо этого начинается новый разговор. Если сеанс уже открыт на вкладке, эта вкладка получает фокус. Чтобы программно захватить идентификатор сеанса, см. [Continue conversations](/docs/ru/headless#continue-conversations). |715| `session` | ID сессии, которую нужно возобновить вместо начала нового диалога. Сессия должна принадлежать рабочей области, открытой в данный момент в VS Code. Если сессия не найдена, вместо неё начинается новый диалог. Если сессия уже открыта во вкладке, фокус переходит на эту вкладку. Чтобы получить ID сессии программно, см. раздел [Продолжение диалогов](/docs/ru/headless#continue-conversations). |

609 716

610Например, чтобы открыть вкладку с предварительным заполнением "review my changes":717Например, чтобы открыть вкладку с предварительно заполненным текстом «review my changes»:

611 718

612```text theme={null}719```text theme={null}

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

614```721```

615 722

616Расширение также обрабатывает `vscode://anthropic.claude-code/install-plugin`, который [открывает диалог плагина на одном плагине](#share-a-plugin-install-link). Чтобы запустить сеанс терминала вместо вкладки VS Code, используйте обработчик `claude-cli://` CLI. См. [Launch sessions from links](/docs/ru/deep-links).723Расширение также обрабатывает `vscode://anthropic.claude-code/install-plugin`, который [открывает диалоговое окно плагинов для одного плагина](#share-a-plugin-install-link). Чтобы запустить сессию в терминале вместо вкладки VS Code, используйте обработчик `claude-cli://` из CLI. См. раздел [Запуск сессий по ссылкам](/docs/ru/deep-links).

617 724

618<h2 id="configure-settings">725<h2 id="configure-settings">

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

620</h2>727</h2>

621 728

622Расширение имеет два типа параметров:729Расширение настраивается в двух местах: в настройках расширения VS Code и в файле настроек Claude Code:

623 730

624* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General config…** для открытия параметров.731* **Настройки расширения** в VS Code: управляют поведением расширения внутри VS Code. Откройте их с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в **Extensions > Claude Code**. Также можно ввести `/` и выбрать **General config…**, чтобы открыть настройки.

625* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP серверов. С Claude Code v2.1.283 или позже это также один из входных параметров режима разрешений, с которого начинаются беседы, а в более ранних версиях только на планах Pro, Max и Team. [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes) указывает порядок. Подробнее см. [Settings](/docs/ru/settings).732* **Настройки Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте их для разрешённых команд, переменных окружения, хуков и MCP-серверов. В Claude Code v2.1.283 и более поздних версиях они также являются одним из факторов, определяющих режим разрешений, в котором начинаются диалоги, а в более ранних версиях — только в планах Pro, Max и Team. Порядок приведён в разделе [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes). Подробнее см. в разделе [Настройки](/docs/ru/settings).

626 733

627<Tip>734<Tip>

628 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров прямо в VS Code.735 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную валидацию всех доступных настроек прямо в VS Code.

629</Tip>736</Tip>

630 737

631<h3 id="extension-settings">738<h3 id="extension-settings">

632 Параметры расширения739 Настройки расширения

633</h3>740</h3>

634 741

635VS Code читает `initialPermissionMode` из ваших пользовательских параметров и игнорирует значения рабочей области. До версии 2.1.225 VS Code по умолчанию устанавливал параметр на `default` и применял значения рабочей области.742VS Code считывает `initialPermissionMode` из ваших пользовательских настроек и игнорирует значения рабочей области. До v2.1.225 VS Code по умолчанию устанавливал для этой настройки значение `default` и применял значения рабочей области.

636 743

638| - | - | - |745| - | - | - |

640| `initialPermissionMode` | - | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` является псевдонимом для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Если оставить его неустановленным, расширение выбирает начальный режим разрешений, как описано в [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes). |747| `initialPermissionMode` | - | Управляет запросами подтверждения для новых диалогов: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` — псевдоним для `default`, он выбирает режим с меткой **Manual** в индикаторе режима. Если настройка не задана, расширение выбирает начальный режим разрешений так, как описано в разделе [Переключение режимов разрешений](/docs/ru/permission-modes#switch-permission-modes). |

642| `lockEditorGroups` | `true` | [Заблокировать группы редактора, которые Claude запускает для своих вкладок](#choose-where-claude-lives), чтобы файлы, которые вы открываете, когда вкладка Claude сфокусирована, переходили в другую группу. Когда отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или позже |749| `lockEditorGroups` | `true` | [Блокировать группы редактора, которые Claude создаёт для своих вкладок](#choose-where-claude-lives), чтобы файлы, открываемые, когда в фокусе вкладка Claude, попадали в другую группу. Если отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или более поздней версии |

644| `attachOpenFile` | `true` | Добавить файл, открытый в редакторе, к вашим сообщениям и показать его в поле подсказки. Когда отключено, добавляется только выбранный текст. Требуется Claude Code v2.1.271 или позже |751| `attachOpenFile` | `true` | Добавлять файл, открытый в редакторе, к вашим сообщениям и показывать его в поле ввода промпта. Если отключено, добавляется только выделенный текст. Требуется Claude Code v2.1.271 или более поздней версии |

646| `scrollToBottomOnSend` | `true` | Прокручивать беседу в конец при отправке сообщения. Когда отключено, беседа остаётся там, где вы её оставили. Требуется Claude Code v2.1.275 или позже |753| `scrollToBottomOnSend` | `true` | Прокручивать диалог вниз при отправке сообщения. Если отключено, диалог остаётся там, где вы его оставили. Требуется Claude Code v2.1.275 или более поздней версии |

647| `showMessageTimestamps` | `true` | Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место смены дня. Требуется Claude Code v2.1.284 или позже. До версии 2.1.290 значением по умолчанию было `false` |754| `showMessageTimestamps` | `true` | Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место, где меняется день. Требуется Claude Code v2.1.284 или более поздней версии. До v2.1.290 значение по умолчанию было `false` |

648| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Задать глаголы, которые поочерёдно показывает индикатор выполнения в диалоге во время хода, с теми же полями `mode` и `verbs`, что и у параметра CLI [`spinnerVerbs`](/docs/ru/settings-reference#spinnerverbs). |755| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Задаёт глаголы, которые поочерёдно отображает индикатор выполнения диалога во время хода, с теми же полями `mode` и `verbs`, что и в настройке CLI [`spinnerVerbs`](/docs/ru/settings-reference#spinnerverbs). |

650| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия самой недавно закрытой вкладки сеанса Claude. Когда последняя закрытая вкладка не была сеансом Claude, сочетание клавиш запускает обычную команду VS Code для повторного открытия закрытого редактора. |757| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия последней закрытой вкладки сессии Claude. Если последняя закрытая вкладка не была сессией Claude, сочетание клавиш выполняет обычную команду VS Code для повторного открытия закрытого редактора. |

651| `archiveInactiveSessions` | `14` | [Архивировать сеанс автоматически](#resume-past-conversations) после этого количества дней без активности: `1`, `2`, `7` или `14`. Установите `0` для отключения. Требуется Claude Code v2.1.265 или позже |758| `archiveInactiveSessions` | `14` | [Автоматически архивировать сессию](#resume-past-conversations) после указанного количества дней без активности: `1`, `2`, `7` или `14`. Установите `0`, чтобы отключить. Требуется Claude Code v2.1.265 или более поздней версии |

652| `continueAfterReload` | `true` | После перезагрузки окна Claude [продолжает шаг, который был прерван](#continue-conversations-after-a-reload), в восстановленной сессии. Требуется Claude Code v2.1.274 или позже |759| `continueAfterReload` | `true` | После перезагрузки окна Claude [продолжает прерванный шаг](#continue-conversations-after-a-reload) в восстановленной сессии. Требуется Claude Code v2.1.274 или более поздней версии |

654| `focusView` | `false` | Скрыть вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Последний список дел Claude остаётся видимым; это требует Claude Code v2.1.225 или позже. Вы также можете переключить Focus view из меню команд. Требуется Claude Code v2.1.221 или позже |761| `focusView` | `false` | Скрывать вызовы инструментов, результаты инструментов и размышления за раскрываемыми строками, оставляя ваши промпты и ответы Claude. Последний список задач Claude остаётся видимым; для этого требуется Claude Code v2.1.225 или более поздней версии. Режим Focus view также можно переключать из меню команд. Требуется Claude Code v2.1.221 или более поздней версии |

657| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. Запись [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) применяется только в том случае, если её значение является абсолютным путём; расширение не раскрывает `~` и игнорирует относительное значение. |764| `environmentVariables` | `[]` | Задать переменные окружения для процесса Claude. Для общей конфигурации используйте вместо этого настройки Claude Code. Запись [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) применяется только в том случае, если её значение — абсолютный путь; расширение не раскрывает `~` и игнорирует относительное значение. |

660| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. |767| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному бинарному файлу передаётся как аргумент, если он присутствует. Укажите здесь отдельно установленный бинарный файл `claude`, если сборка расширения не содержит его для вашей платформы. |

768

769<h2 id="use-third-party-providers">

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

771</h2>

772

773По умолчанию Claude Code подключается напрямую к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего провайдера:

774

775<Steps>

776 <Step title="Отключите промпт входа">

777 Откройте [настройку Disable Login Prompt](vscode://settings/claudeCode.disableLoginPrompt) и установите флажок.

778

779 Вы также можете нажать `Cmd+,` на Mac или `Ctrl+,` на Windows/Linux, чтобы открыть настройки VS Code, выполнить поиск по запросу "Claude Code login" и установить флажок **Disable Login Prompt**.

780 </Step>

781

782 <Step title="Настройте провайдера">

783 Следуйте руководству по настройке для вашего провайдера:

784

785 * [Claude Code в Amazon Bedrock](/docs/ru/amazon-bedrock)

786 * [Claude Code в Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

787 * [Claude Code в Microsoft Foundry](/docs/ru/microsoft-foundry)

788

789 В этих руководствах описана настройка провайдера в `~/.claude/settings.json`, что гарантирует общие настройки для расширения VS Code и CLI.

790 </Step>

791</Steps>

792

793При использовании стороннего провайдера расширение не предоставляет функции, для которых требуется учётная запись claude.ai, например шкалы использования плана, [голосовую диктовку](/docs/ru/voice-dictation) и вкладку Web для [облачных сессий](#resume-cloud-sessions-from-claude-ai). О том, что показывает диалог Account & usage при таких способах входа, см. раздел [Проверка учётной записи и использования](#check-account-and-usage).

794

795Вход в claude.ai, оставшийся от предыдущего выполнения `/login`, не используется: расширение не отправляет его ни с одним запросом.

661 796

662<h2 id="use-a-screen-reader">797<h2 id="use-a-screen-reader">

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

664</h2>799</h2>

665 800

666Панель чата расширения работает с программами чтения с экрана. Вам не нужно ничего включать: расширение объявляет активность разговора для каждого пользователя без визуальных изменений. Это отличается от режима программы чтения с экрана CLI с явным согласием пользователя [screen reader mode](/docs/ru/accessibility), который адаптирует интерфейс терминала.801Панель чата расширения работает с программами чтения с экрана. Вам не нужно ничего включать: расширение озвучивает активность в диалоге для всех пользователей, без каких-либо визуальных изменений. Это не связано с [режимом чтения с экрана](/docs/ru/accessibility) в CLI, который включается вручную и адаптирует интерфейс терминала.

667 802

668Поддержка программы чтения с экрана в панели чата требует Claude Code версии 2.1.236 или более поздней.803Поддержка программ чтения с экрана в панели чата требует Claude Code v2.1.236 или новее.

669 804

670Во время разговора расширение объявляет:805Во время диалога расширение озвучивает:

671 806

672* **Ответы Claude**: расширение объявляет каждый ответ один раз, когда он завершен, и молчит во время потоковой передачи текста. Ваша программа чтения с экрана читает блоки кода как сводку по количеству строк, читает ссылки по их метке и читает таблицы ячейка за ячейкой; полный ответ остается читаемым в стенограмме.807* **Ответы Claude**: расширение озвучивает каждый ответ один раз, когда он завершён, и молчит, пока текст поступает потоком. Программа чтения с экрана зачитывает блоки кода в виде сводки с количеством строк, ссылки — по их подписи, а таблицы — ячейка за ячейкой; полный ответ остаётся доступным для чтения в транскрипте.

673* **Запросы разрешений и вопросы**: расширение объявляет запрос, когда появляется его диалоговое окно разрешения, называя инструмент, который Claude хочет использовать. Оно объявляет таким же образом, когда Claude задает вам вопрос и когда Claude завершает план и ждет вашего рассмотрения.808* **Запросы разрешений и вопросы**: расширение озвучивает запрос, когда появляется запрос разрешения, называя инструмент, который Claude хочет использовать. Аналогичным образом оно сообщает, когда Claude задаёт вам вопрос и когда Claude завершает план и ждёт вашей проверки.

674* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.809* **Изменения статуса**: расширение сообщает, когда Claude начинает работу, когда Claude готов к вашему вводу и когда Claude Code начинает сжатие диалога.

675* **Сообщения в очереди**: когда вы отправляете сообщение, пока Claude работает, расширение объявляет "Message queued." для этого сообщения.810* **Сообщения в очереди**: когда вы отправляете сообщение, пока Claude работает, расширение озвучивает для этого сообщения «Message queued.».

676* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).811* **Ошибки и запросы, связанные с моделью**: расширение озвучивает ошибки в диалоге, а также сообщает о появлении [запроса согласия на использование кредитов использования](/docs/ru/model-config#fable-and-usage-credits) или [запроса для помеченного запроса](/docs/ru/model-config#ask-before-switching).

677 812

678Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.813Пока Claude работает, программа чтения с экрана зачитывает текстовую метку вместо анимации индикатора выполнения.

679 814

680Когда вы повторно открываете сеанс или переключаетесь на другой, расширение ничего не объявляет: восстановленная история, ожидающие запросы разрешений и текущий статус остаются молчаливыми до тех пор, пока не произойдет что-то новое.815Когда вы повторно открываете сессию или переключаетесь на другую, расширение ничего не озвучивает: восстановленная история, ожидающие запросы разрешений и статус выполнения остаются без озвучивания, пока не произойдёт что-то новое.

681 816

682<h3 id="use-the-chat-panel-from-the-keyboard">817<h3 id="use-the-chat-panel-from-the-keyboard">

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

684</h3>819</h3>

685 820

686Каждый ход в стенограмме начинается с визуально скрытого заголовка, помеченного подсказкой, которая начала ход, поэтому вы можете переходить между ходами с помощью навигации по заголовкам вашей программы чтения с экрана.821Каждый ход в транскрипте начинается с визуально скрытого заголовка, подписанного промптом, с которого начался этот ход. Используйте навигацию по заголовкам в вашей программе чтения с экрана, чтобы переходить между ходами.

687 822

688В пределах хода ваша программа чтения с экрана объявляет, чье сообщение вы читаете, когда вы перемещаетесь по нему:823Внутри хода программа чтения с экрана по мере перемещения сообщает, чьё сообщение перед вами:

689 824

690* **Ваши сообщения**: "Вы"825* **Ваши сообщения**: «You»

691* **Сообщения Claude**: "Claude"826* **Сообщения Claude**: «Claude»

692* **Шаги инструмента**: "Claude" плюс имя инструмента, например "Claude, Bash"827* **Шаги инструментов**: «Claude» плюс название инструмента, например «Claude, Bash»

693* **Блоки размышления**: "Claude, thinking"828* **Блоки размышлений**: «Claude, thinking»

694 829

695Поскольку расширение предоставляет стенограмму как помеченный регион, вы также можете переместить фокус на саму стенограмму с помощью `Tab` и читать ее в своем собственном темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, запустите **Claude Code: Focus last message** из [Command Palette](#vs-code-commands-and-shortcuts).830Поскольку расширение представляет транскрипт как помеченную область, вы также можете переместить фокус на сам транскрипт с помощью `Tab` и читать его в удобном вам темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, выполните **Claude Code: Focus last message** из [палитры команд](#vs-code-commands-and-shortcuts).

696 831

697Когда опция в диалоговом окне разрешения сохраняет правило разрешения или доступ к каталогу, ее метка заканчивается названием места сохранения одобрения, например "все проекты" или "этот сеанс". Когда опция сфокусирована, нажмите клавишу `Left` или `Right` для изменения назначения, и расширение объявляет каждое назначение по мере того, как вы на него переходите. Вы также можете щелкнуть на назначение в метке. Клавиши со стрелками требуют Claude Code версии 2.1.268 или более поздней.832Когда вариант в запросе разрешения сохраняет правило разрешений или доступ к каталогу, его подпись заканчивается указанием места сохранения подтверждения, например «all projects» или «this session». Чтобы изменить место сохранения:

833

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

835* Щёлкните место сохранения в подписи.

698 836

699<h2 id="vs-code-extension-vs-claude-code-cli">837<h2 id="vs-code-extension-vs-claude-code-cli">

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

701</h2>839</h2>

702 840

703Claude Code доступен как расширение VS Code (графическая панель), так и как CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, запустите `claude` во встроенном терминале VS Code. Это требует [автономной установки CLI](/docs/ru/setup): расширение не добавляет `claude` в ваш PATH. См. [Запуск CLI в VS Code](#run-cli-in-vs-code).841Claude Code доступен как в виде расширения VS Code (графическая панель), так и в виде CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, запустите `claude` во встроенном терминале VS Code. Для этого требуется [автономная установка CLI](/docs/ru/setup): расширение не добавляет `claude` в ваш PATH. См. раздел [Запуск CLI в VS Code](#run-cli-in-vs-code).

704 842

705| Функция | CLI | Расширение VS Code |843| Функция | CLI | Расширение VS Code |

706| - | - | - |844| - | - | - |

708| Конфигурация MCP server | Да | Да ([добавление и управление серверами](#connect-to-external-tools-with-mcp) с помощью `/mcp` на панели чата) |846| Настройка MCP-серверов | Да | Да: [добавляйте серверы и управляйте ими](#connect-to-external-tools-with-mcp) с помощью `/mcp` в панели чата |

709| Checkpoints | Да | Да |847| Чекпоинты | Да | Да |

710| Сочетание клавиш `!` Bash | Да | Нет |848| Ярлык `!` для Bash | Да | Нет |

711| Автодополнение Tab | Да | Нет |849| Автодополнение по Tab | Да | Нет |

~~712~~

713<h3 id="rewind-with-checkpoints">

714 Rewind с checkpoints

715</h3>

~~716~~

717Расширение VS Code поддерживает checkpoints, которые отслеживают редактирование файлов Claude и позволяют вернуться к предыдущему состоянию. Наведите указатель мыши на любое сообщение, чтобы открыть кнопку rewind, затем выберите один из трёх вариантов:

~~718~~

719* **Fork conversation from here**: начните новую ветку разговора с этого сообщения, сохраняя все изменения кода

720* **Rewind code to here**: отмените изменения файлов до этой точки в разговоре, сохраняя полную историю разговора

721* **Fork conversation and rewind code**: начните новую ветку разговора и отмените изменения файлов до этой точки

~~722~~

723Полные сведения о том, как работают checkpoints и их ограничения, см. в разделе [Checkpointing](/docs/ru/checkpointing).

724 850

725<h3 id="run-cli-in-vs-code">851<h3 id="run-cli-in-vs-code">

726 Запуск CLI в VS Code852 Запуск CLI в VS Code

727</h3>853</h3>

728 854

729Чтобы использовать CLI, оставаясь в VS Code, откройте встроенный терминал (`` Ctrl+` `` на Windows/Linux или `` Cmd+` `` на Mac) и запустите `claude`. CLI автоматически интегрируется с вашей IDE для функций, таких как просмотр diff и обмен диагностикой.855Чтобы использовать CLI, не выходя из VS Code, нажмите `` Ctrl+` `` в Windows/Linux или `` Cmd+` `` на Mac, чтобы открыть встроенный терминал, а затем выполните `claude`. CLI автоматически интегрируется с вашей IDE для таких функций, как просмотр diff и передача диагностики. Если вы используете внешний терминал, выполните `/ide` внутри Claude Code, чтобы подключить его к VS Code.

~~730~~

731Установка расширения не добавляет `claude` в PATH вашей оболочки. Расширение включает приватную копию CLI для своей панели чата, но ввод `claude` в терминал требует [автономной установки CLI](/docs/ru/setup). Запустите установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если `claude` всё ещё не найден после установки, [проверьте ваш PATH](/docs/ru/troubleshoot-install#verify-your-path).

732 856

733Если вы используете внешний терминал, запустите `/ide` внутри Claude Code, чтобы подключить его к VS Code.857Установка расширения не добавляет `claude` в PATH вашей оболочки. Расширение содержит собственную копию CLI для своей панели чата, но для ввода `claude` в терминале требуется [автономная установка CLI](/docs/ru/setup). Выполните установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если после установки `claude` по-прежнему не найден, [проверьте ваш PATH](/docs/ru/troubleshoot-install#verify-your-path).

734 858

735<h3 id="switch-between-extension-and-cli">859<h3 id="switch-between-extension-and-cli">

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

737</h3>861</h3>

738 862

739Расширение и CLI используют одну и ту же историю разговоров. Чтобы продолжить разговор расширения в CLI, запустите `claude --resume` в терминале. Это откроет интерактивный выбор, где вы можете найти и выбрать ваш разговор.863Расширение и CLI используют общую историю диалогов. Чтобы продолжить диалог из расширения в CLI, выполните `claude --resume` в терминале. Откроется интерактивное окно выбора, в котором вы можете найти и выбрать нужный диалог.

740 864

741<h3 id="include-terminal-output-in-prompts">865<h2 id="connect-to-external-tools-with-mcp">

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

743</h3>867</h2>

~~744~~

745Ссылайтесь на вывод терминала в ваших подсказках, используя `@terminal:name`, где `name` — это название терминала. Это позволяет Claude видеть вывод команды, сообщения об ошибках или логи без копирования и вставки.

~~746~~

747<h3 id="move-a-running-command-or-subagent-to-the-background">

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

749</h3>

~~750~~

751Когда Claude ожидает команду или [субагента](/docs/ru/sub-agents), которые выполняются дольше, чем вам хотелось бы, нажмите **Run in background** под соответствующим вызовом инструмента в диалоге. Это действие появляется, когда команда выполняется около двух секунд, или сразу после запуска субагента. Claude перестаёт ждать и продолжает ход, а команда или субагент продолжают работать как [фоновая задача](/docs/ru/tools-reference#background-commands), которая уведомляет Claude о своём завершении. Требуется Claude Code v2.1.287 или более поздняя версия.

~~752~~

753Чтобы тем временем проверить задачу или остановить её, введите `/tasks` в поле промпта, чтобы открыть [карту агентов](#use-the-prompt-box). Субагент сохраняет там своё место в дереве агентов, а команда отображается под агентами с [последним выводом на её карточке](#monitor-background-processes).

~~754~~

755<h3 id="monitor-background-processes">

756 Мониторинг фоновых процессов

757</h3>

~~758~~

759Введите `/tasks` в поле промпта, чтобы открыть [карту агентов](#use-the-prompt-box), которая отображает фоновые задачи сессии, такие как сервер разработки, который Claude оставил запущенным в качестве фоновой shell-команды. Нажмите на задачу, чтобы открыть её карточку и остановить её там. Требуется Claude Code v2.1.277 или более поздняя версия.

760 868

761Для фоновой shell-команды или [монитора](/docs/ru/tools-reference#monitor-tool), который запускает команду, карточка также показывает последний вывод команды и обновляет его, пока команда выполняется.869MCP-серверы (Model Context Protocol) предоставляют Claude доступ к внешним инструментам, базам данных и API.

762 870

763<h3 id="connect-to-external-tools-with-mcp">871Чтобы управлять MCP-серверами, не выходя из VS Code, введите `/mcp` на панели чата. В открывшемся диалоговом окне вы можете:

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

765</h3>

766 872

767MCP (Model Context Protocol) серверы дают Claude доступ к внешним инструментам, базам данных и API.873* Добавлять серверы

874* Удалять серверы, сохранённые в локальной, пользовательской или проектной [области действия](/docs/ru/mcp#mcp-installation-scopes)

875* Включать или отключать серверы

876* Переподключаться к серверу

877* Управлять аутентификацией OAuth

768 878

769Чтобы управлять MCP серверами, не покидая VS Code, введите `/mcp` на панели чата. В открывшемся диалоговом окне вы можете добавлять серверы, удалять серверы, сохранённые в локальной, пользовательской или проектной [области](/docs/ru/mcp#mcp-installation-scopes), включать или отключать серверы, переподключаться к серверу и управлять аутентификацией OAuth. Добавление и удаление серверов в диалоговом окне требует Claude Code v2.1.261 или более поздней версии.879Для добавления и удаления серверов в диалоговом окне требуется Claude Code v2.1.261 или более поздней версии.

770 880

771Вы также можете запустить `claude mcp add` во встроенном терминале VS Code (`` Ctrl+` `` или `` Cmd+` ``). Диалоговое окно и команда терминала сохраняют в одну и ту же конфигурацию MCP, и изменения из любого источника вступают в силу в разговорах, которые вы начинаете впоследствии. Пример ниже добавляет удалённый MCP сервер GitHub, который аутентифицируется с помощью [личного токена доступа](https://github.com/settings/personal-access-tokens), переданного в качестве заголовка:881Вы также можете выполнить `claude mcp add` во встроенном терминале VS Code (`` Ctrl+` `` или `` Cmd+` ``). Диалоговое окно и команда терминала сохраняют данные в одну и ту же конфигурацию MCP, и изменения, внесённые любым из способов, вступают в силу в диалогах, которые вы начнёте после этого. В примере ниже добавляется удалённый MCP-сервер GitHub, который выполняет аутентификацию с помощью [персонального токена доступа](https://github.com/settings/personal-access-tokens), передаваемого в заголовке:

772 882

773```bash theme={null}883```bash theme={null}

774claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \884claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \

775 --header "Authorization: Bearer YOUR_GITHUB_PAT"885 --header "Authorization: Bearer YOUR_GITHUB_PAT"

776```886```

777 887

778Замените `YOUR_GITHUB_PAT` на ваш личный токен доступа. Команда `claude mcp add` сохраняет конфигурацию без проверки учётных данных, поэтому здесь принимается значение-заполнитель, но сервер не подключится позже. Чтобы проверить соединение, начните новый разговор, введите `/mcp` и проверьте, что сервер показывает **Connected**. Сервер с неправильными учётными данными показывает **Failed**.888Замените `YOUR_GITHUB_PAT` своим персональным токеном доступа. Команда `claude mcp add` сохраняет конфигурацию без проверки учётных данных, поэтому значение-заполнитель здесь будет принято, но позже сервер не сможет подключиться. Чтобы проверить подключение, начните новый диалог, введите `/mcp` и убедитесь, что у сервера отображается статус **Connected**. Для сервера с неверными учётными данными отображается **Failed**.

~~779~~

780После настройки попросите Claude использовать инструменты (например, "Review PR #456").

~~781~~

782Чтобы найти серверы для подключения, см. [Find and build MCP servers](/docs/ru/mcp#find-and-build-mcp-servers).

~~783~~

784<h2 id="work-with-git">

785 Работа с git

786</h2>

~~787~~

788Claude Code интегрируется с git для помощи в рабочих процессах контроля версий прямо в VS Code. Попросите Claude совершить коммиты, создать pull request'ы или работать между ветками. Чтобы запустить Claude в изолированном worktree с собственными файлами и веткой, см. [Запуск параллельных сеансов с worktrees](/docs/ru/worktrees).

~~789~~

790<h3 id="create-commits-and-pull-requests">

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

792</h3>

~~793~~

794Claude может подготавливать изменения, писать сообщения коммитов и создавать pull request'ы на основе вашей работы:

~~795~~

796```text wrap theme={null}

797commit my changes with a descriptive message

798create a pr for this feature

799summarize the changes I've made to the auth module

800```

~~801~~

802При создании pull request'ов Claude генерирует описания на основе фактических изменений кода и может добавлять контекст о тестировании или решениях по реализации.

803 889

804<h2 id="use-third-party-providers">890После настройки попросите Claude использовать инструменты (например, «Review PR #456»).

805 Использование сторонних поставщиков

806</h2>

807 891

808По умолчанию Claude Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего поставщика:892<Note>Чтобы найти серверы для подключения, см. раздел [Поиск и создание MCP-серверов](/docs/ru/mcp#find-and-build-mcp-servers).</Note>

~~809~~

810<Steps>

811 <Step title="Отключение запроса входа">

812 Откройте [параметр Disable Login Prompt](vscode://settings/claudeCode.disableLoginPrompt) и установите флажок.

813 893

814 Вы также можете открыть параметры VS Code (`Cmd+,` на Mac или `Ctrl+,` на Windows/Linux), найти "Claude Code login" и установить флажок **Disable Login Prompt**.894<h2 id="the-built-in-ide-mcp-server">

815 </Step>

~~816~~

817 <Step title="Настройка вашего поставщика">

818 Следуйте руководству по настройке для вашего поставщика:

~~819~~

820 * [Claude Code на Amazon Bedrock](/docs/ru/amazon-bedrock)

821 * [Claude Code на Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

822 * [Claude Code на Microsoft Foundry](/docs/ru/microsoft-foundry)

~~823~~

824 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.

825 </Step>

826</Steps>

~~827~~

828На сторонних поставщиках расширение не предлагает функции, требующие учетной записи claude.ai, такие как отслеживание использования, [голосовой ввод](/docs/ru/voice-dictation) и вкладка Web для [облачных сеансов](#resume-cloud-sessions-from-claude-ai). Для информации о том, что показывает диалог Account & usage при этих входах, см. [Проверка учетной записи и использования](#check-account-and-usage).

~~829~~

830Вход в claude.ai, оставшийся с более ранней версии `/login`, остается неиспользованным: расширение не отправляет его ни с одним запросом.

~~831~~

832<h2 id="security-and-privacy">

833 Безопасность и конфиденциальность

834</h2>

~~835~~

836Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробнее о обработке данных и способах отказа от логирования см. [Data and privacy](/docs/ru/data-usage).

~~837~~

838Когда включены разрешения на автоматическое редактирование, Claude Code может изменять файлы конфигурации VS Code (такие как `settings.json` или `tasks.json`), которые VS Code может выполнять автоматически. Чтобы снизить риск при работе с ненадёжным кодом:

~~839~~

840* Включите [VS Code Restricted Mode](https://code.visualstudio.com/docs/editor/workspace-trust#_restricted-mode) для ненадёжных рабочих областей

841* Используйте Manual mode вместо Edit automatically или Auto для редактирования

842* Внимательно проверяйте изменения перед их принятием

~~843~~

844<h3 id="the-built-in-ide-mcp-server">

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

846</h3>896</h2>

847 897

848Когда расширение активно, оно запускает локальный MCP-сервер, к которому CLI подключается автоматически. Именно так CLI открывает diff во встроенном средстве просмотра различий VS Code, читает ваше текущее выделение для упоминаний `@` и — когда вы работаете в записной книжке Jupyter — просит VS Code выполнить ячейки.898Когда расширение активно, оно запускает локальный MCP-сервер, к которому CLI подключается автоматически. Через этот сервер CLI:

849 899

850Сервер называется `ide` и скрыт от `/mcp`, потому что в нём нечего настраивать. Однако если ваша организация использует хук `PreToolUse` для создания списка разрешённых MCP-инструментов, вам нужно знать, что он существует.900* Открывает diff во встроенном средстве просмотра diff в VS Code

901* Считывает ваше текущее выделение для `@`-упоминаний

902* Просит VS Code выполнить ячейки, когда вы работаете в блокноте Jupyter

851 903

852**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста в каждый отправляемый вами промпт. Когда это происходит, в транскрипте отображается строка `⧉ Selected N lines from <file>`.904Сервер называется `ide` и скрыт из `/mcp`, поскольку в нём нечего настраивать. Однако если ваша организация использует хук `PreToolUse` для ведения списка разрешённых инструментов MCP, вам нужно знать о его существовании.

853 905

854Если вы [поставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), он сохранит выделение, которое у вас было, когда вы нажали `Enter`, независимо от того, что вы выделите после этого.906**Контекст выделения и открытого файла.** Пока CLI подключён, он включает ваше текущее выделение в редакторе и путь к активному файлу в качестве контекста в каждый отправляемый вами промпт. Когда это происходит, в транскрипте отображается строка `⧉ Selected N lines from <file>`. Следующие случаи изменяют этот контекст:

855 907

856Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [правило запрета `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило запрета не позволяет ни выделенному тексту, ни уведомлению об открытом файле для этого файла попасть к Claude.908* **Сообщения в очереди**: если вы [ставите сообщение в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works), оно сохраняет выделение, которое было у вас в момент нажатия `Enter`, независимо от того, что вы выделите после этого.

909* **Конфиденциальные файлы**: чтобы исключить конфиденциальный файл, например `.env`, добавьте [запрещающее правило `Read`](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее запрещающее правило не позволяет ни выделенному тексту, ни уведомлению об открытом файле для этого файла попасть к Claude.

910* **Настройка Attach Open File отключена**: если вы отключите [настройку Attach Open File](#extension-settings), CLI получает путь к активному файлу только тогда, когда в нём выделен текст.

857 911

858Если вы отключите [настройку Attach Open File](#extension-settings), CLI получит путь активного файла только при наличии выделенного текста в нём.912**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и этот порт нельзя настроить. Транспорт и токен аутентификации работают следующим образом:

859 913

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

915* **Токен аутентификации**: при каждой активации расширение генерирует новый случайный токен аутентификации и записывает его в lock-файл `~/.claude/ide/<port>.lock`. Для подключения CLI должен предъявить токен в заголовке `X-Claude-Code-Ide-Authorization`.

916* **Права доступа к lock-файлу**: lock-файл имеет права доступа `0600` в каталоге с правами `0700`, поэтому прочитать его может только пользователь, запустивший VS Code. Если задана переменная `CLAUDE_CONFIG_DIR`, lock-файл вместо этого записывается в `$CLAUDE_CONFIG_DIR/ide/`.

861 917

862**Инструменты, предоставляемые модели.** Сервер размещает дюжину инструментов, но только два видны модели. Остальные — это внутренний RPC, который CLI использует для собственного пользовательского интерфейса, например для открытия diff, чтения выделений и сохранения файлов. Они отфильтровываются до того, как список инструментов попадает к Claude.918**Инструменты, доступные модели.** Сервер предоставляет около дюжины инструментов, но модели видны только два. Остальные — это внутренние RPC, которые CLI использует для собственного интерфейса, например для открытия diff, чтения выделения и сохранения файлов. Они отфильтровываются до того, как список инструментов попадает к Claude.

863 919

865| - | - | - |921| - | - | - |

866| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера: ошибки и предупреждения на панели Problems в VS Code. Опционально ограничено одним файлом. | Да |922| `mcp__ide__getDiagnostics` | Возвращает диагностику языкового сервера: ошибки и предупреждения из панели Problems в VS Code. При необходимости может ограничиваться одним файлом. | Да |

867| `mcp__ide__executeCode` | Запускает код Python в ядре активной записной книжки Jupyter. См. процесс подтверждения ниже. | Нет |923| `mcp__ide__executeCode` | Выполняет код Python в ядре активного блокнота Jupyter. См. процесс подтверждения ниже. | Нет |

868 924

869**Диагностика в панели чата.** В панели чата, начиная с Claude Code v2.1.285, Claude читает панель Problems в VS Code через отдельный встроенный сервер с именем `claude-vscode`. Claude может запросить у него текущие ошибки и предупреждения для одного файла или для всех файлов, по которым у VS Code есть диагностика.925**Диагностика в панели чата.** В панели чата при использовании Claude Code v2.1.285 или более поздней версии Claude считывает панель Problems в VS Code через отдельный встроенный сервер с именем `claude-vscode`. Claude может запросить у него текущие ошибки и предупреждения в одном файле или во всех файлах, для которых у VS Code есть диагностика.

870 926

871Хуки и правила разрешений видят инструмент диагностики панели чата как `mcp__claude-vscode__getDiagnostics`. Чтобы охватить диагностику и в CLI, и в панели чата, укажите в своём хуке или правиле оба имени: `mcp__ide__getDiagnostics` и `mcp__claude-vscode__getDiagnostics`.927Хуки и правила разрешений видят инструмент диагностики панели чата как `mcp__claude-vscode__getDiagnostics`. Чтобы охватить диагностику и в CLI, и в панели чата, укажите в хуке или правиле оба имени: `mcp__ide__getDiagnostics` и `mcp__claude-vscode__getDiagnostics`.

872 928

873Этот пример `settings.json` запрещает оба инструмента:929Этот пример `settings.json` запрещает оба инструмента:

874 930

883}939}

884```940```

885 941

886Правило запрета `Read` не распространяется ни на один из этих инструментов, поэтому блокируйте их по имени с помощью [правила запрета](/docs/ru/permissions#mcp), как в примере.942Запрещающее правило `Read` не распространяется ни на один из этих инструментов, поэтому блокируйте их по имени с помощью [запрещающего правила](/docs/ru/permissions#mcp), как показано в примере.

943

944**Выполнение в Jupyter всегда требует подтверждения.** `mcp__ide__executeCode` не может ничего выполнить незаметно. Каждый вызов проходит следующие шаги:

945

9461. Код вставляется как новая ячейка в конец активного блокнота.

9472. VS Code прокручивает представление к этой ячейке.

9483. Встроенное окно Quick Pick предлагает выбрать **Execute** или **Cancel**.

887 949

888**Выполнение Jupyter всегда сначала запрашивает подтверждение.** `mcp__ide__executeCode` не может ничего запустить молча. При каждом вызове код вставляется как новая ячейка в конце активной записной книжки, VS Code прокручивает к ней, и встроенное окно Quick Pick предлагает вам выбрать **Execute** или **Cancel**. Отмена или закрытие окна выбора с помощью `Esc` возвращает ошибку Claude, и ничего не запускается. Инструмент также сразу отказывает, когда нет активной записной книжки, когда расширение Jupyter (`ms-toolsai.jupyter`) не установлено или когда ядро не является Python.950Отмена или закрытие окна выбора клавишей `Esc` возвращает Claude ошибку, и ничего не выполняется. Инструмент также сразу отказывает в выполнении, если нет активного блокнота, если не установлено расширение Jupyter (`ms-toolsai.jupyter`) или если ядро не Python.

889 951

890<Note>952<Note>

891 Подтверждение Quick Pick не зависит от хуков `PreToolUse`. Запись в списке разрешённых инструментов для `mcp__ide__executeCode` позволяет Claude *предложить* запуск ячейки; а Quick Pick внутри VS Code — это то, что позволяет ей *фактически* запуститься.953 Подтверждение через Quick Pick не связано с хуками `PreToolUse`. Запись в списке разрешённых для `mcp__ide__executeCode` позволяет Claude *предложить* выполнить ячейку; а *фактически* выполнить её позволяет именно Quick Pick внутри VS Code.

892</Note>954</Note>

893 955

894<a id="troubleshooting" />956<a id="troubleshooting" />

895 957

896<h2 id="fix-common-issues">958<h2 id="fix-common-issues">

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

898</h2>960</h2>

899 961

900Ошибкам входа, сети и запуска посвящены отдельные разделы на страницах устранения неполадок установки и справочника ошибок. Найдите в таблице то, что вы видите, и перейдите по ссылке.962Ошибкам входа, сети и запуска посвящены отдельные разделы на страницах устранения неполадок установки и справочника ошибок. Найдите в таблице то, что вы видите, и перейдите по ссылке.

901 963

902| Что вы видите | Куда перейти |964| Что вы видите | Куда перейти |

903| - | - |965| - | - |

904| `API Error: 403 Request not allowed` после входа в систему | [403 Forbidden после входа в систему](/docs/ru/troubleshoot-install#403-forbidden-after-login) |966| `API Error: 403 Request not allowed` после входа | [403 Forbidden после входа](/docs/ru/troubleshoot-install#403-forbidden-after-login) |

905| Вас просят войти снова, хотя вы уже вошли в систему | [Не выполнен вход или истёк срок действия токена](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) |967| Вас просят войти снова, хотя вы уже вошли | [Вход не выполнен или срок действия токена истёк](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) |

906| Учётные данные облачного провайдера работают в терминале, но не в расширении | [Учётные данные Bedrock, Agent Platform или Foundry не загружаются](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |968| Учётные данные облачного провайдера работают в терминале, но не в расширении | [Учётные данные Bedrock, Agent Platform или Foundry не загружаются](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |

907| `SSL certificate verification failed` или `Self-signed certificate detected` | [Ошибки SSL-сертификатов](/docs/ru/errors#ssl-certificate-errors) |969| `SSL certificate verification failed` или `Self-signed certificate detected` | [Ошибки SSL-сертификатов](/docs/ru/errors#ssl-certificate-errors) |

908| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](/docs/ru/errors#claude-code-process-exited-with-code-n) |970| `Claude Code process exited with code 1` или другой код | [Claude Code process exited with code N](/docs/ru/errors#claude-code-process-exited-with-code-n) |

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

915</h3>977</h3>

916 978

917* Убедитесь, что у вас установлена совместимая версия VS Code (1.94.0 или выше)979* Убедитесь, что у вас совместимая версия VS Code (1.94.0 или новее)

918* Проверьте, что VS Code имеет разрешение на установку расширений980* Проверьте, что у VS Code есть разрешение на установку расширений

919* Попробуйте установить напрямую из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)981* Попробуйте установить расширение напрямую из [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

920 982

921<h3 id="spark-icon-not-visible">983<h3 id="spark-icon-not-visible">

922 Значок Spark не виден984 Значок Spark не отображается

923</h3>985</h3>

924 986

925Значок Spark появляется на **панели инструментов редактора** (в верхнем правом углу редактора) при открытом файле. Если вы его не видите:987Значок Spark появляется на **панели инструментов редактора** (в правом верхнем углу редактора), когда у вас открыт файл. Если вы его не видите:

926 988

9271. **Откройте файл**: Значок требует открытого файла. Просто открытой папки недостаточно.9891. **Откройте файл**: для отображения значка должен быть открыт файл. Открытой папки недостаточно.

9282. **Проверьте версию VS Code**: Требуется версия 1.94.0 или выше (Help → About)9902. **Проверьте версию VS Code**: требуется 1.94.0 или новее. Проверьте в разделе **Help > About**

9293. **Перезагрузите VS Code**: Выполните "Developer: Reload Window" из палитры команд9913. **Перезапустите VS Code**: выполните «Developer: Reload Window» из палитры команд

9304. **Отключите конфликтующие расширения**: Временно отключите другие расширения ИИ (Cline, Continue и т. д.)9924. **Отключите конфликтующие расширения**: временно отключите другие AI-расширения (Cline, Continue и т. д.)

9315. **Проверьте доверие рабочей области**: Расширение не работает в режиме ограниченного доступа9935. **Проверьте доверие к рабочей области**: расширение не работает в ограниченном режиме (Restricted Mode)

932 994

933Кроме того, нажмите **✻ Claude Code** на **строке состояния** (в нижнем правом углу окна). Это работает даже без открытого файла. Вы также можете использовать **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести "Claude Code".995Кроме того, можно нажать **✻ Claude Code** в **строке состояния** в правом нижнем углу окна. Это работает даже без открытого файла. Также можно открыть **палитру команд** (`Cmd+Shift+P` / `Ctrl+Shift+P`) и ввести «Claude Code».

934 996

935<h3 id="cmd-esc-does-nothing-on-macos">997<h3 id="cmd-esc-does-nothing-on-macos">

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

937</h3>999</h3>

938 1000

939На macOS Tahoe и более поздних версиях системный ярлык Game Overlay по умолчанию привязан к `Cmd+Esc` и перехватывает нажатие клавиши до того, как оно достигнет VS Code. Чтобы освободить ярлык:1001В macOS Tahoe и новее системное сочетание клавиш Game Overlay по умолчанию назначено на `Cmd+Esc` и перехватывает нажатие до того, как оно дойдёт до VS Code. Чтобы освободить это сочетание клавиш:

940 1002

9411. Откройте System Settings10031. Откройте System Settings

9422. Перейдите в Keyboard, затем Keyboard Shortcuts, затем Game Controllers10042. Перейдите в Keyboard, затем Keyboard Shortcuts, затем Game Controllers

9433. Снимите флажок Game Overlay10053. Снимите флажок Game Overlay

944 1006

945Кроме того, вы можете переназначить расширение на другую клавишу: откройте редактор [Keyboard Shortcuts](https://code.visualstudio.com/docs/configure/keybindings) в VS Code (`Cmd+K Cmd+S`), найдите `Claude Code: Focus input` и назначьте новое сочетание клавиш.1007Либо назначьте расширению другое сочетание клавиш: откройте в VS Code [редактор сочетаний клавиш](https://code.visualstudio.com/docs/configure/keybindings) (`Cmd+K Cmd+S`), найдите `Claude Code: Focus input` и назначьте новое сочетание.

946 1008

947<h3 id="a-resumed-conversation-is-blank-at-first">1009<h3 id="a-resumed-conversation-is-blank-at-first">

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

949</h3>1011</h3>

950 1012

951Когда вы [возобновляете прошлый диалог](#resume-past-conversations) или диалог [восстанавливается после перезагрузки](#continue-conversations-after-a-reload), его сообщения могут оставаться пустыми, пока запускается процесс Claude Code для этого диалога. Примерно через секунду в пустой области появляется `Waiting for your plugins…`.1013Когда вы [возобновляете прошлый диалог](#resume-past-conversations) или диалог [восстанавливается после перезагрузки](#continue-conversations-after-a-reload), его сообщения могут оставаться пустыми, пока запускается процесс Claude Code для этого диалога. Примерно через секунду на пустом месте появляется `Waiting for your plugins…`.

952 1014

953Вам не нужно ничего делать. Сообщения появятся, как только процесс запустится и подтвердит, что ни одному плагину не нужно сначала их проверить, или через 20 секунд, если запуск занимает больше времени.1015Ничего делать не нужно. Сообщения появятся, как только процесс запустится и подтвердит, что ни одному плагину не нужно предварительно их проверить, либо через 20 секунд, если запуск занимает больше времени.

954 1016

955<h3 id="the-panel-stops-responding-each-time-a-reload-reopens-a-conversation">1017<h3 id="the-panel-stops-responding-each-time-a-reload-reopens-a-conversation">

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

957</h3>1019</h3>

958 1020

959Если вся панель аварийно завершает работу, зависает или показывает только `Something went wrong` каждый раз, когда вы перезагружаете окно и ваш диалог восстанавливается, обновите расширение до версии v2.1.301 или выше. Затем снова перезагрузите окно или перезапустите VS Code. Если диалогу дважды подряд не удаётся завершить открытие, вместо него вы получите новый чат с уведомлением о том, что [он не был открыт повторно](#a-conversation-was-not-reopened).1021Если вся панель аварийно завершает работу, зависает или показывает только `Something went wrong` каждый раз, когда вы перезагружаете окно и ваш диалог восстанавливается, обновите расширение до v2.1.301 или новее. Затем снова перезагрузите окно или перезапустите VS Code. После того как диалогу дважды подряд не удастся полностью открыться, вместо него вы получите новый чат с уведомлением о том, что [он не был открыт заново](#a-conversation-was-not-reopened).

960 1022

961<h3 id="a-formula-shows-as-raw-latex">1023<h3 id="a-formula-shows-as-raw-latex">

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

963</h3>1025</h3>

964 1026

965Если ни одна математическая формула в ответах Claude не отображается в отформатированном виде, проверьте версию расширения в представлении Extensions, поскольку [отображение математики](#latex-math-in-responses) требует версии 2.1.301 или выше. Если вы используете [режим терминала](#switch-to-terminal-mode), который не форматирует математику независимо от версии, снимите флажок [настройки Use Terminal](vscode://settings/claudeCode.useTerminal), чтобы Claude Code открывался в панели чата.1027Если никакие математические выражения в ответах Claude не отображаются в наборе, проверьте версию расширения в представлении Extensions, поскольку [отображение математики](#latex-math-in-responses) требует версии 2.1.301 или новее. Если вы используете [режим терминала](#switch-to-terminal-mode), который не отображает математику независимо от версии, снимите флажок [настройки Use Terminal](vscode://settings/claudeCode.useTerminal), чтобы Claude Code открывался в панели чата.

966 1028

967Если одна формула отображается в исходном виде, а другие рядом с ней отформатированы, проверьте её на следующие причины:1029Если одна формула отображается в исходном виде, а соседние — в наборе, проверьте её на следующие причины:

968 1030

969* **Она воспринимается не как математика**: текст `$…$`, который читается как слово, остаётся в исходном виде, например `$O(n log n)$`. Текст `$…$`, начинающийся с цифры, например `$30$` или `$1/N$`, также остаётся в исходном виде, если только такой символ, как `=`, `+` или `^`, не помечает его как математику. Вместо этого попросите Claude использовать блок `$$` на отдельных строках, который панель форматирует без этой проверки.1031* **Она читается не как математика**: текст `$…$`, который читается как слово, остаётся в исходном виде, например `$O(n log n)$`. Текст `$…$`, начинающийся с цифры, например `$30$` или `$1/N$`, также остаётся в исходном виде, если только такой символ, как `=`, `+` или `^`, не помечает его как математику. Вместо этого попросите Claude оформить блок `$$` на отдельных строках — панель отображает его в наборе без этой проверки.

970* **Она содержит отступы, слишком длинная или разбита на строки**: `$ x^2 $` с пробелами внутри знаков доллара, содержимое `$…$` длиннее 60 символов, а также `$…$` или `$…$`, разбитые на две строки, не форматируются. Вместо этого попросите Claude использовать блок `$$` на отдельных строках, у которого нет этих ограничений.1032* **Она содержит пробелы по краям, слишком длинная или разбита на строки**: `$ x^2 $` с пробелами внутри знаков доллара, содержимое `$…$` длиннее 60 символов, а также `$…$` или `$…$`, разбитые на две строки, не отображаются в наборе. Вместо этого попросите Claude оформить блок `$$` на отдельных строках — у него нет ни одного из этих ограничений.

971* **TeX невозможно отформатировать**: формула с синтаксической ошибкой, определением макроса, например `\newcommand` или `\def`, или неэкранированным `%` отображается в исходном виде. Попросите Claude переписать её, исправив ошибку, без макроса или с `\%` для знака процента.1033* **TeX невозможно набрать**: формула с синтаксической ошибкой, определением макроса, например `\newcommand` или `\def`, или неэкранированным `%` отображается в исходном виде. Попросите Claude переписать её с исправленной ошибкой, без макроса или с `\%` для знака процента.

972* **Она слишком большая**: формула длиннее 8 192 символов или формула, которая при отрисовке оказалась бы намного больше своего исходного текста, отображается в исходном виде. Попросите Claude разбить её на формулы поменьше или записать компактнее.1034* **Она слишком большая**: формула длиннее 8 192 символов или формула, которая при отрисовке получилась бы намного больше своего исходного текста, отображается в исходном виде. Попросите Claude разбить её на формулы поменьше или записать компактнее.

973* **Она следует за большим объёмом математики**: в пределах одного блока текста в ответе панель форматирует формулы по порядку до определённого предела. Следующая формула, которая превысила бы этот предел, отображается в исходном виде. Попросите Claude отправить нужную вам формулу ещё раз отдельно.1035* **Она следует за большим объёмом математики**: в пределах одного текстового блока ответа панель отображает формулы в наборе по порядку до определённого предела. Последующая формула, которая превысила бы этот предел, отображается в исходном виде. Попросите Claude отправить нужную вам формулу ещё раз отдельно.

974 1036

975<h3 id="claude-code-never-responds">1037<h3 id="claude-code-never-responds">

976 Claude Code никогда не отвечает1038 Claude Code не отвечает

977</h3>1039</h3>

978 1040

979Если Claude Code не отвечает на ваши запросы:1041Если Claude Code не отвечает на ваши промпты:

980 1042

9811. **Проверьте подключение к интернету**: Убедитесь, что у вас есть стабильное подключение к интернету10431. **Проверьте подключение к интернету**: убедитесь, что у вас стабильное подключение к интернету

9822. **Начните новый разговор**: Попробуйте начать новый разговор, чтобы проверить, сохраняется ли проблема10442. **Начните новый диалог**: попробуйте начать новый диалог, чтобы проверить, сохраняется ли проблема

9833. **Попробуйте CLI**: Выполните `claude` из терминала, чтобы увидеть более подробные сообщения об ошибках10453. **Попробуйте CLI**: запустите `claude` в терминале, чтобы увидеть более подробные сообщения об ошибках

984 1046

985Если проблемы сохраняются, [создайте проблему на GitHub](https://github.com/anthropics/claude-code/issues) с подробностями об ошибке.1047Если проблемы не исчезают, [создайте issue на GitHub](https://github.com/anthropics/claude-code/issues) с подробным описанием ошибки.

986 1048

987<h2 id="uninstall-the-extension">1049<h2 id="uninstall-the-extension">

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

990 1052

991Чтобы удалить расширение Claude Code:1053Чтобы удалить расширение Claude Code:

992 1054

9931. Откройте представление расширений (`Cmd+Shift+X` на Mac или `Ctrl+Shift+X` на Windows/Linux)10551. Нажмите `Cmd+Shift+X` на Mac или `Ctrl+Shift+X` на Windows/Linux, чтобы открыть представление Extensions

9942. Найдите "Claude Code"10562. Найдите «Claude Code»

9953. Нажмите **Uninstall**10573. Нажмите **Uninstall**

996 1058

997Если вы запустите `claude` в интегрированном терминале VS Code, Claude Code автоматически переустановит расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или установите [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false`. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) на `1`.1059Если вы запускаете `claude` во встроенном терминале VS Code, Claude Code автоматически переустанавливает расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или задайте для [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) значение `false`. Также можно задать для переменной окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) значение `1`.

998 1060

999Чтобы также удалить данные расширения и сбросить все параметры, удалите каталог хранилища расширения для вашей платформы.1061Чтобы также удалить данные расширения и сбросить все настройки, удалите каталог хранилища расширения для вашей платформы.

1000 1062

1001На macOS:1063В macOS:

1002 1064

1003```bash theme={null}1065```bash theme={null}

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

1005```1067```

1006 1068

1007На Linux:1069В Linux:

1008 1070

1009```bash theme={null}1071```bash theme={null}

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

1011```1073```

1012 1074

1013На Windows в PowerShell:1075В Windows, в PowerShell:

1014 1076

1015```powershell theme={null}1077```powershell theme={null}

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

1017```1079```

1018 1080

1019Для получения дополнительной помощи см. [руководство по устранению неполадок](/docs/ru/troubleshooting).1081Дополнительную помощь см. в [руководстве по устранению неполадок](/docs/ru/troubleshooting).

1020 1082

1021<h2 id="next-steps">1083<h2 id="next-steps">

1022 Следующие шаги1084 Дальнейшие шаги

1023</h2>1085</h2>

1024 1086

1025Теперь, когда вы настроили Claude Code в VS Code:1087Теперь, когда вы настроили Claude Code в VS Code:

1026 1088

1027* [Изучите распространённые рабочие процессы](/docs/ru/common-workflows), чтобы максимально использовать Claude Code1089* [Изучите распространённые рабочие процессы](/docs/ru/common-workflows), чтобы получить максимум от Claude Code

1028* [Настройте MCP серверы](/docs/ru/mcp) для расширения возможностей Claude с помощью внешних инструментов. Добавляйте и управляйте ими с помощью `/mcp` в панели чата.1090* [Настройте MCP-серверы](/docs/ru/mcp), чтобы расширить возможности Claude с помощью внешних инструментов. Добавляйте их и управляйте ими с помощью `/mcp` в панели чата.

1029* [Настройте параметры Claude Code](/docs/ru/settings) для настройки разрешённых команд, hooks и многого другого. Эти параметры общие для расширения и CLI.1091* [Настройте параметры Claude Code](/docs/ru/settings), чтобы настроить разрешённые команды, хуки и многое другое. Эти настройки являются общими для расширения и CLI.

1092* [Ознакомьтесь с мерами безопасности](/docs/ru/security) и [использованием данных](/docs/ru/data-usage) в Claude Code

vs-code.md 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Откройте историю сессий

Выберите вкладку Web

Выберите сессию для возобновления

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

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

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

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

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

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

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

A conversation was not reopened

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

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

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

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

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

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

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

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

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

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

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

Работа с git

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

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

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

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

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

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

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

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

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

Отключите промпт входа

Настройте провайдера

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

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

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

Запуск CLI в VS Code

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

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

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

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

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

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

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

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

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

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

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

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

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