古法编程
站长自营 API 中转

正在比较模型套餐？可以把多个 AI API 接到一个网关里

ZZSwitch 是我自己运营的统一 API 网关，适合需要国内支付、兑换码充值、多模型切换和 OpenAI 兼容接口的开发者。不是 OpenCode 官方服务。

打开 ZZSwitch

Claude Code Chrome 集成：浏览器自动化与调试

Claude Code Chrome 集成让你在 CLI 或 VS Code 中直接控制浏览器，构建代码后立即测试调试，无需切换上下文。Claude 打开新标签页执行任务，共享你的登录状态，可访问你已登录的任何网站。遇到登录页或 CAPTCHA 时自动暂停，等待手动处理。支持 Google Chrome 和 Microsoft Edge，需要 claude.ai 直接订阅（Pro/Max/Team/Enterprise）。

Claude Code 通过 Claude in Chrome 浏览器扩展 获得浏览器自动化能力。你可以在 CLI 或 VS Code 扩展 中直接控制浏览器，完成构建后的测试和调试。

Claude 为浏览器任务打开新标签页，并共享你浏览器的登录状态，因此它可以访问你已登录的任何网站。浏览器操作在可见的 Chrome 窗口中实时运行。当 Claude 遇到登录页或 CAPTCHA 时，会暂停并请你手动处理。

Chrome 集成处于 Beta 阶段，目前仅支持 Google Chrome 和 Microsoft Edge。暂不支持 Brave、Arc 或其他 Chromium 浏览器。WSL（Windows Subsystem for Linux）也不支持。

功能

连接 Chrome 后，你可以将浏览器操作与编码任务整合到单个工作流中：

  • 实时调试：直接读取控制台错误和 DOM 状态，然后修复导致问题的代码
  • 设计验证：根据 Figma 设计稿构建 UI，在浏览器中打开验证是否匹配
  • Web 应用测试：测试表单验证、检查视觉回归、验证用户流程
  • 已认证的应用：操作 Google Docs、Gmail、Notion 或任何你已登录的应用，无需 API 连接器
  • 数据提取：从网页提取结构化信息并保存到本地
  • 任务自动化：自动化重复浏览器任务，如数据录入、表单填写、跨站操作
  • 录制 GIF：录制浏览器操作过程生成 GIF，方便记录或分享

前提条件

使用 Claude Code 与 Chrome 集成前需要：

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

CLI 快速开始

使用 --chrome 标志启动 Claude Code：

claude --chrome

你也可以在已有会话中通过运行 /chrome 启用 Chrome。

以下示例演示如何导航页面、交互并报告结果，全部在终端或编辑器中完成：

访问 code.claude.com/docs，点击搜索框，输入 "hooks"，告诉我出现了哪些结果

随时运行 /chrome 检查连接状态、管理权限或重新连接扩展。

关于 VS Code 的使用，请参考 VS Code 中的浏览器自动化。

默认启用 Chrome

为避免每次会话都传递 --chrome，运行 /chrome 并选择“Enabled by default”。

在 VS Code 扩展 中，只要安装了 Chrome 扩展，Chrome 功能就始终可用，无需额外标志。

在 CLI 中默认启用 Chrome 会增加上下文使用量，因为浏览器工具始终会加载。如果你发现上下文消耗上升，建议关闭此设置，仅在需要时使用 --chrome。

管理站点权限

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

示例工作流

运行 /mcp 并选择 claude-in-chrome 可查看所有可用的浏览器工具。

测试本地 Web 应用

开发 Web 应用时，让 Claude 验证修改是否生效：

我刚刚更新了登录表单验证。你能打开 localhost:3000，
尝试用无效数据提交表单，检查错误提示是否正常显示吗？

Claude 会访问你的本地服务器，与表单交互，并报告观察结果。

用控制台日志调试

Claude 可以读取控制台输出帮助诊断问题。告诉 Claude 你要找的模式，而不是要求获取所有控制台输出（日志可能很多）：

打开 dashboard 页面，检查页面加载时控制台中有没有错误。

Claude 读取控制台消息，可以过滤特定模式或错误类型。

自动填写表单

加速重复数据录入任务：

我有一份联系人列表保存在 contacts.csv 中。对每一行，
访问 crm.example.com，点击“添加联系人”，填写姓名、邮箱和电话。

Claude 读取本地文件，浏览 Web 界面，为每条记录输入数据。

在 Google Docs 中起草内容

Claude 可直接在你的文档中书写，无需配置 API：

