Claude Code Browser Control: Setup Without the Headache

Claude Code browser control setup, step by step: install the Chrome extension, run claude --chrome, and let AI test pages, read errors and fill forms.

7 min readUpdated 2026-06-12EAEvgeny ArsentyevEvgeny Arsentyev · PhD

Claude Code browser control works through the official Claude in Chrome extension: install it, start Claude with the --chrome flag, and the AI gets a real browser it can navigate, click, and read — in a visible window, right in front of you. I'm Evgeny, and the first time I watched Claude open my page, click my button, and report what broke, I understood why this beta is the most talked-about feature in the toolkit.

What can Claude actually do in your browser?

More than you'd guess, and most of it useful even if you're not a tester. Claude opens new tabs and works in a visible Chrome window in real time: it can test a page you built and check that error messages appear, read console errors (the browser's hidden complaint log) and fix the code that caused them, fill forms from a spreadsheet row by row, draft text directly into Google Docs or Gmail since it shares your login state, extract prices or listings from a page into a tidy file, and even record what it did as a GIF. The pattern is always the same: anything you'd do with a mouse and mild boredom, you can now describe in a sentence.

How to use Claude Code with Chrome: 5-minute setup

From zero to AI-driven browser

  1. 1Install the Claude in Chrome extension from the Chrome Web Store — you need version 1.0.36 or higher. It works in Google Chrome and Microsoft Edge; Brave, Arc and WSL are not supported yet.
  2. 2Check your CLI: claude --version should show 2.0.73 or higher. You also need a direct Anthropic plan — Pro, Max, Team, or Enterprise.
  3. 3Start Claude Code with the browser attached: claude --chrome. Already mid-session? Just type /chrome instead.
  4. 4Give it a browser task in plain language and watch the window do the work.
  5. 5Tired of typing the flag? Run /chrome and pick 'Enabled by default' — with one caveat: browser tools then load into every session and eat context.
The one flag that changes everything
claude --chrome

Run /chrome anytime to check connection status, manage permissions, reconnect the extension, or pick which connected browser to use.

Your first browser errand
you ▸ Go to code.claude.com/docs, click on the search box,
      type "hooks", and tell me what results appear

claude ▸ Opening a new tab… clicking search… typing.
         I see results for hooks: reference, guide, examples.

Is the Claude Chrome extension free?

The extension itself costs nothing — it's a free download from the Chrome Web Store. But it's a plug, not the power: to actually use Claude Code browser control you need a paid direct Anthropic plan (Pro, Max, Team, or Enterprise). One catch from the docs worth knowing: the Chrome integration is not available through third-party providers like Amazon Bedrock or Google Vertex AI — those users need a separate claude.ai account.

Is it safe to let an AI click for you?

Honest answer: mostly yes, with eyes open. Claude shares your browser's login state, which is the superpower and the risk in one sentence — it can access any site you're already signed into. The guardrails: everything happens in a visible window you can watch, Claude pauses and hands control to you when it hits a login page or CAPTCHA, and site-level permissions live in the extension settings, where you control which sites Claude may browse, click, and type on. My rule for students: start on sites where a wrong click costs nothing, and only then graduate to your email.

!Browser, not bank vault

Treat browser control like handing your mouse to a very fast intern. Don't point it at irreversible buttons — payments, deletions, sending — until you've watched it work on harmless pages. The visible window isn't decoration; it's your supervision.

What if it doesn't connect?

Ninety percent of issues end with one of these: check the extension is installed and enabled at chrome://extensions, make sure Chrome is actually running, then run /chrome and choose 'Reconnect extension'. The very first time, Claude Code installs a small config file that Chrome only reads on startup — so if detection fails on attempt one, restart Chrome. If buttons stop responding mid-session, look for a popup dialog blocking the page: those freeze everything until you dismiss them by hand. And after long idle periods the connection can nap — /chrome, 'Reconnect extension', back in business.

Can Claude control your whole computer, not just Chrome?

One more door worth knowing: browser control covers websites, but Claude can also drive native Mac apps through a separate research preview called computer use — enabled via /mcp, macOS only, Pro and Max plans. The docs describe a sensible hierarchy: Claude prefers precise tools first (MCP servers, terminal commands), then the browser, and full screen control only when nothing else reaches the task. Escape key stops it from anywhere.

Lab: three errands for your new intern

0/4

The shift here is bigger than testing: the browser is where half your digital chores live, and now you can delegate them in plain language. Pick one recurring five-minute task — checking a page, copying a table, filling a form — and hand it over today. That's how 'AI assistant' quietly becomes 'AI hands'.

#claude-code#browser#chrome#automation
EAEvgeny Arsentyev

Author

Evgeny Arsentyev

PhD · Chief Product Officer at a healthtech company

▌ Reading is the blue pill

Want to actually build this?

Guides explain. The free course transforms — personalized, gamified, and built to get you shipping fast.

◉ Take the red pill →