Что это такое

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. Расширение Claude в Chrome установлено, версия 1.0.36+
  2. Вход выполнен через /login, а не через API-ключ
  3. Claude Code запущен с флагом --chrome
  4. Статус подключения проверен командой /chrome
  5. Разрешения на нужные сайты настроены в самом расширении
  6. Для загрузки файлов проверен размер (до 10 МБ) и права на чтение
Нужна ли платная подписка для Claude в Chrome?
Да, интеграция требует прямой тариф Anthropic - Pro, Max, Team или Enterprise, и вход через /login. Через API-ключ или сторонних провайдеров вроде Amazon Bedrock интеграция не работает.
Видно ли, что делает Claude в браузере?
Да, все действия выполняются в видимом окне Chrome в реальном времени - это не скрытая автоматизация в фоне, а браузер, который открывается и работает у вас на глазах.
Что происходит, если Claude встречает капчу или страницу входа?
Claude останавливается и просит обработать это вручную - за него капчу или логин никто не решает.
Можно ли использовать не Google Chrome, а другой браузер?
Да, интеграция работает с Microsoft Edge и определяется в других браузерах на движке Chromium - Brave, Arc, Vivaldi, Opera. В WSL (Windows Subsystem for Linux) интеграция не поддерживается.
Увеличивает ли включённый по умолчанию Chrome расход токенов?
Да, если включить Chrome по умолчанию в CLI, браузерные инструменты загружаются в контекст постоянно, что увеличивает его расход. Если это заметно, стоит вернуться к запуску через флаг --chrome только когда он реально нужен.
Может ли Claude загрузить любой файл со своего компьютера на сайт?
Нет, только файл, который сессии разрешено читать по правилам разрешений, размером до 10 МБ суммарно за одну загрузку, и без нескольких жёстких ссылок - такие файлы (частые внутри node_modules) нужно сначала скопировать.
← Все статьи блога