SpyBara
Go Premium

chrome.md 2026-10-01 23:59 UTC to 2026-10-02 07:00 UTC

This page contains 94 additions and 32 deletions.

2026
Fri 2 08:03

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

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

Claude Code интегрируется с расширением Claude in Chrome для браузера, чтобы предоставить вам возможности автоматизации браузера из CLI или расширения VS Code. Создавайте свой код, а затем тестируйте и отлаживайте его в браузере без переключения контекста.

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

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

  • Когда вы вводите /clear, Claude Code закрывает группу вместе с открытыми страницами, если только не продолжает выполняться работа, которая сохраняется после очистки
  • Когда вы переключаете сессии с помощью такой команды, как /resume, выходите из Claude Code или выполняете /clear, пока продолжает выполняться работа, которая сохраняется после очистки, Claude Code закрывает группу только в том случае, если в ней нет ничего, кроме пустых новых вкладок, поэтому страницы, которые вы, возможно, ещё читаете, остаются открытыми

Возможности

С подключенным Chrome вы можете объединять действия браузера с задачами кодирования в единый рабочий процесс:

  • Живая отладка: читайте ошибки консоли и состояние DOM напрямую, а затем исправьте код, который их вызвал
  • Проверка дизайна: создайте пользовательский интерфейс на основе макета Figma, а затем откройте его в браузере, чтобы проверить соответствие
  • Тестирование веб-приложений: тестируйте валидацию форм, проверяйте визуальные регрессии или проверяйте потоки пользователей
  • Аутентифицированные веб-приложения: взаимодействуйте с Google Docs, Gmail, Notion или любым приложением, в которое вы вошли, без коннекторов API
  • Извлечение данных: извлекайте структурированную информацию со страниц и сохраняйте её локально
  • Автоматизация задач: автоматизируйте повторяющиеся задачи браузера, такие как ввод данных, заполнение форм или многосайтовые рабочие процессы
  • Загрузка файлов: прикрепляйте файлы с вашего компьютера к полям загрузки на веб-страницах
  • Запись сессии: записывайте взаимодействия браузера в виде GIF-файлов для документирования или обмена информацией о том, что произошло

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

Перед использованием Claude Code с Chrome вам необходимо:

  • Google Chrome, Microsoft Edge или другой браузер на основе Chromium, например Brave, Arc, Vivaldi или Opera
  • Расширение Claude in Chrome версии 1.0.36 или выше, доступное в Chrome Web Store
  • Claude Code
  • Прямой план Anthropic (Pro, Max, Team или Enterprise)

Для интеграции с Chrome также требуется вход с помощью /login. Если вы проходите аутентификацию с помощью API-ключа или долгоживущего токена из claude setup-token, Claude Code оставляет интеграцию с Chrome выключенной, даже если вы передаёте --chrome, поскольку расширение браузера не может пройти аутентификацию с этими учётными данными. До версии v2.1.216 такие сессии могли включать интеграцию с Chrome, но каждая попытка подключиться к расширению браузера завершалась ошибкой 403.

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

1

Запустите Claude Code с Chrome

Запустите Claude Code с флагом --chrome:

claude --chrome

При первом запуске с Chrome Claude Code показывает одноразовое диалоговое окно, которое знакомит с интеграцией и объясняет, как работают разрешения сайтов. Нажмите Enter, чтобы продолжить.

Чтобы включить Chrome для будущих сессий без флага, см. Включение Chrome по умолчанию.

2

Попросите Claude использовать браузер

Этот пример переходит на страницу, взаимодействует с ней и сообщает, что он находит, всё из вашего терминала или редактора:

Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

Если Claude Code запрашивает разрешение перед действием в браузере, одобрите его. Диалоговое окно начинается со слов Claude in Chrome wants to и предлагает вариант разрешить все действия на этом сайте на время сессии. Claude откроет новую вкладку и начнёт выполнение задачи.

