设置用于浏览器自动化的 Claude Code Chrome 扩展程序

Claude Code 可以控制您的 Chrome 浏览器。它可以导航页面、点击按钮、填写表单、读取内容、截屏。这对于测试 Web 应用、使用控制台日志进行调试，或在不离开终端的情况下自动化重复的浏览器任务非常有用。

我试过其他的浏览器 MCP（如 Playwright MCP、Puppeteer 等），但 Chrome 扩展程序的明显更快。它连接到您当前的浏览器会话，因此共享您的登录状态。无需启动无头浏览器，也无需单独的身份验证流程。如果您已登录 Gmail、Notion 或您的暂存环境，Claude Code 可以立即与这些页面进行交互。

官方文档详细介绍了所有内容。本文是简短版本。

所需条件

• Google Chrome 或 Microsoft Edge
• 来自 Chrome 网上应用店的 Claude in Chrome 扩展程序 (v1.0.36+)
• Claude Code v2.0.73 或更高版本
• 直接的 Anthropic 订阅（Pro、Max、Teams 或 Enterprise）。此功能不适用于 Bedrock 或 Vertex

设置

从 Chrome 网上应用店安装扩展程序。这是主要步骤。Claude Code 会处理其余的事情。

然后使用 --chrome 标志启动 Claude Code。

claude --chrome

如果您已经在会话中，输入 /chrome 即可连接而无需重新启动。

首次执行此操作时，Claude Code 会安装一个原生消息传递宿主配置文件，Chrome 在启动时会读取该文件。如果第一次尝试时未检测到扩展程序，请重启 Chrome 再试一次。

如果您希望 Chrome 默认启用，这样就无需每次都传递 --chrome 标志，请运行 /chrome 并选择“默认启用”。但有一点需要注意。默认启用它会增加上下文使用量，因为浏览器工具始终处于加载状态。我只在需要时使用该标志。

使用方法

连接后，只需告诉 Claude 在浏览器中执行什么操作即可。它会为浏览器任务打开新标签页，您可以实时观察所有操作的发生。

打开 localhost:3000，尝试使用无效数据提交表单，
并检查错误消息是否正确显示。

它还可以读取控制台输出，这对于调试非常有用。

打开仪表板并在页面加载时检查控制台是否有任何错误。

对于需要 Claude Code 自动运行数小时的自主会话，请将其与 --dangerously-skip-permissions 结合使用，这样浏览器操作就不需要手动批准。

claude --chrome --dangerously-skip-permissions

如果出现问题

在长时间会话中，当 Chrome 扩展程序的 Service Worker 处于空闲状态时，连接可能会中断。运行 /chrome 并选择“重新连接扩展程序”即可修复。

如果页面上弹出 JavaScript 的 alert 或 confirm 对话框，它会阻止所有浏览器事件。Claude Code 无法将其关闭。您必须手动关闭它，然后告诉 Claude 继续。

有关完整的故障排除指南，请查阅官方文档。