教程

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 + Chrome 浏览器集成:从终端直接操控浏览器的完整指南Claude Code Chrome 集成详解:从终端直接操控浏览器,实现实时调试、表单填写、数据提取、GIF 录制等功能。含前置条件、配置方法和 7 个实战示例。2026/4/7教程MCP Server 2026 实战教程:五个值得优先安装的 Server 完整配置指南MCP Server 2026完整配置教程:详解Filesystem/Memory/GitHub/Playwright/Fetch五个值得优先安装的Server,附全局与项目级配置组织方式、验证与故障排查思路、远端MCP Server新特性(SSE)、安全考量清单,是Claude Code扩展工具能力的实战起点。2026/8/25教程Claude Code Hooks 6 大生产级实战场景:从一次 rm -rf 事故说起Claude Code Hooks完整实战指南:从rm -rf误删配置文件真实事故切入,详解PreToolUse/PostToolUse等6大生命周期事件,附危险命令拦截、敏感文件保护、自动Lint、上下文注入、异步审计、HTTP合规对接完整脚本,含退出码等关键踩坑点。2026/8/25教程Claude Code Week 34:/design 技能上线,可编辑 UI 画板、Concise 输出风格、手机一键启动会话Claude Code 2026年8月17-21日(Week 34)更新详解:全新/design技能带来可编辑UI画板工作流(研究预览)、Concise内置输出风格直给结果跳过过程叙述、Remote Control正式版支持手机一键启动本机会话,附完整使用方法与实战建议。2026/8/23教程Claude Code v2.1.239:修复 Bedrock 代理下静默双倍计费漏洞,/claude-api upgrade 一键迁移 SDK详解Claude Code v2.1.239更新:修复Bedrock流式传输代理剥离Content-Type头导致静默双倍计费的重要问题、数据驻留工作区成本估算加入1.1倍溢价、新增/claude-api upgrade一键迁移Python SDK到1.x、云端插件同步区分来源、Alpine musl原生插件加载修复。2026/8/22教程Claude Code v2.1.238:Remote Control 连接韧性大幅提升,新增 readline 风格快捷键详解Claude Code v2.1.238更新:新增keybindingFlavor readline快捷键风格、插件市场headersHelper动态认证头、自托管Runner缓冲关闭与代理认证增强、Remote Control网络断连/登录过期/进程崩溃后自动恢复等一揽子稳定性修复、长会话内存无限增长问题修复。2026/8/21