它到底是什么

--chrome 是 Claude Code 的 CLI 启动 flag。官方 CLI reference 对它的描述是：启用 Chrome 浏览器集成，用于网页自动化和测试。

它让 Claude Code 通过 Claude in Chrome 浏览器扩展操作你的浏览器：

• 打开新标签页。
• 读取 console 和 DOM 状态。
• 填写表单。
• 提取页面数据。
• 上传文件。
• 录制 GIF。

Claude 共享浏览器的登录态，操作在可见的浏览器窗口中实时进行。遇到登录页或 CAPTCHA 时，它会暂停并请你手动处理。

• 取值：官方文档未写取值类型，示例用法为 claude --chrome。
• 默认值：官方文档未把默认值写成一个固定的"开/关"。不带 flag 时是否启用，取决于你是否在 /chrome 里选择过 "Enabled by default"。
• 配对 flag:--no-chrome 可为单次会话禁用 Chrome 集成。

浏览器支持：

• 官方明确支持 Google Chrome 和 Microsoft Edge。
• 也会检测并配置 Brave、Arc、Vivaldi、Opera 等其他 Chromium 内核浏览器。
• 不支持 WSL。

用法

# 本次会话启用
claude --chrome

# 本次会话禁用
claude --no-chrome

首次带 --chrome 启动时，会弹出一次性对话框介绍该集成以及站点权限的工作方式，按 Enter 继续。

会话内可用 /chrome:

• 查看连接状态。
• 管理权限。
• 重连扩展（"Reconnect extension"）。
• 选择使用哪个已连接的浏览器（"Select browser…"）。

集成正常时，状态面板显示 "Status: Enabled" 和 "Extension: Installed"。

如需免去每次传 flag，在 /chrome 中选择 "Enabled by default"。VS Code 扩展中，只要装了 Chrome 扩展就可用，无需额外 flag。

与其他 flag 的组合 / 互斥

• --no-chrome：与 --chrome 语义相反，用于覆盖"默认启用"的设置。官方文档未说明两者同时传入时的优先级，请避免同时使用。

• --permission-mode：文档中提到 plan 模式下，以下操作会弹出权限提示：

  • 录制 GIF。
  • 打开新标签页。
  • 运行 shortcut。

  例外：如果会话中 bypass permissions 模式可用，且 feature-flag 获取已关闭，这些调用不弹提示。

• auto 模式：auto mode classifier 自己批准了对某站点的浏览器调用时，扩展会跳过该次调用的站点级检查。例外：你的权限规则对 Claude in Chrome 拒绝了任何站点。

• --dangerously-skip-permissions:CLI reference 只把它定义为跳过权限提示。Chrome 文档没有专门写它与 --chrome 的组合行为，请以 permission modes 文档为准。

在 settings.json / env 的等价配置

运行约束 / 限制

经典使用场景

以下均来自官方文档的示例：

• 测试本地 web 应用：打开 localhost:3000，用非法数据提交表单，检查错误提示是否出现。
• 用 console 日志调试：打开页面，检查加载时 console 里的错误。官方建议告诉 Claude 要找哪类模式，而不是要全部日志，因为日志可能很冗长。
• 自动填表：读取本地 contacts.csv，逐行到 CRM 里填写。
• 上传文件：把本地日志文件附加到 bug tracker 的新 issue。
• 操作已登录的应用：Google Docs、Gmail、Notion 等，无需 API connector。
• 提取数据：把页面上的结构化信息存成 CSV。
• 录制演示 GIF：官方提醒录制内容包含浏览器里的一切可见信息（含已登录页面的账号详情），对外分享前请检查。
• 保存截图到磁盘。

常见坑

• 忘了扩展或登录方式不对：用 API key 或长期 token 登录时，--chrome 不会生效（见上表）。v2.1.216 之前这类会话可以启用集成，但每次连接扩展都会以 403 失败。

• 默认启用会增加 context 占用：官方说明，在 CLI 中默认启用 Chrome 会一直加载浏览器工具。如果发现 context 消耗增加，可以关掉该设置，只在需要时用 --chrome。

• 扩展未被检测到：首次启用时，Claude Code 会安装一个 native messaging host 配置文件。Chrome 在启动时读取它，所以首次失败时重启 Chrome。Linux 上 Chrome 的配置文件路径：~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json。

• 长会话连接断开：扩展的 service worker 可能进入 idle 状态。工具失效后，运行 /chrome 并选择 "Reconnect extension"。

• JavaScript 对话框阻塞：alert / confirm / prompt 会阻塞浏览器事件，使 Claude 收不到命令。手动关掉对话框后告诉 Claude 继续。

• 常见错误信息：

  错误	处理
  "Browser extension is not connected"	重启 Chrome 和 Claude Code，再 /chrome 重连。组织使用 IP allowlist 时，也可能因为到 bridge.claudeusercontent.com 的连接被拒
  "No tab available"	让 Claude 新建标签页后重试
  "Receiving end does not exist"	/chrome → "Reconnect extension"

• 组织策略可能关闭安装提示：如果通过 deniedMcpServers 托管设置屏蔽了 claude-in-chrome MCP server，或部署了未放行 Claude in Chrome 的 managed-mcp.json，安装提示不会显示。

• Windows 特有问题：命名管道冲突（EADDRINUSE）时重启 Claude Code，并关闭其他可能占用 Chrome 的会话。

来源

• CLI reference - Claude Code Docs
• Use Claude Code with Chrome - Claude Code Docs