SpyBara
Go Premium

vs-code.md 2026-10-01 23:59 UTC to 2026-10-02 16:57 UTC

This page contains 148 additions and 100 deletions.

2026
Thu 1 23:59 Fri 2 18:00

Использование 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), чтобы открыть представление расширений, найдите "Claude Code" и нажмите Установить.

Расширение также устанавливается в других форках VS Code, таких как Devin Desktop или Kiro. Найдите "Claude Code" в представлении расширений вашего редактора или установите из реестра Open VSX. Если ваш редактор не может установить расширение, установите CLI и запустите claude в его встроенном терминале. CLI работает в любом терминале.

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

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

1

Откройте панель 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 icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

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

VS Code editor showing the Spark icon in the Editor Toolbar

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

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

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

2

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

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

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

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

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

3

Отправьте запрос

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

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

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
4

Проверьте изменения

То, что вы видите, зависит от режима разрешений, показанного в нижней части поля запроса:

  • В режиме Auto или Edit automatically Claude редактирует большинство файлов в вашем рабочем пространстве без запроса.
  • В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного и предложенного изменений рядом, а затем запрашивает разрешение. Вы можете принять, отклонить или сказать Claude, что делать вместо этого. Если вы отредактируете предложенное содержимое непосредственно в представлении diff перед принятием, Claude будет уведомлен, что вы его изменили, поэтому он не будет предполагать, что файл соответствует его исходному предложению.
VS Code showing a diff of Claude's proposed changes with a permission prompt asking whether to make the edit

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

Те же действия доступны в курсоре из контекстного меню редактора и из Command Palette как 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 через прямое подключение, Claude Code отправляет его в Anthropic. Требуется Claude Code v2.1.229 или новее.

      При использовании стороннего провайдера или без учётных данных Anthropic ничего не отправляется. Диалоговое окно сообщает об этом до того, как вы начнёте писать. При отправке отчёт сохраняется как локальный архив в ~/.claude/feedback-bundles/, в котором скрыты известные шаблоны API-ключей и токенов. Отправьте этот файл представителю вашего аккаунта в Anthropic или прикрепите его к обращению в поддержку. В подтверждении указано имя файла и есть кнопка Show folder. Сохранение отчёта на вашем компьютере требует Claude Code v2.1.284 или новее.

      Если политика вашей организации отключает отзывы о продукте, пункт 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 хранит 20 последних обменов сообщениями и удаляет сохранённые ветки по расписанию cleanupPeriodDays, если Claude Code может безопасно определить срок хранения. Чтобы очистить ветку, нажмите на значок корзины на панели. Требуется Claude Code v2.1.227 или новее.

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

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

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

    • Пока отсчёт не закончился, значок показывает оставшиеся минуты, например 12m.
    • Когда отсчёт заканчивается, минуты исчезают, а значок становится красным (или цвета ошибки в вашей теме) до следующего ответа. Кэш, скорее всего, истёк, поэтому ожидайте более медленного и дорогого ответа на следующее сообщение, пока кэш создаётся заново. Если пятиминутный срок жизни постоянно истекает между вашими сообщениями, см. раздел Выбор TTL вручную.
    • Сразу после сжатия диалога значок также становится красным без минут до следующего ответа, потому что кэш ещё не охватывает сжатый диалог.
  • Карта агентов: когда диалог включает субагентов, в нижней части поля ввода промпта появляется счётчик агентов, например 2 agents. Его точка показывает, работает ли какой-либо субагент или ожидает вашего разрешения.

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

    Под агентами на карте также перечислены другие фоновые задачи сессии, например фоновые shell-команды и мониторы. Нажмите на строку, чтобы открыть карточку задачи и остановить её там.

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

  • Расширенное мышление: позволяет 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 отправляет выделенный текст независимо от файла, поэтому добавьте правило запрета Read, чтобы скрыть содержимое файла от Claude в этом случае.

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

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

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

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

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

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

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

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

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

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

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

