Chrome 右上角的 Claude 图标亮着，扩展也登录了，claude --chrome 启动时一声不吭，可一让它开网页，浏览器工具就回 “Browser extension is not connected”。字面意思是扩展没连上，但 Claude Code 的 Chrome 文档 给这句报错列了好几种原因，没装扩展只是其中最简单的一种。
这里说的是 Anthropic 官方的 Claude in Chrome 扩展，让 Claude Code 去连你平时在用的那个 Chrome，和用 Playwright 之类的第三方 MCP 自己拉起一个浏览器不是一回事，那边的排查思路别往这边套。
最容易漏的是 organization 对不上。如果你在 claude.ai 上属于不止一个组织，扩展登录的组织得和 Claude Code 一致，否则就算两边是同一个账号，也照样报这句。在 Claude Code 里跑 /status，看 Organization 那一行，再去扩展设置里对一下。要换扩展的组织只能先退出再登录，登录时选 /status 显示的那个。文档提醒过，退出扩展会丢掉扩展里存的快捷方式和定时任务，所以先把别的排查做完再动它。
登录方式也会卡住。Chrome 集成要求用 /login 登录，而且得是直接向 Anthropic 订阅的 Pro、Max、Team 或 Enterprise。用 API Key 或者 claude setup-token 生成的长期 token 认证的话，就算传了 --chrome，Claude Code 也会把 Chrome 集成关着，因为扩展没法用这类凭据认证。文档里还写了，v2.1.216 之前这种会话能打开集成，但每次连扩展都是 403。只通过 Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 用 Claude 的，这个功能用不了，得另外有个 claude.ai 账号才行。
扩展要 1.0.36 或更高，去 chrome://extensions 看版本号，顺便确认它是启用状态；CLI 用 claude --version 看是不是最新。然后在会话里跑一下 /chrome，文档说状态面板同时显示 “Status: Enabled” 和 “Extension: Installed” 才算接好了。如果扩展那一栏是 “Not detected”，说明扩展没装或者被禁用，跟登录、组织都没关系，回 chrome://extensions 处理就行。
刚装完就连不上，多半是 Chrome 没重启。第一次开 Chrome 集成时，Claude Code 会写一个 native messaging host 配置文件，Chrome 只在启动时读它，所以装完要把 Chrome 整个重启一次。还不行就看文件在不在：macOS 是 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json，Linux 是 ~/.config/google-chrome/NativeMessagingHosts/ 下同名文件，Windows 查注册表 HKCU\Software\Google\Chrome\NativeMessagingHosts\。Edge 的路径把 Google/Chrome 换成 Microsoft Edge，Linux 下是 ~/.config/microsoft-edge/。另外，连接扩展的那个浏览器标签页只在首次安装时自动弹出，后面换了构建或配置目录导致文件被重写，它不会再弹，别干等。在 WSL 里跑 Claude Code 的就不用折腾了，官方写明不支持。
网络这块，扩展和 CLI 之间走 bridge.claudeusercontent.com 上的 WebSocket bridge，你的网络得能访问这个域名。另一个报错 “No browsers are connected” 也会指到这里。公司账号开了 IP 白名单的情况更隐蔽：Anthropic 会按连接过来的出口地址核对白名单，出口地址不在里面，Claude Code 其他功能都正常，唯独连不上扩展。这个找管理员按 网络配置文档 处理就行。
用久了突然断，跑 /chrome 看 Status，显示 “Not connected” 就选 “Reconnect extension”。v2.1.290 之前这个选项只会打开一个页面，不会真正重连，版本旧的先升级。扩展的 service worker 闲置太久也会断，那时报的是 “Receiving end does not exist”，同样用重连解决。
还有一种情况，有人把 CLAUDE_CODE_ENABLE_CFC=1 写进项目的 .claude/settings.json 或 .claude/settings.local.json，终端提示：
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 连上你的浏览器。想用就自己启动时加 --chrome，或者在 /chrome 里选 Enabled by default（只对之后新开的会话生效），不想看提示就把那行删掉。
支持哪些浏览器，两个官方页说法不一样。Claude Code 文档写的是 Chrome 和 Edge，Brave、Arc 这类 Chromium 浏览器也会尝试连接；而 帮助中心的安装说明 写的是只支持 Google Chrome。用其他浏览器一直连不上的话，可以先换回 Chrome 试试，扩展从 Chrome 应用商店 装。