Интеграция с Chrome работает с Google Chrome и Microsoft Edge. Она еще не поддерживается на Brave, Arc или других браузерах на основе Chromium. Она также не поддерживается в Windows Subsystem for Linux (WSL).
Возможности
С подключенным Chrome вы можете объединять действия браузера с задачами кодирования в единый рабочий процесс:- Живая отладка: читайте ошибки консоли и состояние DOM напрямую, а затем исправьте код, который их вызвал
- Проверка дизайна: создайте пользовательский интерфейс на основе макета Figma, а затем откройте его в браузере, чтобы проверить соответствие
- Тестирование веб-приложений: тестируйте валидацию форм, проверяйте визуальные регрессии или проверяйте потоки пользователей
- Аутентифицированные веб-приложения: взаимодействуйте с Google Docs, Gmail, Notion или любым приложением, в которое вы вошли, без коннекторов API
- Извлечение данных: извлекайте структурированную информацию со страниц и сохраняйте её локально
- Автоматизация задач: автоматизируйте повторяющиеся задачи браузера, такие как ввод данных, заполнение форм или многосайтовые рабочие процессы
- Запись сеанса: записывайте взаимодействия браузера в виде GIF-файлов для документирования или обмена информацией о том, что произошло
Предварительные требования
Перед использованием Claude Code с Chrome вам необходимо:- Браузер Google Chrome или Microsoft Edge
- Расширение Claude in Chrome версии 1.0.36 или выше, доступное в Chrome Web Store для обоих браузеров
- Claude Code
- Прямой план Anthropic (Pro, Max, Team или Enterprise)
Интеграция с Chrome недоступна через сторонних поставщиков, таких как Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через стороннего поставщика, вам нужна отдельная учетная запись claude.ai для использования этой функции.
Начало работы в CLI
1
Запустите Claude Code с Chrome
Запустите Claude Code с флагом Вы также можете включить Chrome в существующем сеансе, выполнив
--chrome:/chrome.2
Попросите Claude использовать браузер
Этот пример переходит на страницу, взаимодействует с ней и сообщает, что он находит, всё из вашего терминала или редактора:Первое действие браузера запрашивает разрешение на использование навыка
claude-in-chrome. Одобрите его, и Claude откроет новую вкладку и начнёт выполнение задачи./chrome в любое время, чтобы проверить статус подключения, управлять разрешениями, переподключить расширение или выбрать, какой подключённый браузер использовать. Если при запуске действия браузера подключено более одного браузера, Claude предложит вам выбрать один.
Для VS Code см. автоматизацию браузера в VS Code.
Включение Chrome по умолчанию
Чтобы избежать передачи--chrome в каждом сеансе, выполните /chrome и выберите “Включено по умолчанию”.
В расширении VS Code Chrome доступен всякий раз, когда установлено расширение Chrome. Дополнительный флаг не требуется.
Включение Chrome по умолчанию в CLI увеличивает использование контекста, поскольку инструменты браузера всегда загружены. Если вы заметили увеличение потребления контекста, отключите этот параметр и используйте
--chrome только при необходимости.Управление разрешениями сайта
Разрешения на уровне сайта наследуются из расширения Chrome. Управляйте разрешениями в параметрах расширения Chrome, чтобы контролировать, какие сайты Claude может просматривать, нажимать и вводить текст.Инструменты браузера в режиме плана
В режиме плана вызовы инструментов браузера, которые только читают страницу или состояние браузера, выполняются без запроса разрешения, а вызовы, которые изменяют состояние, запрашивают одобрение.- Вызовы только для чтения:
read_page,get_page_text,find, чтение сообщений консоли или сетевых запросов и создание снимка экрана - Вызовы, изменяющие состояние: клики, ввод текста, навигация, управление вкладками и окнами, а также запись GIF
createIfEmpty на tabs_context_mcp, clear на средствах чтения консоли и сети или save_to_disk на снимке экрана, также запрашивает одобрение. Вызов browser_batch выполняется без запроса только в том случае, если каждое действие внутри него предназначено только для чтения.
Примеры рабочих процессов
Эти примеры показывают распространённые способы объединения действий браузера с задачами кодирования. Выполните/mcp, выберите claude-in-chrome, затем выберите View tools, чтобы увидеть полный список доступных инструментов браузера.
Тестирование локального веб-приложения
При разработке веб-приложения попросите Claude проверить, что ваши изменения работают правильно:Отладка с помощью логов консоли
Claude может читать вывод консоли, чтобы помочь диагностировать проблемы. Скажите Claude, какие шаблоны искать, а не просите весь вывод консоли, так как логи могут быть многословными:Автоматизация заполнения форм
Ускорьте повторяющиеся задачи ввода данных:Создание контента в Google Docs
Используйте Claude для прямого написания в ваших документах без настройки API:Извлечение данных со страниц
Извлекайте структурированную информацию с веб-сайтов:Запуск многосайтовых рабочих процессов
Координируйте задачи на нескольких веб-сайтах:Запись демо-GIF
Создавайте общедоступные записи взаимодействий браузера:Troubleshooting
Расширение не обнаружено
Если Claude Code не может обнаружить расширение Chrome:- Убедитесь, что расширение Chrome установлено и включено в
chrome://extensions - Убедитесь, что Claude Code обновлён, выполнив
claude --version - Проверьте, что Chrome запущен
- Выполните
/chromeи выберите “Reconnect extension”, чтобы переустановить соединение - Если проблема сохраняется, перезагрузите 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
- 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
Браузер не отвечает
Если команды браузера Claude перестают работать:- Проверьте, не блокирует ли модальное диалоговое окно (alert, confirm, prompt) страницу. Диалоговые окна JavaScript блокируют события браузера и препятствуют получению команд Claude. Закройте диалоговое окно вручную, а затем скажите Claude продолжить.
- Попросите Claude создать новую вкладку и повторить попытку
- Перезагрузите расширение Chrome, отключив и повторно включив его в
chrome://extensions
Разрыв соединения во время длительных сеансов
Service worker расширения Chrome может перейти в режим ожидания во время расширенных сеансов, что нарушает соединение. Если инструменты браузера перестают работать после периода неактивности, выполните/chrome и выберите “Reconnect extension”.
Проблемы, специфичные для Windows
На Windows вы можете столкнуться с:- Конфликты именованных каналов (EADDRINUSE): если другой процесс использует тот же именованный канал, перезагрузите Claude Code. Закройте все остальные сеансы Claude Code, которые могут использовать Chrome.
- Ошибки хоста собственного обмена сообщениями: если хост собственного обмена сообщениями падает при запуске, попробуйте переустановить Claude Code, чтобы восстановить конфигурацию хоста.
Распространённые сообщения об ошибках
Это наиболее часто встречающиеся ошибки и способы их решения:See also
- Использование компьютера: управление собственными приложениями macOS, когда задача не может быть выполнена в браузере
- Использование Claude Code в VS Code: автоматизация браузера в расширении VS Code
- Справочник CLI: флаги командной строки, включая
--chrome - Распространённые рабочие процессы: дополнительные способы использования Claude Code
- Данные и конфиденциальность: как Claude Code обрабатывает ваши данные
- Начало работы с Claude in Chrome: полная документация расширения Chrome, включая сочетания клавиш, планирование и разрешения