它到底是什么

/chrome 是 Claude Code 的会话内 Slash 命令，也是对应启动标志 --chrome 的运行时控制面板。它通过 Chrome 浏览器的原生消息（Native Messaging）机制，将 Claude Code 的代码能力与浏览器自动化能力连接起来。该功能目前处于 beta 阶段。

前置要求（缺一不可）：

怎么触发 / 怎么使用

1. 启动时带标志进入会话

claude --chrome

Claude Code 启动后即加载浏览器工具集，后续自然语言任务可直接涉及浏览器操作。

2. 在已有会话中随时触发

/chrome

进入交互菜单，可执行：

• 查看当前连接状态
• 在多个已连接浏览器之间切换
• 重连扩展（Reconnect extension）
• 开启/关闭"默认启用"（Enabled by default）

3. 让 Claude 实际操作浏览器（自然语言任务示例）

Go to localhost:3000, try submitting the login form with invalid data,
and check if the error messages appear correctly.

Open the dashboard page and check the console for any errors when
the page loads.

Record a GIF showing the checkout flow from add-to-cart to confirmation.

保存 / 配置 / 集成

设为默认开启

在会话中运行 /chrome，选择 "Enabled by default"，后续每次启动 Claude Code 无需再传 --chrome。

注意：默认开启后，浏览器工具始终加载进上下文窗口，会增加每次会话的 token 消耗。如发现上下文压力增大，可取消该选项，改为按需使用 --chrome。

站点权限

站点级权限继承自 Chrome 扩展的设置页面。打开扩展设置可控制 Claude 能在哪些网站上执行点击、输入等操作。

原生消息宿主配置文件路径

首次启用时，Claude Code 会自动写入以下配置文件；Chrome/Edge 在启动时读取它以发现原生消息宿主：

Chrome：

• macOS：~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux：~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows：注册表 HKCU\Software\Google\Chrome\NativeMessagingHosts\

Edge：

• macOS：~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux：~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows：注册表 HKCU\Software\Microsoft\Edge\NativeMessagingHosts\

查看完整可用浏览器工具列表：运行 /mcp，选择 claude-in-chrome。

VS Code 集成

在 VS Code 扩展中，只要安装了 Claude in Chrome 扩展即自动可用，无需 --chrome 标志。

运行约束 / 限制

跟同类原语对比

Computer Use 的控制粒度按应用类别分层（官方 /en/computer-use）：浏览器与交易平台为 view-only，终端与 IDE 为 click-only，其余应用为 full control。

经典使用场景

• 本地 Web 应用调试：代码改完后立即让 Claude 在 localhost 上验证表单校验、视觉回归、用户流程，无需手动切换浏览器
• 读取 Console 错误：直接让 Claude 打开页面并过滤 Console 中的错误信息，省去截图或手工粘贴
• 已登录应用自动化：操作 Google Docs、Gmail、Notion 等无公开 API 或接入成本高的 SaaS 工具
• 批量表单填写：读取本地 CSV，逐行向 CRM / 内部系统填入数据
• 生成演示 GIF：录制完整操作流程并保存为 GIF，用于文档或 PR 演示

常见坑

1. 首次启用后扩展未被检测到：Claude Code 在首次连接时写入原生消息宿主配置文件，但 Chrome 在启动时才读取此文件——需要重启 Chrome 才能生效，不是重启 Claude Code。

2. 长时间不操作后连接中断：扩展的 Service Worker 会在闲置后进入休眠，导致浏览器工具失效。运行 /chrome → 选择 "Reconnect extension" 可恢复连接。

3. JavaScript 对话框（alert / confirm / prompt）阻塞所有后续命令：JavaScript 模态对话框会阻止浏览器事件，导致 Claude 无法接收命令(官方原文 "JavaScript dialogs block browser events and prevent Claude from receiving commands")。需手动关闭对话框,再告知 Claude 继续。

4. Windows 命名管道冲突（EADDRINUSE）：同时运行多个 Claude Code 会话时可能争抢同一命名管道。关闭其他 Claude Code 会话并重启即可解决。

常见错误速查

来源

• Use Claude Code with Chrome (beta) — code.claude.com
• Commands — code.claude.com