# Claude Code 加了 --chrome 还是报 Browser extension is not connected，扩展明明装着 **URL:** \ **Category:** 问题求助\ **Tags:** Chrome, Claude, AICoding, 问与答\ **Created:** [2026 年10 月 27 日 08:53 UTC](https://www.shiqidu.com/t/topic/1812 "2026-10-27T08:53:00Z")\ **Posts on this page:** 1\ **Page:** 1
作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\ 发布日期： [2026 年10 月 27 日 08:53 UTC](https://www.shiqidu.com/t/topic/1812/1 "2026-10-27T08:53:00Z")
Chrome 右上角的 Claude 图标亮着，扩展也登录了，`claude --chrome` 启动时一声不吭，可一让它开网页，浏览器工具就回 “Browser extension is not connected”。字面意思是扩展没连上，但 Claude Code 的 [Chrome 文档](https://code.claude.com/docs/en/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 其他功能都正常，唯独连不上扩展。这个找管理员按 [网络配置文档](https://code.claude.com/docs/en/network-config) 处理就行。 用久了突然断，跑 `/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`，终端提示： ```plaintext 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 浏览器也会尝试连接；而 [帮助中心的安装说明](https://support.claude.com/en/articles/12012173-get-started-with-claude-in-chrome) 写的是只支持 Google Chrome。用其他浏览器一直连不上的话，可以先换回 Chrome 试试，扩展从 [Chrome 应用商店](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 装。