SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Claude Code з Chrome: налаштування і типові помилки

Як підключити Claude Code до Chrome: який план і вхід потрібні, чому API-ключ вимикає браузер, як виправити «Extension not detected» і чи працює це з VPS.

Коротко: що вміє Claude Code у Chrome

Claude Code з Chrome відкриває ваш вебзастосунок у справжньому браузері. Він натискає кнопки, заповнює форми і читає помилки з консолі. Для цього потрібні дві речі. Перша: розширення Claude in Chrome версії 1.0.36 або новішої. Друга: вхід у Claude Code через /login з прямим планом Anthropic. Сесію з браузером запускає команда claude --chrome, а стан підключення показує команда /chrome.

Типовий сценарій такий. Ви вже платите за Claude і пишете вебзастосунок. Ви хочете, щоб агент сам відкрив форму на localhost:3000, ввів неправильні дані та перевірив повідомлення про помилки. Усі вимоги й повідомлення нижче звірено з документацією Claude Code та довідковим центром Anthropic 13 листопада 2026 року. Остання версія Claude Code у журналі змін на цю дату: 2.1.323 від 12 листопада 2026 року. Розширення в Chrome Web Store мало версію 1.0.107, тож 1.0.36 означає лише мінімальну версію.

Які вимоги до Claude Code і Chrome перевірити спершу

Сторонні інструкції часто пропускають частину вимог, і читач потім довго шукає помилку, якої немає. Офіційна сторінка інтеграції називає такі умови:

  • Розширення Claude in Chrome версії 1.0.36 або новішої з Chrome Web Store.
  • Встановлений Claude Code.
  • Прямий план Anthropic: Pro, Max, Ultra, Team або Enterprise. Безкоштовного плану Free у цьому списку немає.
  • Вхід у Claude Code через /login.
  • Браузер Google Chrome або Microsoft Edge.
  • Не WSL (Windows Subsystem for Linux, підсистема Linux у Windows). Там інтеграція не підтримується.
  • Не сторонній провайдер. Через Amazon Bedrock, Google Cloud's Agent Platform або Microsoft Foundry ця функція недоступна.

Якщо ви користуєтеся Claude лише через Bedrock чи іншого хмарного провайдера, документація прямо каже: для браузера потрібен окремий обліковий запис claude.ai. Як працює сам Claude Code через хмарних провайдерів, описано в розборі Claude Code через Bedrock або Vertex. Якщо ви ще вибираєте підписку, порівняйте, який план Claude вам справді потрібен. Про ціни є окремий текст скільки коштує Claude Code у різних країнах.

Чому API-ключ вимикає браузерні інструменти

Це найчастіша пастка. Якщо Claude Code автентифікується API-ключем або довгостроковим токеном з claude setup-token, він тримає інтеграцію з Chrome вимкненою. Так буде навіть тоді, коли ви передаєте --chrome. Причина проста: розширення не може пройти автентифікацію з такими обліковими даними. Йому потрібна саме сесія підписки, яку створює /login.

Звідси висновок, який документація окремо не формулює, але який з неї випливає. Якщо ви платите через ключ Console, OpenRouter або посередника, браузерних інструментів у вас не буде. У вас немає сесії /login з підпискою, тож розширенню нема з чим з'єднатися.

Є ще одна тонкість. Якщо в середовищі є змінна ANTHROPIC_API_KEY і ви колись погодилися її використовувати, вона має пріоритет над підпискою з /login. Запустіть claude і введіть у сесії /status: ця команда показує, які облікові дані активні зараз. Якщо /status показує API-ключ, приберіть змінну з поточної оболонки і запустіть сесію знову:

unset ANTHROPIC_API_KEY
claude --chrome

Після цього Claude Code використовує підписку. Якщо змінна задана у ~/.bashrc чи іншому файлі запуску оболонки, приберіть її і там. Інакше вона повернеться в новому терміналі.

Які браузери підтримуються

Сторінка Claude Code називає підтримуваною парою Google Chrome і Microsoft Edge. Вона також каже, що Claude Code знаходить розширення і налаштовує з'єднання в інших браузерах на Chromium, серед них Brave, Arc, Vivaldi та Opera. Проте довідкова стаття самого розширення і його сторінка в Chrome Web Store кажуть інше: інші браузери на Chromium не підтримуються. Тому для роботи беріть Chrome або Edge. Brave чи Opera можуть з'єднатися, але розширення їх офіційно не підтримує.

