Skip to main content

​
Claude in Chrome — 用户操作指南

​
1. 功能简介

Claude in Chrome 让 Claude Code 直接控制你的 Chrome 浏览器。你可以用自然语言让 Claude 帮你：
  • 打开网页、导航、前进后退
  • 填写表单、上传图片
  • 截图、录制 GIF
  • 读取页面内容（DOM、纯文本）
  • 执行 JavaScript
  • 监控网络请求和控制台日志
  • 管理标签页

​
2. 前置条件

​
3. 启用方式

​
Dev 模式

启动后 Claude 会自动检测 Chrome 扩展是否已安装，并注册浏览器控制工具。

​
构建产物

​
禁用

或在 REPL 中通过 /chrome 命令切换启用/禁用状态。

​
通过配置默认启用

在 Claude Code 设置中将 claudeInChromeDefaultEnabled 设为 true，以后启动无需加 --chrome 参数。

​
4. 使用流程

  1. 启动 CLI — 加 --chrome 参数启动 Claude Code
  2. 确认连接 — REPL 中输入 /chrome，查看扩展状态是否显示 “Installed / Connected”
  3. 开始对话 — 正常与 Claude 对话，当需要操作浏览器时直接说，例如：
    • “打开 https://example.com 并截图”
    • “在当前页面搜索关键词 xxx”
    • “填写登录表单，用户名 admin”
    • “帮我录制当前操作的 GIF”
  4. 权限审批 — 首次执行浏览器操作时，Claude 会请求你的确认
  5. 操作完成 — Claude 完成操作后会返回结果（截图、文本、执行结果等）

​
5. 可用操作

​
页面交互

​
页面读取

​
标签页管理

​
监控与调试

​
其他

​
6. 通信模式

Claude in Chrome 支持两种与浏览器通信的方式：

​
本地 Socket（默认）

Chrome 扩展通过 Native Messaging Host 与 CLI 建立 Unix socket 连接。适用于本地开发，无需额外配置。

​
Bridge WebSocket

通过 Anthropic 的 bridge 服务中转，支持远程操控浏览器。需要 claude.ai OAuth 登录。

​
7. 常见问题

​
扩展显示未安装

确认已从 Chrome Web Store 安装 “Claude in Chrome” 扩展，安装后重启浏览器。

​
工具未出现在工具列表

检查启动时是否加了 --chrome 参数，或通过 /chrome 命令确认状态。

​
连接超时

确保 Chrome 浏览器正在运行且扩展已启用。Native Messaging Host 在扩展安装时自动注册，如果重装过扩展需要重启浏览器。

​
不使用 Chrome 功能时

不带 --chrome 参数正常启动即可，不会加载任何浏览器相关模块，不影响其他功能。