Выполните /chrome в любое время, чтобы проверить статус подключения, управлять разрешениями, переподключить расширение или выбрать, какой подключённый браузер использовать. Интеграция работает, когда панель статуса показывает «Статус: включено» и «Расширение: установлено».

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

Для VS Code см. автоматизацию браузера в VS Code.

Установка расширения по запросу Claude

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

Запрос предлагает три варианта:

  • Установить расширение: открывает страницу установки расширения в вашем браузере и запускает пошаговую настройку. Claude Code ожидает установки, подключает расширение и включает инструменты браузера в той же сессии. Когда подключение готово, выберите «Продолжить с инструментами браузера», и Claude возобновит задачу в вашем браузере. Вы можете выйти из настройки, выбрав «Продолжить без инструментов браузера», и завершить её позже с помощью /chrome.
  • Не сейчас: продолжает задачу без инструментов браузера. Claude Code может спросить снова в одной из следующих сессий.
  • Больше не спрашивать: отключает запрос в будущих сессиях. Вы по-прежнему можете настроить интеграцию в любое время с помощью /chrome.

Две управляемые политики MCP отключают этот запрос:

Включение Chrome по умолчанию

Чтобы избежать передачи --chrome в каждой сессии, выполните /chrome и выберите «Включено по умолчанию».

Claude Code запускается нормально, когда Chrome не запущен. До версии v2.1.211 запуск мог зависать, если интеграция с Chrome была включена, но Chrome не был запущен.

В расширении VS Code Chrome доступен всякий раз, когда установлено расширение Chrome. Дополнительный флаг не требуется.

Управление разрешениями сайта

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

Инструменты браузера в режиме планирования

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

Вызов tabs_context_mcp также запрашивает разрешение, когда он устанавливает createIfEmpty, как и вызов browser_batch, включающий любое из этих действий.

Примеры рабочих процессов

Эти примеры показывают распространённые способы объединения действий браузера с задачами кодирования. Выполните /mcp, выберите claude-in-chrome, затем выберите View tools, чтобы увидеть полный список доступных инструментов браузера.

Тестирование локального веб-приложения

При разработке веб-приложения попросите Claude проверить, что ваши изменения работают правильно:

I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?

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

Отладка с помощью логов консоли

Claude может читать вывод консоли, чтобы помочь диагностировать проблемы. Скажите Claude, какие шаблоны искать, а не просите весь вывод консоли, так как логи могут быть многословными:

Open the dashboard page and check the console for any errors when
the page loads.

Claude читает сообщения консоли и может фильтровать по определённым шаблонам или типам ошибок.

Автоматизация заполнения форм

Ускорьте повторяющиеся задачи ввода данных:

I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.

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

Загрузка файлов на веб-страницы

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

В этом примере к форме прикрепляется файл лога:

Open the bug tracker at bugs.example.com, create a new issue,
and attach logs/session.log to it

К загрузке применяются три ограничения:

  • Разрешения: Claude может загрузить файл, только если сессии разрешено его читать, поэтому правила разрешений, запрещающие доступ Read к файлу, также блокируют его загрузку.
  • Размер: одна загрузка может включать до 10 МБ файлов в сумме.
  • Жёсткие ссылки: Claude отказывается загружать файлы с несколькими жёсткими ссылками, что часто встречается в хранилищах менеджеров пакетов, таких как node_modules. Скопируйте файл и загрузите копию.

Создание контента в Google Docs

Используйте Claude для прямого написания в ваших документах без настройки API:

Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123

Claude открывает документ, нажимает в редактор и вводит контент. Это работает с любым веб-приложением, в которое вы вошли: Gmail, Notion, Sheets и многое другое.

Извлечение данных со страниц

Извлекайте структурированную информацию с веб-сайтов:

Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.

Claude переходит на страницу, читает контент и компилирует данные в структурированный формат.

Запуск многосайтовых рабочих процессов

Координируйте задачи на нескольких веб-сайтах:

Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.

