教程

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教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8教程Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。2026/5/8教程Claude Code Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8