Switch in two steps
1
Run setup
predev to Claude Code and every other coding agent on your Mac, and connects to Chrome. The first time, turn on remote debugging at chrome://inspect/#remote-debugging when it asks, then click Allow when Chrome asks Allow remote debugging?. You need macOS, Google Chrome, and Node.js 22 or later.2
Turn Claude in Chrome off in Claude Code
In Claude Code, run
/chrome and turn off Enabled by default. If you start Claude Code with claude --chrome, drop the flag. To turn it off for one session, start with claude --no-chrome.Restart Claude Code and try:Or let Claude Code do it. Paste this into Claude Code:
In the pre.dev CLI
Install the pre.dev CLI:/chrome. It uses your CLI login, so there is nothing else to sign in to. If the CLI was already installed when you ran setup, it has the Chrome tools already.
Keep both
If you keep Claude in Chrome on, tell your agent which one to use. Add a line like this to yourCLAUDE.md, or AGENTS.md for other agents:
Skip the permission prompts
Claude Code asks before it runs a tool from an MCP server unless you allow it. To let every pre.dev tool run without asking, addmcp__predev to the allow list in ~/.claude/settings.json:
chrome_eval, which runs JavaScript in your pages, and the cloud tools, which use credits. Read Safety first.
Tool by tool
Claude in Chrome works in the tabs of its own tab group. The pre.dev tools work in any tab of any Chrome profile, and a snapshot names the profile each tab belongs to.
Two tools have no Claude in Chrome counterpart:
chrome_show brings a tab to the front so you can watch or take over, and chrome_wait with a plain-words condition waits until a statement about the page is true.
What else changes
- Chrome asks once per start. Chrome shows Allow remote debugging? once each time it starts, and again after an update. Click Allow.
- Plain-words actions use credits.
chrome_actandchrome_waitconditions use your pre.dev account; every other Chrome tool runs on your computer and is free. See Credits. - It works in every agent. Codex, Cursor, Hermes, Pi, and the other agents setup finds get the same tools. See Browser Agents Local for every agent and for agents without MCP.
- macOS is tested. Linux and Windows are not tested yet. See Platform support.