Если диалог (сам разговор с 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, расширение пропускает эту проверку и сразу открывает диалог.

По умолчанию сессия без активности в течение 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 не восстанавливает его в двух случаях:

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

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

1

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

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

2

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

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

3

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

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

На вкладке 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 или новее.

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

Настройте свой рабочий процесс

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

Выберите, где находится Claude

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

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

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

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

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

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

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

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

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

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

Запустите несколько разговоров

Используйте 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, на которой вы в последний раз сфокусировались.
  • Filter by status: щёлкните на значке воронки, затем установите флажок Needs input, Working или Completed, чтобы показать сеансы в любом из этих состояний. Установите флажок Open или Closed, чтобы сузить по тому, открыт ли сеанс. Сеанс считается открытым, когда он имеет вкладку в этом окне или работает в другом процессе Claude Code на этой машине, например в терминале.

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

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

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

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

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

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

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

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

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

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

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

  • Установить для вас: доступно во всех ваших проектах (область пользователя)
  • Установить для этого проекта: общее использование с сотрудниками проекта (область проекта)
  • Установить локально: только для вас, только в этом репозитории (локальная область)

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

Чувствительные текстовые поля скрыты, а сохраненный ранее секрет отображается как (без изменений). Оставьте поле пустым, чтобы сохранить сохраненное значение.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дополнительную информацию о системе плагинов см. в разделах Плагины и Маркетплейсы плагинов.

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

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

Введите @browser в поле промпта, а затем то, что вы хотите, чтобы Claude сделал:

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

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

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

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

Инструкции по настройке, полный список возможностей и устранение неполадок см. в разделе Use Claude Code with Chrome.

Команды и сочетания клавиш 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. Переходит к обычному переоткрытию закрытого редактора VS Code, если последняя закрытая вкладка не была сеансом Claude. Отключить с помощью 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"

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

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

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

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

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

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

Расширение имеет два типа параметров:

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

Параметры расширения

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

Параметр По умолчанию Описание
useTerminal false Запустить Claude в режиме терминала вместо графической панели
initialPermissionMode - Управляет запросами одобрения для новых бесед: default, plan, acceptEdits или bypassPermissions. manual является псевдонимом для default и выбирает режим, обозначенный как Manual в индикаторе режима. Если оставить его неустановленным, расширение выбирает начальный режим разрешений, как описано в Switch permission modes.
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 false Показывать, когда было отправлено каждое сообщение. Строка с датой отмечает место смены дня. Требуется Claude Code v2.1.284 или позже
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, если сборка расширения не включает его для вашей платформы. В обёрнутой установке беседы начинаются в режиме Manual, если вы не установили initialPermissionMode или не выбрали Manual, Edit automatically или Auto в более ранней беседе, потому что расширение пропускает параметры и встроенные шаги по умолчанию там; см. Switch permission modes. Ошибка "Unsupported platform" при активации означает, что для вашей платформы не встроен двоичный файл; см. какие платформы имеют предварительно собранные двоичные файлы.

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

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

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

Во время разговора расширение объявляет:

  • Ответы Claude: расширение объявляет каждый ответ один раз, когда он завершен, и молчит во время потоковой передачи текста. Ваша программа чтения с экрана читает блоки кода как сводку по количеству строк, читает ссылки по их метке и читает таблицы ячейка за ячейкой; полный ответ остается читаемым в стенограмме.
  • Запросы разрешений и вопросы: расширение объявляет запрос, когда появляется его диалоговое окно разрешения, называя инструмент, который Claude хочет использовать. Оно объявляет таким же образом, когда Claude задает вам вопрос и когда Claude завершает план и ждет вашего рассмотрения.
  • Изменения статуса: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.
  • Ошибки и подсказки модели: расширение объявляет об ошибках в разговоре и объявляет, когда появляется диалоговое окно согласия на использование кредитов или диалоговое окно помеченного запроса.

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

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

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

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

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

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

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

Когда опция в диалоговом окне разрешения сохраняет правило разрешения или доступ к каталогу, ее метка заканчивается названием места сохранения одобрения, например "все проекты" или "этот сеанс". Когда опция сфокусирована, нажмите клавишу Left или Right для изменения назначения, и расширение объявляет каждое назначение по мере того, как вы на него переходите. Вы также можете щелкнуть на назначение в метке. Клавиши со стрелками требуют Claude Code версии 2.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
Команды и skills Все Подмножество (введите / для просмотра доступных)
Конфигурация MCP server Да Да (добавление и управление серверами с помощью /mcp на панели чата)
Checkpoints Да Да
Сочетание клавиш ! Bash Да Нет
Автодополнение Tab Да Нет

Rewind с checkpoints

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

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

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

Запуск CLI в VS Code

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

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

Если вы используете внешний терминал, запустите /ide внутри Claude Code, чтобы подключить его к VS Code.

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

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

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

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

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

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

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

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

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

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

Подключение к внешним инструментам с помощью 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").

Чтобы найти серверы для подключения, см. Find and build MCP servers.

Работа с 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 Code подключается непосредственно к API Anthropic. Если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry для доступа к Claude, настройте расширение на использование вашего поставщика:

1

Отключение запроса входа

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

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

2

Настройка вашего поставщика

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

Эти руководства охватывают настройку вашего поставщика в ~/.claude/settings.json, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.

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

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

Безопасность и конфиденциальность

Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробнее о обработке данных и способах отказа от логирования см. Data and privacy.

Когда включены разрешения на автоматическое редактирование, Claude Code может изменять файлы конфигурации VS Code (такие как settings.json или tasks.json), которые VS Code может выполнять автоматически. Чтобы снизить риск при работе с ненадёжным кодом:

  • Включите VS Code Restricted Mode для ненадёжных рабочих пространств
  • Используйте Manual mode вместо Edit automatically или Auto для редактирования
  • Внимательно проверяйте изменения перед их принятием

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

Когда расширение активно, оно запускает локальный MCP сервер, к которому CLI подключается автоматически. Именно так CLI открывает различия в встроенном средстве просмотра различий VS Code, читает ваш текущий выбор для упоминаний @ и — когда вы работаете в записной книжке Jupyter — просит VS Code выполнить ячейки.

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

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

Если вы поставите сообщение в очередь, пока Claude работает, он сохранит выделение, которое у вас было, когда вы нажали Enter, независимо от того, что вы выберете после этого.

Чтобы исключить конфиденциальный файл, такой как .env, добавьте правило отказа Read для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

Если вы отключите параметр Attach Open File, CLI получит путь активного файла только при наличии выделенного текста в нём.

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

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

Имя инструмента (как его видят hooks) Что он делает Только для чтения
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.

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

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

Значок Spark не виден

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

  1. Откройте файл: Значок требует открытого файла. Просто открытой папки недостаточно.
  2. Проверьте версию VS Code: Требуется версия 1.94.0 или выше (Help → About)
  3. Перезагрузите VS Code: Выполните "Developer: Reload Window" из палитры команд
  4. Отключите конфликтующие расширения: Временно отключите другие расширения ИИ (Cline, Continue и т. д.)
  5. Проверьте доверие рабочей области: Расширение не работает в режиме ограниченного доступа

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

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

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

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

Кроме того, вы можете переназначить расширение на другую клавишу: откройте редактор Keyboard Shortcuts в VS Code (Cmd+K Cmd+S), найдите Claude Code: Focus input и назначьте новое сочетание клавиш.

Claude Code никогда не отвечает

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

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

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

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

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

  1. Откройте представление расширений (Cmd+Shift+X на Mac или Ctrl+Shift+X на Windows/Linux)
  2. Найдите "Claude Code"
  3. Нажмите 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: