Что это такое
Claude Code интегрируется с браузерным расширением Claude в Chrome, добавляя возможности браузерной автоматизации прямо в CLI или в расширение VS Code. Идея простая: собрали код - тут же протестировали и отладили в браузере, не переключаясь между контекстами.
Claude открывает новые вкладки для браузерных задач и использует то же состояние входа, что и ваш браузер, - значит, может работать с любым сайтом, в который вы уже вошли. Действия в браузере выполняются в видимом окне Chrome в реальном времени. Когда Claude натыкается на страницу входа или капчу, он останавливается и просит обработать это вручную.
Интеграция работает в Google Chrome, Microsoft Edge, а также определяется в других браузерах на Chromium - Brave, Arc, Vivaldi, Opera. В Windows Subsystem for Linux (WSL) не поддерживается.
Что умеет
С подключённым Chrome браузерные действия объединяются с задачами разработки в единый рабочий процесс: живая отладка через чтение консоли и состояния DOM, проверка вёрстки по макету из Figma, тестирование форм и пользовательских сценариев, работа с сайтами, куда вы уже вошли - Google Docs, Gmail, Notion - без отдельных API-коннекторов, извлечение структурированных данных со страниц, автоматизация рутинных задач вроде заполнения форм, загрузка файлов со своего компьютера в поля на странице и запись действий в браузере в виде GIF для документации.
Что нужно для установки
Понадобятся: браузер на основе Chromium (Chrome, Edge, Brave, Arc, Vivaldi или Opera), расширение Claude в Chrome версии 1.0.36 или новее из Chrome Web Store, сам Claude Code, и прямой тариф Anthropic - Pro, Max, Team или Enterprise.
Важное ограничение: интеграция требует входа через /login. Если вход выполнен через API-ключ или долгоживущий токен, Claude Code держит интеграцию с Chrome выключенной, даже если передан флаг --chrome, - расширение браузера не может аутентифицироваться такими учётными данными. Через сторонних провайдеров вроде Amazon Bedrock или Google Cloud интеграция тоже недоступна - нужен отдельный аккаунт claude.ai.
Как начать
Claude Code запускается с флагом --chrome:
claude --chromeПри первом запуске появится разовое окно с объяснением, как работают разрешения на сайты, - достаточно нажать Enter. Дальше можно сразу просить Claude воспользоваться браузером:
Зайди на code.claude.com/docs, кликни в поле поиска,
введи «hooks» и расскажи, какие результаты появилисьClaude откроет новую вкладку и начнёт выполнять задачу, при необходимости запрашивая разрешение на конкретное действие. Статус подключения в любой момент проверяется командой /chrome.
Чтобы не передавать флаг каждый раз, в /chrome можно выбрать пункт «Enabled by default» - но стоит иметь в виду, что это увеличивает расход контекста, поскольку браузерные инструменты загружаются постоянно.
Разрешения и режим планирования
Разрешения на уровне сайтов наследуются из настроек самого расширения Chrome - там же управляется, какие сайты Claude может просматривать, на каких кликать и куда вводить текст.
В режиме планирования вызовы браузерных инструментов, которые только читают страницу или состояние браузера, выполняются без запроса на подтверждение: чтение содержимого страницы, поиск элементов, чтение консоли и сетевых запросов, скриншот. Вызовы, которые меняют состояние - клики, ввод текста, навигация, управление вкладками, запись GIF - требуют подтверждения.
Типичные рабочие процессы
Проверка локального приложения. «Только что обновил валидацию формы входа. Открой localhost:3000, попробуй отправить форму с некорректными данными и проверь, появляются ли сообщения об ошибках» - Claude открывает страницу, взаимодействует с формой и сообщает, что увидел.
Отладка через консоль. Полезнее просить искать конкретный паттерн, а не весь вывод целиком - логи бывают объёмными: «открой страницу дашборда и проверь консоль на ошибки при загрузке».
Заполнение форм по данным из файла. Claude читает локальный файл (например, CSV со списком контактов) и для каждой строки заполняет соответствующие поля на веб-странице.
Извлечение данных со страниц. «Зайди на страницу с товарами и вытащи название, цену и наличие по каждой позиции, сохрани результат в CSV» - Claude собирает структурированные данные из содержимого страницы.
Загрузка файлов: три ограничения
Claude может прикрепить файл со своего компьютера к полю загрузки на странице - Claude Code читает файл и передаёт содержимое в браузер, поэтому это работает и в локальных, и в удалённых сессиях. При этом действуют три ограничения: загрузить можно только файл, который сессии разрешено читать - правила разрешений, запрещающие чтение файла, блокируют и его загрузку; суммарный размер одной загрузки - до 10 МБ; и файлы с несколькими жёсткими ссылками (частая ситуация внутри директорий вроде node_modules) Claude отклоняет - такой файл нужно сначала скопировать и загружать уже копию.
Если что-то не работает
Расширение не обнаружено. Проверьте, что оно включено в chrome://extensions, что Claude Code обновлён (claude --version), что Chrome вообще запущен, и попробуйте «Reconnect extension» в /chrome.
Браузер не отвечает. Частая причина - модальное окно (alert, confirm, prompt), которое блокирует события страницы: закройте диалог вручную и попросите Claude продолжить.
Соединение обрывается в долгих сессиях. Service worker расширения может «засыпать» при долгом простое - команда /chrome и пункт «Reconnect extension» восстанавливают связь.
Чек-лист
- Расширение Claude в Chrome установлено, версия 1.0.36+
- Вход выполнен через /login, а не через API-ключ
- Claude Code запущен с флагом --chrome
- Статус подключения проверен командой /chrome
- Разрешения на нужные сайты настроены в самом расширении
- Для загрузки файлов проверен размер (до 10 МБ) и права на чтение