Claude Code 操作 Chrome 浏览器

这篇适合谁、读完能做到什么

如果你在写前端或 Web 应用，想让 Claude Code 直接在浏览器里验证页面、读控制台报错，或者替你填一批表单，这篇适合你。读完你能连上 Chrome 扩展，会分辨站点权限的几种设置，也知道连接失败时该按什么顺序排查。^[1]

Chrome 集成是什么，能做什么

Claude Code 与 Claude in Chrome 浏览器扩展配合，你可以在命令行或 VS Code 扩展里直接做浏览器自动化。Claude 会为浏览器任务打开新标签页，并共用你浏览器的登录状态，所以它能访问你已经登录的任何网站。浏览器操作在一个可见的 Chrome 窗口里实时进行。^[1]

遇到登录页面或验证码时，Claude 会暂停，请你自己处理。^[1]

它能做的事包括：读取控制台报错和 DOM 状态后直接改代码，测试表单校验和用户流程，在 Google Docs、Gmail、Notion 这类已登录的应用里工作，提取网页数据，自动化重复性操作，上传文件，以及把浏览器操作录成 GIF。^[1]

准备

需要四样东西：Google Chrome 或 Microsoft Edge（Brave、Arc、Vivaldi、Opera 等 Chromium 内核浏览器也行），版本 1.0.36 或更高的 Claude in Chrome 扩展（从 Chrome 应用商店安装），Claude Code，以及直接购买的 Anthropic 套餐（Pro、Max、Ultra、Team 或 Enterprise）。^[1]

有两个限制要先知道。一是必须用 /login 登录。如果你用的是 API key 或 claude setup-token 生成的长期令牌，即使加了 --chrome，Chrome 集成也保持关闭。^[1] 二是 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 这类第三方云平台不支持这个功能。^[1] WSL 也不支持。^[1] 这些条件最好在开始前逐条确认，免得装完才发现用不了。下面的操作都假设你已经满足以上条件。

第一次运行

用 --chrome 参数启动 Claude Code：

claude --chrome

第一次带 Chrome 参数启动时，会出现一次性的对话框，介绍集成并说明站点权限怎么工作。这个对话框只出现这一次，按回车继续即可。^[1]

然后直接用自然语言提需求。例如：

Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

如果弹出了权限确认，它会以 Claude in Chrome wants to 开头，并提供为该会话允许这个站点全部操作的选项。批准后，Claude 会打开新标签页开始任务。^[1]

运行 /chrome 可以查看连接状态、管理权限、重新连接扩展或选择浏览器。状态面板显示「Status: Enabled」和「Extension: Installed」时，说明集成已经正常工作。^[1] 如果同时连着多个浏览器，Claude 会让你选一个；之后想换，运行 /chrome 并选择「Select browser…」。^[1]

标签页怎么管理

Claude 打开的标签页会被收进一个和本次会话绑定的 Chrome 标签页组。输入 /clear 时，这个标签页组连同里面打开的页面会被关闭，除非还有没完成的工作在运行。用 /resume 切换会话、退出 Claude Code，或者在有工作还在运行时执行 /clear，标签页组只有在里面只剩空白新标签页时才会被关闭，这样你可能还在看的页面会保留下来。^[1]

隐私和登录状态

Claude 共用你浏览器的登录状态，所以它能访问你已经登录的任何网站。它在一个可见的 Chrome 窗口里实时操作，遇到登录页或验证码时会停下来交给你。录制 GIF 会拍下浏览器里可见的全部内容，包括已登录页面上的账户信息。^[1]

扩展和 Claude Code 登录的如果不是同一个组织，即使是同一个账户，浏览器工具也会返回连接失败。^[1]

站点权限

站点级别的权限继承自 Chrome 扩展的设置。Claude 能在哪些站点上浏览、点击和输入，要在扩展的设置里管。^[1]

如果在交互会话中 Claude Code 没有检测到扩展，它会弹出标题为「Claude wants to use your browser」的安装提示。每个会话最多弹一次，选项有「Install extension」「Not now」和「Don't ask again」。^[1]

要是不想每次都加 --chrome，可以在 /chrome 里打开「Enabled by default」。CLI 和 VS Code 共用这个设置。不过要注意，默认开启会增加上下文用量，因为浏览器工具和说明会一直被加载。^[1]

在计划模式下，Claude 录 GIF 或打开新标签页之前，会先弹出权限确认。^[1]

几个常用场景

读控制台报错。 日志可能很长，所以要告诉 Claude 你要找什么样的信息。例如：

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

上传文件。 Claude 可以把你电脑上的文件附到网页的上传框里。一次上传的文件总计最多 10 MB。它会拒绝有多个硬链接的文件，也会拒绝 .env、.pem、.key 以及 .ssh 下的文件这类凭据文件。如果权限规则禁止了对某个文件的 Read，它也就没法上传。^[1]

录 GIF。 录制会拍下浏览器里可见的全部内容，包括已登录页面上的账户信息，所以分享到团队之外之前要先检查。^[1]

连不上时怎么办

排查顺序是从易到难排列的：先确认扩展存在且启用，再确认 Claude Code 是最新版和 Chrome 在运行，然后才是重连和重启。这样能先排除最常见的原因，少走弯路。

按顺序排查：先在 chrome://extensions 里确认扩展已安装并启用，用 claude --version 确认 Claude Code 是最新版，确认 Chrome 正在运行。然后运行 /chrome 并选择「Reconnect extension」。还不行，就重启 Claude Code 和 Chrome。^[1]

macOS 上，Chrome 的原生消息主机配置文件位于 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json。^[1]

项目里的设置文件不能开启 Chrome 集成。如果你的项目设置里写了 CLAUDE_CODE_ENABLE_CFC，Claude Code 会忽略它，并给出这样的警告：

Claude Code ignored CLAUDE_CODE_ENABLE_CFC in this project's settings: a project can't turn on Claude in Chrome. To turn it on yourself, run /chrome or start with --chrome.

要开启的话，可以运行 /chrome，或者用 --chrome 启动。^[1]

其他常见问题还有：

浏览器没反应。 网页上的 alert、confirm 或 prompt 对话框会阻塞浏览器事件，Claude 收不到命令。手动关掉对话框，再告诉 Claude 继续。^[1]
长会话后断开。 扩展的 service worker 在长时间运行后可能进入空闲，导致连接断开。运行 /chrome 并选择「Reconnect extension」即可。^[1]
提示 Browser extension is not connected。 可能是扩展没有安装或没有运行，也可能是扩展和 Claude Code 登录的不是同一个组织。运行 /status，看 Organization 那一行，再到扩展里核对。^[1]