教程

Claude Code Chrome 扩展(Beta):浏览器自动化、UI 调试与 Web 测试实战指南

Claude Code Chrome 扩展(Beta)完整指南:七大浏览器自动化能力(实时调试/设计验证/Web 测试/已登录 App 交互/数据提取/任务自动化/GIF 录制)、前置要求(Chrome/Edge 仅,不支持 Bedrock/Vertex/Foundry 用户)、--chrome 启动和 /chrome 命令、七个实战工作流(本地 App 测试/控制台调试/表单自动化/Google Docs 写入/数据提取/多站点/GIF 录制),以及常见问题排查表。

2026/3/55分钟 阅读ClaudeEagle

Claude Code 通过「Claude in Chrome」浏览器扩展获得浏览器自动化能力,让你在 CLI 中直接控制浏览器,构建代码后立即在浏览器中测试和调试,无需切换上下文。

核心能力

Chrome 集成后,可以将浏览器操作与编码任务串联在单个工作流中:

能力说明
实时调试直接读取控制台错误和 DOM 状态,然后修复引发问题的代码
设计验证从 Figma 稿构建 UI,在浏览器中验证是否与设计稿吻合
Web 应用测试测试表单验证、检查视觉回归、验证用户流程
已认证 Web 应用与 Google Docs、Gmail、Notion 等已登录应用交互,无需 API 连接器
数据提取从网页提取结构化信息并本地保存
任务自动化自动化数据录入、表单填写、多站点工作流等重复性操作
会话录制将浏览器操作录制为 GIF,用于记录或分享

Claude 会在可见的 Chrome 窗口中实时执行浏览器操作。遇到登录页面或 CAPTCHA 时,Claude 会暂停并请你手动处理。

前置要求

  • 浏览器:Google Chrome 或 Microsoft Edge(不支持 Brave、Arc 等其他基于 Chromium 的浏览器;不支持 WSL)
  • 扩展Claude in Chrome 扩展 v1.0.36 或更高版本
  • Claude Code:v2.0.73 或更高版本
  • 订阅:直接 Anthropic 计划(Pro、Max、Teams 或 Enterprise)

⚠️ Chrome 集成不支持通过 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 访问 Claude 的用户。如果你只通过第三方提供商访问,需要单独的 claude.ai 账号才能使用此功能。

快速上手

启用 Chrome 集成

bash
# 方式一:启动时带 --chrome flag
claude --chrome

# 方式二:在现有会话中启用
/chrome

设为默认启用

/chrome → 选择「Enabled by default」

注意:默认启用 Chrome 会增加 Context 用量(浏览器工具始终加载)。如果发现 Context 消耗明显增加,建议关闭默认启用,只在需要时带 --chrome 启动。

管理站点权限

站点级权限继承自 Chrome 扩展设置。在扩展设置中管理哪些站点 Claude 可以浏览、点击和输入。

查看所有可用浏览器工具

/mcp → 选择 claude-in-chrome

实战工作流示例

1. 测试本地 Web 应用

> I just updated the login form validation. > Open localhost:3000, try submitting the form with invalid data, > and check if the error messages appear correctly.

Claude 导航到本地服务器,与表单交互,报告观察结果。

2. 读取控制台日志调试

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

Claude 读取控制台消息,可以筛选特定模式或错误类型。

建议告诉 Claude 要找什么模式,而不是请求所有控制台输出(日志可能很冗长)。

3. 自动化表单填写

> I have a spreadsheet of customer contacts in contacts.csv. > For each row, go to crm.example.com, click "Add Contact", > and fill in the name, email, and phone fields.

Claude 读取本地文件,导航 Web 界面,逐行录入数据。

4. 在 Google Docs 中起草内容

> Open my project brief at docs.google.com/document/d/xxx > and add a new section called "Implementation Plan" > based on the outline in @project-outline.md

无需 Google API,Claude 直接在你已登录的 Docs 中写入。

5. 从网页提取数据

> Go to the pricing page at competitor.com/pricing > and extract all plan names, prices, and features into > a structured JSON file at ./research/competitor-pricing.json

6. 多站点工作流

> Check our GitHub Issues for bugs labeled 'critical', > then search our internal Jira for related tickets, > and create a consolidated report in reports/critical-bugs.md

7. 录制操作 GIF

> Record a GIF of me signing up on localhost:3000, > filling out the form and completing registration. > Save it as demo/signup-flow.gif

与 VS Code 集成

VS Code 扩展中也支持 Chrome 集成,安装了 Chrome 扩展后无需额外 Flag,参见 VS Code 浏览器自动化文档

故障排查

问题解决方案
扩展未被检测到确认 Chrome 扩展已启用,运行 /chrome 查看连接状态
浏览器无响应关闭其他 Chrome 标签页/扩展减少干扰,重启 Chrome 后重试
长会话中连接断开运行 /chrome 重新连接;避免让浏览器长时间空闲
Windows 特定问题确保使用原生 Windows Chrome/Edge,不要在 WSL 内运行

常见错误信息

  • Extension not found:重新安装扩展,确保版本 ≥ 1.0.36
  • Connection refused:确保 Claude Code 版本 ≥ 2.0.73
  • Permission denied for site:在扩展设置中允许目标域名

原文:Use Claude Code with Chrome (beta) | 来源:Anthropic 官方文档

相关文章推荐

教程Claude Code MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18教程Claude Code 权限管理完全指南:精确控制 AI 能执行哪些操作Claude Code 权限系统完整解析:四种权限模式(default/acceptEdits/bypassPermissions/plan)、--allowedTools 和 --disallowedTools 精确工具控制、Bash 命令白名单语法(通配符匹配)、settings.json 持久化权限配置、CLAUDE.md 中的权限规则声明、CI/CD 自动化场景的权限配置、以及如何在效率和安全之间找到平衡点。2026/3/18教程Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18教程Claude Code .claudeignore 完全指南:精准控制 AI 读取文件的范围Claude Code .claudeignore 文件完整使用指南:语法规则(与 .gitignore 完全一致)、为什么需要排除文件(隐私/性能/干扰)、推荐排除的文件类型(node_modules/secrets/.env/构建产物)、按项目类型的最佳实践配置(Node.js/Python/Go/单体仓库)、.claudeignore 与 .gitignore 的区别,以及如何验证排除规则是否生效。2026/3/18