Як запустити Claude Code з Chrome

Встановіть розширення Claude in Chrome і увійдіть у ньому в той самий обліковий запис claude.ai, що й у Claude Code. Потім перевірте версію CLI і запустіть сесію з браузером:

claude --version
claude --chrome

Під час першого запуску Claude Code показує одноразове вікно. Воно пояснює інтеграцію і те, як працюють дозволи на сайти. Натисніть Enter, щоб продовжити. Тоді введіть у сесії:

/chrome

Інтеграція працює, коли панель стану показує Status: Enabled і Extension: Installed. Якщо розширення не знайдено, найчастіше досить перезапустити Chrome. Під час першого ввімкнення Claude Code встановлює файл конфігурації native messaging host. Це локальний посередник, через який браузер запускає зовнішню програму. Chrome читає цей файл лише під час старту, тому браузер, відкритий до встановлення, нового файлу не бачить. Починаючи з версії 2.1.323, повідомлення під час налаштування радить перезапустити сесію командою claude --chrome. Раніше воно помилково казало, що з'єднання завершить /chrome.

Щоб вимкнути браузер для однієї сесії, запустіть claude --no-chrome.

Що робить /chrome і чому «Enabled by default» коштує контексту

Команда /chrome перевіряє стан з'єднання, керує дозволами, перепідключає розширення і дає вибрати браузер. Якщо підключено кілька браузерів, Claude Code попросить вибрати один. Змінити вибір пізніше можна через пункт Select browser…. Claude залишиться з вашим вибором, навіть коли під'єднається інший браузер.

У тій самій панелі є пункт Enabled by default. Він підключає Chrome у кожній сесії без прапорця --chrome. Ціна цього режиму: браузерні інструменти та інструкції до них завжди завантажені в контекст. Отже, кожна розмова витрачає більше контексту ще до першого запиту. Якщо контекст закінчується швидше, ніж раніше, вимкніть цей пункт і підключайте браузер лише тоді, коли він потрібен. У терміналі це прапорець --chrome, у VS Code це слово @browser у полі запиту. Як стежити за заповненням контексту, пояснює розбір керування контекстом у Claude Code.

Цей перемикач зберігається як claudeInChromeDefaultEnabled у глобальній конфігурації ~/.claude.json, а не в settings.json. CLI і розширення VS Code використовують одне й те саме значення. Зверніть увагу на вікно під час запуску з текстом Claude in Chrome extension detected. Відповідь «Yes, use my browser» вмикає саме цей режим за замовчуванням. Відповідь «No, keep browser tools off» або клавіша Esc вимикає його.

Є і змінна середовища CLAUDE_CODE_ENABLE_CFC. Значення 1 запускає сесію CLI з Chrome, значення 0 запускає без нього. Змінна має пріоритет над claudeInChromeDefaultEnabled. Прапорці --chrome і --no-chrome мають пріоритет над обома.

Дозволи на сайти: що Claude питає перед дією

Дозволи на рівні сайтів Claude Code бере з розширення. Список сайтів, де Claude може переглядати сторінки, натискати і вводити текст, ви налаштовуєте в параметрах розширення Claude in Chrome, а не в Claude Code.

Перед дією в браузері Claude Code може попросити дозвіл. Вікно починається з тексту Claude in Chrome wants to і пропонує дозволити всі дії на цьому сайті до кінця сесії. Коли Claude доходить до сторінки входу або CAPTCHA, він зупиняється і просить вас виконати цей крок самостійно.

У режимі auto все трохи інакше. Якщо класифікатор схвалив виклик браузерного інструмента, Claude Code пропускає перевірку сайту в розширенні. Виняток один: ваші правила дозволів забороняють Claude in Chrome хоча б один сайт. Детальніше про цей режим у розборі режим auto і дозволи в Claude Code.

Вкладки, які відкриває Claude, розширення збирає в групу вкладок Chrome, прив'язану до вашої сесії. Команда /clear у локальній сесії закриває цю групу разом з відкритими сторінками. Група залишається, лише якщо в ній ще працює завдання, яке має пережити очищення.

Як перевірити форму на localhost:3000

