Chrome 与 Computer Use
Claude in Chrome、浏览器自动化、macOS computer-use、权限、安全边界、缓存和 Passion8 使用限制。
Claude Code 有两类“看见并操作界面”的能力:
| 能力 | 操作对象 | 适合 |
|---|---|---|
| Chrome integration | Chrome 或 Edge 浏览器标签页 | Web app 测试、表单、console、已登录网页 |
| Computer use | macOS 桌面应用 | 原生 app、模拟器、GUI-only 工具、视觉问题 |
两者都比 shell/MCP 更宽泛,也更慢、更敏感。优先顺序应该是:结构化 API 或 MCP,然后 shell,然后浏览器,最后才是 computer use。
#Chrome integration
Chrome integration 通过 Claude in Chrome 扩展把浏览器能力接到 Claude Code。Claude 可以打开新 tab、读取页面、点击、输入、查看 console、截图和录制交互。
启用方式:
claude --chrome会话内也可以运行:
/chrome常见用途:
| 用途 | 例子 |
|---|---|
| 本地 Web app 测试 | 打开 localhost:3000,提交表单,确认错误提示 |
| Console debug | 读取加载时的 error、warning、network failure |
| 设计核对 | 按设计稿检查布局、间距、响应式 |
| 登录态网页 | 操作你已经在 Chrome 登录的 Gmail、Notion、Docs |
| 数据提取 | 从网页读取结构化信息并保存 CSV |
| 录制 demo | 录制一个操作流程 GIF |
#Chrome 要求和限制
| 项目 | 要求 |
|---|---|
| 浏览器 | Google Chrome 或 Microsoft Edge |
| 扩展 | Claude in Chrome 扩展 |
| CLI | 新版 Claude Code |
| 账号 | 直接 Anthropic plan,通常是 Pro、Max、Team 或 Enterprise |
| 不支持 | Brave、Arc、WSL、第三方 provider-only 使用方式 |
在 plan mode 下,只读浏览器操作通常不需要确认;点击、输入、导航、创建 tab、保存截图等改变状态的操作会要求审批。
#Computer use
Computer use 是内置 MCP server,让 Claude 在 macOS 上打开 app、点击、输入、看屏幕。它适合处理浏览器工具够不到的 GUI:
| 任务 | 例子 |
|---|---|
| 原生应用验证 | 编译 Swift app,启动并点击每个 tab |
| Electron/onboarding 测试 | 打开 app,走完整流程,截图错误 |
| 视觉 bug 复现 | 缩小窗口直到 modal 裁切,再回到 CSS 修复 |
| 模拟器 | 控制 iOS Simulator 走 onboarding |
| GUI-only 工具 | 硬件面板、设计软件、内部桌面工具 |
启用步骤:
- 在交互式会话运行
/mcp。 - 找到
computer-use并启用。 - 第一次使用时授权 macOS Accessibility 和 Screen Recording。
- 每个会话第一次控制某个 app 时,按提示允许该 app。
Computer use 操作的是真实桌面,不是 Bash sandbox。Terminal、IDE、Finder、System Settings 这类 app 有更高风险,确认任务必要再授权。
#安全边界
| 机制 | 作用 |
|---|---|
| 每 app 审批 | Claude 只能控制你本会话批准的 app |
| 高风险 app 警告 | 终端、IDE、Finder、系统设置会额外提示 |
| 终端不进截图 | Claude 不会把自己的终端输出当成屏幕内容再读回去 |
Esc 全局停止 | 任何时候按 Esc 终止当前 computer-use 动作 |
| 单会话锁 | 同一台机器一次只允许一个 Claude session 控制屏幕 |
浏览器和交易类 app 通常会受到更严格的控制层级限制。凡是涉及付款、删除、发消息、提交表单的动作,都应该让 Claude 先说明计划再执行。
#Passion8 使用限制
Chrome integration 和 computer use 是 Claude Code 的官方账号能力,不是普通模型网关能力。
| 场景 | 结果 |
|---|---|
只配置 Passion8 ANTHROPIC_BASE_URL 和 token | 不应期待 Chrome/computer-use 自动可用 |
| 同时有 claude.ai 登录 | 可能能启用官方界面工具,但模型请求路由要按当前会话配置确认 |
| 本地 Web UI 验证 | 可以改用 Playwright、browser MCP 或手动浏览器截图 |
| 企业禁用浏览器/屏幕工具 | 本地设置无法绕过组织策略 |
如果只是验证当前 docs 站手机端,优先用 Playwright/Chrome DevTools 或手机直接访问局域网地址。不要为了普通响应式检查启用 computer use。
#缓存和上下文影响
| 动作 | 影响 |
|---|---|
启动时 --chrome | 会加载浏览器工具定义,与普通会话的 system prompt 不完全相同 |
| 浏览器截图、DOM、console | 工具结果进入历史,增加后续上下文 |
| 录屏或大量日志 | 容易撑大上下文,要让 Claude 过滤错误关键词 |
| Computer use 截图 | 图片会转成模型输入,成本比纯文本高 |
| 切回纯 shell 工作 | 不会自动删除已经进入历史的浏览器观察结果 |
长任务里建议只在需要验证时启用浏览器工具,观察完用简短结论保留在历史,不要把整页 DOM 和全部 console 都塞进会话。
#排错
| 问题 | 处理 |
|---|---|
| Chrome extension not connected | 检查扩展启用,重启 Chrome,运行 /chrome 重新连接 |
| Browser not responding | 看是否有 alert/confirm/prompt 阻塞,手动关闭后继续 |
| Receiving end does not exist | 扩展 service worker 休眠,用 /chrome reconnect |
computer-use 不在 /mcp | 检查 macOS、计划、Claude Code 版本和交互式会话 |
| macOS 权限反复弹 | 授权 Screen Recording 后重启终端或 Claude Code |
| another Claude session holds the lock | 退出正在使用 computer use 的另一个会话 |
#官方参考
Support / 支持
Need help? / 需要帮助？
接入、计费与模型异常可邮件联系；服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right