根据最近的 commits 起草一份项目更新报告，添加到我的 Google Doc：
docs.google.com/document/d/abc123

Claude 打开文档，点击编辑器，输入内容。此方式适用于你登录的任何 Web 应用：Gmail、Notion、Sheets 等。

从网页提取数据

从网站提取结构化信息：

访问产品列表页面，提取每个商品的名称、价格和库存状态，
保存为 CSV 文件。

Claude 导航到页面，读取内容，整理成结构化数据。

执行跨站工作流

协调多个网站间的任务：

查看我的日历，找出明天的会议。对每个有外部参与者的会议，
查询他们的公司网站，添加一条关于他们业务的备注。

Claude 在多个标签页间操作，收集信息完成工作流。

录制演示 GIF

创建浏览器操作的可分享录制：

录制一个 GIF，展示从加购到确认页面的完整结账流程。

Claude 录制操作序列，保存为 GIF 文件。

故障排查

未检测到扩展

如果 Claude Code 显示“Chrome extension not detected”：

  1. 在 chrome://extensions 确认扩展已安装并启用
  2. 运行 claude --version 确认版本
  3. 确认 Chrome 正在运行
  4. 运行 /chrome 选择“Reconnect extension”重新建立连接
  5. 如果问题持续，重启 Claude Code 和 Chrome

首次启用 Chrome 集成时，Claude Code 会安装原生消息主机配置文件。Chrome 在启动时读取此文件，因此首次检测失败时，重启 Chrome 即可加载新配置。

验证主机配置文件路径：

Chrome：

  • macOS：~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Linux：~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Windows：检查注册表 HKCU\Software\Google\Chrome\NativeMessagingHosts\

Edge：

  • macOS：~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Linux：~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Windows：检查注册表 HKCU\Software\Microsoft\Edge\NativeMessagingHosts\

浏览器不响应

如果 Claude 的浏览器命令停止工作：

  1. 检查是否有模态对话框（alert、confirm、prompt）阻塞页面。JavaScript 对话框会阻塞浏览器事件，导致 Claude 无法接收命令。手动关闭对话框，然后告诉 Claude 继续。
  2. 让 Claude 新建标签页重试
  3. 在 chrome://extensions 中禁用并重新启用扩展

长时间会话连接断开

Chrome 扩展的 service worker 在长时间不活动后可能进入闲置状态，导致连接断开。如果浏览器工具在长时间无操作后停止响应，运行 /chrome 并选择“Reconnect extension”。

Windows 特定问题

在 Windows 上可能遇到：

  • 命名管道冲突（EADDRINUSE）：如果其他进程正在使用同一命名管道，重启 Claude Code。关闭其他可能正在使用 Chrome 的 Claude Code 会话。
  • 原生消息主机错误：如果原生消息主机启动时崩溃，重新安装 Claude Code 以重新生成主机配置。

常见错误消息

错误 原因 解决方法
“Browser extension is not connected” 原生消息主机无法连接扩展 重启 Chrome 和 Claude Code，然后运行 /chrome 重新连接
“Extension not detected” Chrome 扩展未安装或已禁用 在 chrome://extensions 安装或启用扩展
“No tab available” Claude 在标签页准备前尝试操作 让 Claude 新建标签页重试
“Receiving end does not exist” 扩展 service worker 进入闲置状态 运行 /chrome 并选择“Reconnect extension”

相关文档

常见问题

Claude Code Chrome 集成支持哪些浏览器？

目前支持 Google Chrome 和 Microsoft Edge。暂不支持 Brave、Arc 或其他 Chromium 浏览器，也不支持 WSL（Windows Subsystem for Linux）。

扩展检测不到怎么解决？

首先确认扩展已安装并启用（在 chrome://extensions 中检查），然后运行 claude --version 确保版本 >= 2.0.73。运行 /chrome 选择“Reconnect extension”。如果还是检测不到，重启 Chrome 和 Claude Code。首次使用时可能需要重启 Chrome 以加载原生消息主机配置。

长时间会话后连接断开怎么办？

Chrome 扩展的 service worker 可能进入闲置状态。运行 /chrome 选择“Reconnect extension”即可重新连接。如果问题频繁出现，可考虑默认启用 Chrome（运行 /chrome 选择“Enabled by default”），但注意这会增加上下文消耗。

站长自营 API 中转

ZZSwitch API 中转

统一接入多家模型，支持兑换码充值。

打开 ZZSwitch