Claude Code 深度学习手册

主题

在 Chrome 中使用 Claude Code ​

将 Claude Code 连接到 Chrome 浏览器，从命令行测试、调试、自动化网页任务。

是什么 ​

Claude Code 通过 Claude in Chrome 浏览器扩展与 Google Chrome 或 Microsoft Edge 集成，使你能在 CLI 或 VS Code 扩展中获得浏览器自动化能力——构建代码后直接在浏览器里测试和调试，无需切换上下文。该功能目前处于 beta 阶段。

Claude 会为浏览器任务打开新标签页，并共享浏览器的登录状态，因此可以访问任何你已登录的站点。浏览器操作在可见的 Chrome 窗口中实时执行；当 Claude 遇到登录页或 CAPTCHA 时，会暂停并请你手动处理。

怎么工作 ​

  • 用 claude --chrome 启动 Claude Code，或在已有会话中运行 /chrome 启用。
  • 随时运行 /chrome 可查看连接状态、管理权限、重连扩展或选择使用哪个已连接的浏览器；若同时连接多个浏览器，Claude 会在浏览器操作开始时提示你选择。
  • 运行 /chrome 选择 "Enabled by default" 可默认启用，免去每次传 --chrome；VS Code 扩展只要装了 Chrome 扩展即默认可用，无需额外 flag。
  • 站点级权限继承自 Chrome 扩展，在扩展设置中管理 Claude 可浏览、点击、输入的站点。
  • 运行 /mcp 并选择 claude-in-chrome 可查看全部可用的浏览器工具。
  • 首次启用时，Claude Code 会安装一个 native messaging host 配置文件，Chrome 在启动时读取该文件。
  • 典型工作流以自然语言下达，如导航页面、读取控制台错误、填表、抽取数据、录制 GIF 等。

怎么配置 / 用法 ​

启动并连接 Chrome：

bash
claude --chrome

在已有会话内启用 / 管理连接：

text
/chrome

示例任务（自然语言）：

text
Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

什么时候用 ​

  • 实时调试：直接读取控制台错误和 DOM 状态，再修复导致问题的代码。
  • 设计验证：从 Figma 稿构建 UI 后在浏览器中打开，核对是否一致。
  • Web 应用测试：测试表单校验、检查视觉回归、验证用户流程。
  • 操作已登录的 Web 应用（Google Docs、Gmail、Notion 等），无需 API 连接器。
  • 数据抽取与任务自动化：从网页拉取结构化信息保存到本地，或自动化录入、填表、多站点流程。

限制 / 坑 ​

  • 处于 beta，仅支持 Google Chrome 和 Microsoft Edge；尚不支持 Brave、Arc 等其他 Chromium 浏览器，也不支持 WSL。
  • 不通过第三方提供商（Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry）提供；若仅经第三方访问 Claude，需另有 claude.ai 账户。
  • 在 CLI 中默认启用 Chrome 会增加上下文占用，因为浏览器工具始终加载；如占用上升应关闭并改用 --chrome 按需启用。
  • 扩展的 service worker 在长时间会话中可能进入空闲导致连接中断，需运行 /chrome 选择 "Reconnect extension"。
  • 遇到登录页或 CAPTCHA 时会暂停，需用户手动处理；JavaScript 弹窗（alert/confirm/prompt）会阻塞浏览器事件。

硬事实速查（11 条） ​

  • 需要 Claude in Chrome 扩展 version 1.0.36 或更高（Chrome 网上应用店，两种浏览器通用）。
  • 需要 Claude Code version 2.0.73 或更高。
  • 需要直连 Anthropic 套餐：Pro、Max、Team 或 Enterprise。
  • 支持浏览器：Google Chrome、Microsoft Edge；不支持 Brave、Arc、WSL。
  • 启用方式：CLI 用 claude --chrome flag，或会话内 /chrome 命令。
  • /chrome 可查看连接状态、管理权限、重连扩展、选择浏览器、设置默认启用。
  • /mcp 选 claude-in-chrome 查看全部浏览器工具。
  • Claude 共享浏览器登录状态，可访问已登录站点；操作在可见 Chrome 窗口实时进行。
  • 站点权限继承自 Chrome 扩展，在 chrome://extensions 管理与排错。
  • native messaging host 配置文件名 com.anthropic.claude_code_browser_extension.json，位于浏览器各自的 NativeMessagingHosts 目录（macOS/Linux）或注册表 HKCU\Software\...\NativeMessagingHosts\（Windows）。
  • 常见报错："Browser extension is not connected"、"Extension not detected"、"No tab available"、"Receiving end does not exist"，多通过重启或 /chrome 重连解决。

官方出处：https://code.claude.com/docs/en/chrome