Claude Code 提示浏览器扩展未连接时，在报错的同一个终端会话运行 /chrome。没有检测到扩展，先查浏览器配置。状态是 Not connected，先选择 Reconnect extension。如果浏览器工具仍报未连接，再比较 CLI 与扩展使用的账号和组织。
一位 r/ClaudeCode 用户能在 Desktop 中使用扩展，CLI 却一直失败。重新登录 CLI 并重启 Chrome 和 CLI 后，他的连接恢复了。侧栏可用只能说明侧栏自己的会话正常。 Reddit 原帖。
如果目标只是读取获准网页，文末也说明了如何改用单独的浏览器工具。
先记住这五条
分开看
/chrome中的Status和Extension。账号邮箱相同，还要核对组织是否相同。
首次启用后重启浏览器。已连过的会话断开时用 Reconnect extension。
用已知公开页做只读验证，记录 URL、标题和正文里的可见标记。
只有目标网站打不开时，查站点登录和权限。受管网络下持续报连接错误时，再请 IT 查出口。
定位失败阶段
在当前 CLI 会话运行 /chrome。官方说明中，可用状态显示 Status: Enabled 和 Extension: Installed。没有检测到扩展时，查浏览器和配置。状态显示 Not connected 时，当前会话的桥接已断。导航后的站点权限提示或登录页属于更晚的阶段。记录选中的浏览器及版本。
| 错误信号 | 检查方向 |
|---|---|
| Extension not detected | 配置和安装状态 |
| Not connected | 当前会话连接 |
| Browser extension is not connected | 账号、组织或出口 |
Not logged in | 先在 Claude Code 登录符合条件的直订账号 |
| 已打开网页但提示授权 | 核对该站点的权限或登录状态 |
核对账号与组织
该集成需要符合要求的 Claude 直订方案，并在 Claude Code 交互式 /login。API Key、setup token 或第三方供应商都不能启用官方扩展。比较 /status 中的组织与扩展当前组织。同一账号可以加入多个组织。退出扩展前请注意，Anthropic 说明退出会丢失扩展保存的快捷指令和计划任务。
用 /status 看 Claude Code 当前组织，再在扩展的账号菜单确认所选组织。如果个人空间和工作空间使用同一邮箱，要比较空间名称。组织方案要求所有者启用 Claude in Chrome 时，请先确认开关。扩展组织正确、只有 CLI 出错时，优先重新认证 CLI。 官方连接要求。
站点的登录状态还取决于浏览器配置。可以参考如何让 Agent 使用已打开的标签页，以及如何判断哪个浏览器配置已经登录仪表盘。
分别检查浏览器和网络
在支持的浏览器里打开并启用目标配置中的官方扩展。Claude Code 文档列有 Chrome、Edge，以及其他几款可检测到扩展的 Chromium 浏览器。WSL 不支持此集成。账号、组织一致但没有浏览器连上时，请 IT 核对已批准的出口是否能访问 bridge.claudeusercontent.com，且满足组织 IP 白名单。连上后只有一个站点不可用，转查站点权限。
核对实际使用的窗口
打开目标配置的扩展管理页，确认官方扩展已启用。个人配置装过扩展，工作配置仍可能没有安装或受策略限制。如果 /chrome 提供浏览器选择，选中正确项并保留对应窗口。首次启用后完整退出并重启浏览器，让它读取原生消息配置。 官方安装和浏览器选择。
另一位 r/ClaudeAI 用户确认扩展已启用，也重启了浏览器，依旧报未连接。安装检查通过后应继续排查账号、会话和网络。 Reddit 原帖。
把出口问题交给 IT
请 IT 核对浏览器和 CLI 使用的获准出口以及组织 IP 白名单。能访问普通网站，只说明该网站的连接正常。保留组织策略和代理设置。报障时提供错误原文、出现时间和时区、浏览器及扩展版本、Claude Code 版本和 /chrome 状态，省略凭据和私人浏览记录。
重连后用最小只读任务验证
在 /chrome 选择 Reconnect extension，再检查状态。Anthropic 说明从 Claude Code 2.1.290 开始，该操作会重启会话连接。更早版本只会打开重连页，依赖此步骤时先更新。用选中的浏览器打开已知的公开或本地测试页，报告准确 URL、页面标题和一个可见标记。保持只读，核对工具回执。
旧会话仍没有浏览器工具时，用 claude --chrome 新开会话。按浏览器 Agent 首次任务检查表选一个结果可预知的公开页。若改用独立工具，agent-browser 会话教程说明了如何隔离命名会话。
使用浏览器工具打开 https://example.com。
返回最终 URL、页面标题和正文中可见的主标题。
以浏览器工具结果为准，全程只读，不要提交或修改内容。该页主标题应为 Example Domain。能打开页面却收到授权提示时，看 Claude Code 站点权限说明。如果跳到登录页，确认浏览器配置，按站点要求自行登录。
根据测试结果选择下一步
| 结果 | 下一步 |
|---|---|
| URL、标题和可见主标题一致 | 保留当前会话和浏览器配置，再处理目标站点 |
| 公开页可读，只有目标站点失败 | 检查站点权限、跳转和登录 |
| 账号、配置、重连都查过，仍报未连接 | 向 IT 或 Anthropic 支持提交版本、报错和测试结果 |
| 工作流允许更换浏览器工具 | 明确选用另一工具，重新验证会话和权限 |
什么时候可以换浏览器工具
工作流依赖 Claude in Chrome 时，继续按 Anthropic 路径排查。如果目标只是打开获准网页并读取内容，可以参考 Tabbit Browser 与 Claude Code 的接入说明。配置好后，把同一条只读提示词交给 Tabbit 的浏览器工具，检查它使用的会话。这个方案需要单独配置浏览器及站点登录。
应用内集成还可以比较 Claude Agent SDK 的浏览器工具和通过 API 或 MCP 直接访问数据。选择取决于任务是否需要现有的浏览器会话。
常见问题
Claude 账号相同就能连接吗？
还要检查组织。Claude Code 与扩展必须选择同一组织，即使两边的登录邮箱一样。
为什么 /chrome 检测不到扩展？
检查目标浏览器配置是否已安装并启用官方扩展，保持相应窗口打开。首次启用集成后重启浏览器，加载原生消息配置。
公司网络会导致未连接吗？
会。请 IT 核对获准出口是否能访问 bridge.claudeusercontent.com，以及出口 IP 是否符合 Claude 组织白名单。
Reconnect extension 会做什么？
从 Claude Code 2.1.290 开始，它会重启当前会话中失败的连接。较早版本只会打开重连页，浏览器工具仍不可用时先更新。
为什么 Claude 侧栏能用，CLI 却连不上？
侧栏有自己的会话。请在报错的 CLI 中运行 /chrome，再比对账号、组织和浏览器。
怎样确认 Claude Code 能读网页？
让浏览器工具返回已知公开页的最终 URL、标题和可见主标题。三项都一致后，再单独检查目标网站权限。