Claude работает на разных вкладках, чтобы собрать информацию и завершить рабочий процесс.

Запись демо-GIF

Создавайте общедоступные записи взаимодействий браузера:

Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.

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

Сохранение скриншотов на диск

Попросите Claude сохранить скриншот в виде файла:

Take a screenshot of the checkout page and save it to disk

Claude сохраняет изображение на диск и сообщает путь к файлу. До версии v2.1.211 параметр save_to_disk инструмента для скриншотов не записывал файл.

Устранение неполадок

Расширение не обнаружено

Если Claude Code не может обнаружить расширение Chrome:

  1. Убедитесь, что расширение Chrome установлено и включено в chrome://extensions
  2. Убедитесь, что Claude Code обновлён, выполнив claude --version
  3. Проверьте, что Chrome запущен
  4. Выполните /chrome и выберите "Reconnect extension", чтобы переустановить соединение
  5. Если проблема сохраняется, перезагрузите Claude Code и Chrome

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

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

Если соединение по-прежнему не удаётся, убедитесь, что файл конфигурации хоста существует в:

Для Chrome:

  • macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Linux: ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Windows: проверьте HKCU\Software\Google\Chrome\NativeMessagingHosts\ в реестре Windows

Для Edge:

  • macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Windows: проверьте HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ в реестре Windows

Другие браузеры на основе Chromium читают тот же файл из собственного каталога конфигурации, названного по имени браузера. Например, Brave в macOS использует ~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, а в Windows у каждого браузера есть собственный раздел реестра, например HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.

Браузер не отвечает

Если команды браузера Claude перестают работать:

  1. Проверьте, не блокирует ли модальное диалоговое окно (alert, confirm, prompt) страницу. Диалоговые окна JavaScript блокируют события браузера и препятствуют получению команд Claude. Закройте диалоговое окно вручную, а затем скажите Claude продолжить.
  2. Попросите Claude создать новую вкладку и повторить попытку
  3. Перезагрузите расширение Chrome, отключив и повторно включив его в chrome://extensions

Разрыв соединения во время длительных сессий

Service worker расширения Chrome может перейти в режим ожидания во время продолжительных сессий, что нарушает соединение. Если инструменты браузера перестают работать после периода неактивности, выполните /chrome и выберите "Reconnect extension".

Проблемы, специфичные для Windows

На Windows вы можете столкнуться с:

  • Конфликты именованных каналов (EADDRINUSE): если другой процесс использует тот же именованный канал, перезагрузите Claude Code. Закройте все остальные сессии Claude Code, которые могут использовать Chrome.
  • Ошибки хоста собственного обмена сообщениями: если хост собственного обмена сообщениями падает при запуске, попробуйте переустановить Claude Code, чтобы восстановить конфигурацию хоста.
  • Страницы настройки не открываются: обновите Claude Code. До версии v2.1.211 вкладка браузера с предложением подключить расширение могла не открываться в Windows.

Распространённые сообщения об ошибках

Это наиболее часто встречающиеся ошибки и способы их решения:

Ошибка Причина Решение
"Browser extension is not connected" Хост собственного обмена сообщениями не может достичь расширения, или список разрешённых IP-адресов вашей организации отклоняет подключение к bridge.claudeusercontent.com Перезагрузите Chrome и Claude Code, затем выполните /chrome для переподключения. Если ваша организация использует список разрешённых IP-адресов и ошибка сохраняется, см. Списки разрешённых IP-адресов организации и исходящий трафик через прокси
Расширение отображается как "Not detected" в /chrome Расширение Chrome не установлено или отключено Установите или включите расширение в chrome://extensions
"No tab available" Claude попытался действовать до того, как вкладка была готова Попросите Claude создать новую вкладку и повторить попытку
"Receiving end does not exist" Service worker расширения перешёл в режим ожидания Выполните /chrome и выберите "Reconnect extension"

See also