Интеграция с Chrome находится в бета-версии и в настоящее время работает только с Google Chrome. Она еще не поддерживается на Brave, Arc или других браузерах на основе Chromium. WSL (Windows Subsystem for Linux) также не поддерживается.
Возможности
С подключенным Chrome вы можете объединять действия браузера с задачами кодирования в единый рабочий процесс:- Живая отладка: читайте ошибки консоли и состояние DOM напрямую, а затем исправьте код, который их вызвал
- Проверка дизайна: создайте пользовательский интерфейс на основе макета Figma, а затем откройте его в браузере, чтобы проверить соответствие
- Тестирование веб-приложений: тестируйте валидацию форм, проверяйте визуальные регрессии или проверяйте потоки пользователей
- Аутентифицированные веб-приложения: взаимодействуйте с Google Docs, Gmail, Notion или любым приложением, в которое вы вошли, без коннекторов API
- Извлечение данных: извлекайте структурированную информацию со страниц и сохраняйте её локально
- Автоматизация задач: автоматизируйте повторяющиеся задачи браузера, такие как ввод данных, заполнение форм или многосайтовые рабочие процессы
- Запись сеанса: записывайте взаимодействия браузера в виде GIF-файлов для документирования или обмена информацией о том, что произошло
Предварительные требования
Перед использованием Claude Code с Chrome вам необходимо:- Браузер Google Chrome
- Расширение Claude in Chrome версии 1.0.36 или выше
- Claude Code версии 2.0.73 или выше
- Прямой план Anthropic (Pro, Max, Team или Enterprise)
Интеграция с Chrome недоступна через сторонних поставщиков, таких как Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через стороннего поставщика, вам нужна отдельная учетная запись claude.ai для использования этой функции.
Начало работы в CLI
Запустите Claude Code с Chrome
Запустите Claude Code с флагом Вы также можете включить Chrome в существующем сеансе, выполнив
--chrome:/chrome./chrome в любое время, чтобы проверить статус подключения, управлять разрешениями или переподключить расширение.
Для VS Code см. автоматизацию браузера в VS Code.
Включение Chrome по умолчанию
Чтобы избежать передачи--chrome в каждом сеансе, выполните /chrome и выберите “Enabled by default”.
В расширении VS Code Chrome доступен всякий раз, когда установлено расширение Chrome. Дополнительный флаг не требуется.
Включение Chrome по умолчанию в CLI увеличивает использование контекста, поскольку инструменты браузера всегда загружены. Если вы заметили увеличение потребления контекста, отключите этот параметр и используйте
--chrome только при необходимости.Управление разрешениями сайта
Разрешения на уровне сайта наследуются из расширения Chrome. Управляйте разрешениями в параметрах расширения Chrome, чтобы контролировать, какие сайты Claude может просматривать, нажимать и вводить текст.Примеры рабочих процессов
Эти примеры показывают распространённые способы объединения действий браузера с задачами кодирования. Выполните/mcp и выберите claude-in-chrome, чтобы увидеть полный список доступных инструментов браузера.
Тестирование локального веб-приложения
При разработке веб-приложения попросите Claude проверить, что ваши изменения работают правильно:Отладка с помощью логов консоли
Claude может читать вывод консоли, чтобы помочь диагностировать проблемы. Скажите Claude, какие шаблоны искать, а не просите весь вывод консоли, так как логи могут быть многословными:Автоматизация заполнения форм
Ускорьте повторяющиеся задачи ввода данных:Создание контента в Google Docs
Используйте Claude для прямого написания в ваших документах без настройки API:Извлечение данных со страниц
Извлекайте структурированную информацию с веб-сайтов:Запуск многосайтовых рабочих процессов
Координируйте задачи на нескольких веб-сайтах:Запись демо-GIF
Создавайте общедоступные записи взаимодействий браузера:Troubleshooting
Расширение не обнаружено
Если Claude Code показывает “Chrome extension not detected”:- Убедитесь, что расширение 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
Браузер не отвечает
Если команды браузера 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, чтобы восстановить конфигурацию хоста.
Распространённые сообщения об ошибках
Это наиболее часто встречающиеся ошибки и способы их решения:| Ошибка | Причина | Решение |
|---|---|---|
| ”Browser extension is not connected” | Хост собственного обмена сообщениями не может достичь расширение | Перезагрузите Chrome и Claude Code, затем выполните /chrome для переподключения |
| ”Extension not detected” | Расширение Chrome не установлено или отключено | Установите или включите расширение в chrome://extensions |
| ”No tab available” | Claude попытался действовать до того, как вкладка была готова | Попросите Claude создать новую вкладку и повторить попытку |
| ”Receiving end does not exist” | Service worker расширения перешёл в режим ожидания | Выполните /chrome и выберите “Reconnect extension” |
See also
- Использование Claude Code в VS Code: автоматизация браузера в расширении VS Code
- Справочник CLI: флаги командной строки, включая
--chrome - Распространённые рабочие процессы: дополнительные способы использования Claude Code
- Данные и конфиденциальность: как Claude Code обрабатывает ваши данные
- Начало работы с Claude in Chrome: полная документация расширения Chrome, включая сочетания клавиш, планирование и разрешения