Документація наводить саме такий робочий процес. Запустіть сервер розробки, потім у сесії claude --chrome напишіть звичайною мовою, що перевірити. Українською це може виглядати так:

Я щойно змінив валідацію форми входу. Відкрий localhost:3000,
спробуй надіслати форму з неправильними даними і перевір,
чи правильно з'являються повідомлення про помилки.

Claude відкриє нову вкладку, заповнить поля і скаже, які повідомлення побачив. Для консолі документація дає одну важливу пораду: кажіть, які саме записи шукати, а не просіть увесь вивід. Журнали бувають великими, і повний вивід швидко витрачає контекст. Наприклад, попросіть знайти помилки TypeError або невдалі запити до /api/login після надсилання форми.

Якщо застосунок показує блокувальне вікно JavaScript (alert, confirm або prompt), браузерні команди зупиняються, доки вікно відкрите. Закрийте його вручну і попросіть Claude продовжити.

Claude може записати свої дії у GIF. Запис містить усе, що видно в браузері, зокрема дані облікового запису на сторінках, де ви увійшли. Перегляньте файл, перш ніж показувати його комусь поза командою.

Чому Claude Code не бачить розширення Chrome

Офіційний порядок дій для стану «Not detected» у /chrome такий:

  1. Відкрийте chrome://extensions і переконайтеся, що розширення Claude встановлене й увімкнене.
  2. Виконайте claude --version, щоб перевірити, що Claude Code оновлено до актуальної версії.
  3. Переконайтеся, що Chrome запущений.
  4. Виконайте /chrome і виберіть Reconnect extension.
  5. Перезапустіть Chrome і Claude Code.

Якщо це не допомогло, перевірте, чи існує файл native messaging host. На Linux для Chrome:

ls -l ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json

Для Edge на Linux шлях такий: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json. На macOS файл лежить у ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/ для Chrome і в ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/ для Edge. На Windows документація радить дивитися не файл, а реєстр: ключ HKCU\Software\Google\Chrome\NativeMessagingHosts\ для Chrome або HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ для Edge. Якщо файла немає, інтеграцію на цій машині, найімовірніше, ще не вмикали. Запустіть claude --chrome, а потім перезапустіть браузер.

Повідомлення про помилки і що вони означають

  • Browser extension is not connected. Документація називає три причини. Розширення не встановлене або не працює. Розширення увійшло в інший обліковий запис чи іншу організацію, ніж Claude Code. Список дозволених IP-адрес вашої організації відхиляє з'єднання з bridge.claudeusercontent.com. Виправлення: перезапустіть Chrome і Claude Code, потім виконайте /chrome, щоб перепідключитися.
  • No browsers are connected. Chrome не відкритий з розширенням, яке увійшло в той самий обліковий запис і ту саму організацію. Або Claude Code не може дістатися до bridge.claudeusercontent.com.
  • Receiving end does not exist. Service worker розширення (його фоновий процес) заснув. Виконайте /chrome і виберіть Reconnect extension. До версії 2.1.290 цей пункт лише відкривав сторінку перепідключення і не перезапускав зламане з'єднання, тому оновіть старіший Claude Code.
  • No tab available. Попросіть Claude створити нову вкладку.

Розширення і CLI в різних організаціях

Якщо ви належите до кількох організацій claude.ai, розширення мусить увійти в ту саму організацію, що й Claude Code. Якщо вони різні, браузерні інструменти повертають Browser extension is not connected. Так буде навіть тоді, коли обидва використовують один обліковий запис. Виконайте /status у Claude Code і прочитайте рядок Organization. Щоб виправити, вийдіть з облікового запису в налаштуваннях розширення, увійдіть знову і виберіть організацію, яку показує /status.

Документація попереджає: після виходу з розширення ви втрачаєте збережені в ньому ярлики та заплановані завдання. Тому спершу спробуйте інші виправлення зі списку вище.

Корпоративний проксі та список дозволених IP

Документація про мережеві вимоги називає bridge.claudeusercontent.com мостом WebSocket для розширення Claude in Chrome. Anthropic перевіряє з'єднання з цим вузлом за списком дозволених IP-адрес організації. Перевіряється адреса, з якої з'єднання приходить. Якщо ваш проксі виводить трафік до цього вузла через адресу, якої немає у списку, Claude Code не з'єднається з розширенням. Решта Claude Code при цьому працює нормально. Попросіть адміністратора додати цю адресу до списку або пустити цей вузол через дозволений вихід.

Чи може Claude Code на VPS керувати Chrome на ноутбуці?

Це відкрите питання, і ми його не тестували. Ми перечитали сторінку інтеграції з Chrome, мережеві вимоги, сторінку Remote Control і довідник CLI. Жодна з них не каже, чи може сесія Claude Code на VPS, запущена через SSH, керувати Chrome на вашому ноутбуці. Документація не дає відповіді ні «так», ні «ні».

Що документація встановлює точно:

  • Налаштування спирається на файл native messaging host. Перевіряти його документація радить у локальному каталозі браузера або в реєстрі Windows, тобто на машині, де працює Chrome.
  • Розширення спілкується з Claude Code через міст WebSocket на bridge.claudeusercontent.com.
  • Remote Control працює у зворотному напрямку. Прапорець --chrome для claude remote-control (з версії 2.1.273) існує, щоб Claude використовував Chrome на вашій машині, поки ви працюєте з іншого пристрою.

Тож якщо вам потрібен саме ваш Chrome, документований шлях такий. Запускайте Claude Code на тому комп'ютері, де відкритий браузер, командою claude remote-control --chrome, а керуйте сесією з телефона чи іншого пристрою. Якщо ваша основна робота вже живе на сервері, як у схемі Claude Code на VPS у tmux, браузер краще тримати на тому самому сервері.

Браузер на самому VPS: headless і Chrome DevTools MCP

На сервері немає екрана, тож браузер там працює в режимі headless (без вікна). Як встановити такий браузер і навіщо він агентам, пояснює розбір headless-браузер для агентів на VPS. Під'єднати його до Claude Code можна через MCP (Model Context Protocol, протокол для підключення зовнішніх інструментів до моделі). Один з варіантів: сервер Chrome DevTools MCP від команди Chrome.

README проєкту вимагає Node.js у версії LTS і поточний стабільний Chrome. Офіційно підтримуються лише Google Chrome і Chrome for Testing. Пакет у npm на 13 листопада 2026 року має версію 1.13.0 і вимагає Node.js ^20.19.0 || ^22.12.0 || >=23. README запускає сервер як chrome-devtools-mcp@latest. Але @latest завантажує нову версію під час кожного запуску, тож поведінка може змінитися без попередження. Закріпіть конкретну версію:

node --version
claude mcp add --scope user --transport stdio chrome-devtools -- npx -y chrome-devtools-mcp@1.13.0 --headless --isolated --no-usage-statistics
claude mcp list

Подвійне тире -- тут обов'язкове. Усе після нього Claude Code передає серверу без змін. Без нього Claude Code спробує прочитати --headless як власний параметр. Прапорець --headless запускає Chrome без інтерфейсу, за замовчуванням він вимкнений. --isolated створює тимчасовий каталог профілю, який видаляється після закриття браузера. Тому входи на сайти не зберігаються між запусками. --no-usage-statistics вимикає збирання статистики використання, яке за замовчуванням увімкнене.

claude mcp list має показати ✔ Connected поруч із chrome-devtools. Стан ✘ Failed to connect означає, що Claude Code не зміг з'єднатися з цим сервером. У сесії відкрийте /mcp. Там видно кількість інструментів кожного сервера, а для зламаного сервера є рядок Issue: з причиною збою. Про інші MCP-сервери на сервері читайте в огляді MCP-сервери на VPS.

Для Claude Code інструкція проєкту пропонує ще один шлях: плагін, який ставить MCP-сервер разом з навичками.

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
/plugin install chrome-devtools-mcp@chrome-devtools-plugins

Після встановлення перезапустіть Claude Code. Якщо раніше ви вже додали сервер вручну, спершу видаліть його, як радить інструкція проєкту. Плагіни детальніше розібрано в тексті як працюють плагіни Claude Code.

README попереджає: сервер відкриває вміст браузера клієнтам MCP, і вони можуть переглядати та змінювати будь-які дані в ньому. Інструменти продуктивності можуть надсилати URL трас до Google CrUX API. Це вимикає прапорець --no-performance-crux.

Модель загроз: що Claude бачить у вашому браузері

Claude відкриває нові вкладки і використовує стан входу вашого браузера. Отже, він має доступ до будь-якого сайту, де ви вже увійшли в цьому профілі Chrome: пошта, GitHub, панель хостингу, банк. Це прямо написано в документації.

Друга загроза менш очевидна. Текст на сторінці для моделі є ще одним каналом інструкцій. Стаття Anthropic «Use Claude in Chrome safely» називає ризик prompt injection (впровадження інструкцій): шкідливі вказівки, приховані у вмісті сторінки, можуть обманути Claude. Розширення має класифікатори безпеки, які автоматично шукають такі атаки. Проте Anthropic пише, що ризик не нульовий. Як цей клас атак працює проти агентів для коду, пояснює розбір prompt injection в агентах для коду.

Практичні кроки з тієї ж статті Anthropic:

  • Створіть окремий профіль Chrome для роботи агента, без входу в чутливі облікові записи: банк, медичні сервіси, державні портали.
  • Пам'ятайте, що на знімки екрана потрапляє все, що видно у вкладках, з якими працює Claude.
  • Якщо хочете переглядати кожну дію, перемкніть розширення в режим «Manually approve».
  • Перед доступом до фінансових сайтів Claude питає дозволу. Читайте такий запит, а не погоджуйтеся автоматично.

Чому репозиторій не може ввімкнути браузер

Файли .claude/settings.json і .claude/settings.local.json лежать у каталозі проєкту. Якщо в них є CLAUDE_CODE_ENABLE_CFC=1, Claude Code ігнорує це значення і показує попередження:

Claude Code ignored CLAUDE_CODE_ENABLE_CFC in this project's settings: a project can't turn on Claude in Chrome. To turn it on yourself, run /chrome or start with --chrome.

Документація пояснює причину: репозиторій, який ви клонували, не повинен мати змоги під'єднати Claude до вашого браузера. Ось що це означає на практиці. Без цього обмеження чужий репозиторій з GitHub міг би одним рядком у налаштуваннях дати агентові ваш браузер з усіма активними входами. А сторінки, які агент відкриє далі, могли б містити інструкції для нього. Тому ввімкнути Chrome можете лише ви самі: прапорцем claude --chrome або пунктом Enabled by default у /chrome.

FAQ

Чому claude --chrome не вмикає браузер, хоча план оплачено?

Найчастіше Claude Code автентифікований API-ключем або токеном з claude setup-token, а не через /login. З такими обліковими даними Claude Code тримає інтеграцію з Chrome вимкненою навіть з прапорцем --chrome, бо розширення не може з ними автентифікуватися. Виконайте /status, щоб побачити активні облікові дані. Якщо це ANTHROPIC_API_KEY, виконайте unset ANTHROPIC_API_KEY, увійдіть через /login і запустіть claude --chrome знову.

Що означає «Extension not detected» одразу після встановлення?

Під час першого ввімкнення Claude Code створює файл native messaging host com.anthropic.claude_code_browser_extension.json. Chrome читає його лише під час запуску, тож браузер, відкритий раніше, розширення не бачить. Повністю закрийте і знову відкрийте Chrome, потім виконайте /chrome. Панель має показати Status: Enabled і Extension: Installed.

Чи працює Claude Code з Chrome через Bedrock, OpenRouter або у WSL?

Через Amazon Bedrock, Google Cloud's Agent Platform і Microsoft Foundry інтеграція недоступна, для неї потрібен окремий обліковий запис claude.ai. У WSL вона не підтримується. OpenRouter і посередників документація не згадує, але вони дають API-ключ, а з API-ключем браузерні інструменти вимкнені. Потрібен прямий план Pro, Max, Ultra, Team або Enterprise і вхід через /login.

Чи можна ввімкнути Chrome для всієї команди через налаштування репозиторію?

Ні. Claude Code ігнорує CLAUDE_CODE_ENABLE_CFC=1 у файлах проєкту .claude/settings.json і .claude/settings.local.json та показує попередження. Так задумано: клонований репозиторій не повинен під'єднувати Claude до вашого браузера з усіма вашими входами. Кожен розробник вмикає інтеграцію сам, через claude --chrome або пункт Enabled by default у /chrome.

Чи була ця стаття корисною?

#claude-code#chrome#browser-automation#mcp#troubleshooting