Claude Code 与 Chrome
Chrome 集成让 Claude Code 能与网页交互，处理仅靠仓库文件无法完成的测试、调试和自动化任务。
- 最近核验
- 适用版本
- Claude Code 2.1.x。本机使用 2.1.198 核对 CLI 拼写；官方文档可能描述更新的 2.1.x 行为。
- 核验方式
- 依据官方文档核对 Chrome setup、site permission、request confirmation 与 limitation；未安装、连接 extension 或授予任何站点访问。
可复现实践
以最小 Chrome Permission Scope 复现公开页面缺陷
在不暴露认证 session 或提交数据的情况下记录 URL、可见状态、console evidence 和可重复路径。
准备
- 支持的 Chrome 环境和官方 extension。
- 不含个人账户数据的公开或一次性测试页。
- Site permission 限制在确切 test origin。
执行步骤
记录测试边界
启用 Chrome 前写明 URL、viewport、expected result 和允许动作。
显式连接
只为本 session 启用 Chrome；本次审查未测试连接。
步骤 2 claude --chrome不传输地复现
只导航、检查 visible state 和 console；在 login、form submit、upload、purchase 或 permission prompt 前停止。
保留最小 evidence
记录 final URL、screenshot/console error 和确定性步骤，然后断开。
预期结果
在一个获准 origin 上复现或排除缺陷，没有敏感输入、提交或无关 browsing access。
验证
- 测试前后检查 extension site permissions。
- 从 clean page state 重复路径。
- 确认 evidence 不含 cookie、token、account identifier 或 private URL。
失败处理
Extension 无法连接
扩大 site permission 前先检查支持版本和 extension state。
复现需要账户
只有明确授权时使用 disposable test account，否则记录 blocker。
清理或回退
- 断开 Chrome，删除不再需要的临时 site permission。
- 敏感 screenshot/log 按批准 retention 流程删除，不临时分享。
边界与不适用场景
- 浏览器访问可暴露认证内容，并通过 click/form 传输数据；必须在动作边界确认。
- 公开页面复现不能证明其他账户、地区、extension set 或 backend state。
Chrome 集成提供什么
连接 Chrome 后，Claude Code 可检查页面、读取 console 输出、操作 DOM，并在你留在终端或 IDE 的同时验证浏览器行为。
Chrome 在全栈中的位置
启用 Chrome 集成
Chrome 支持通过 Claude Code flags 和会话内配置启用。排查提示词行为前，先确认浏览器权限和认证。
| Command | Description |
|---|---|
claude --chrome | 启动启用 Chrome 浏览器集成的会话。 |
/chrome | 在会话内配置 Claude in Chrome 设置。 |
claude auth status --text | 使用浏览器相关工作流前先确认认证。 |
claude --chrome "Open the local app, reproduce the login bug, and capture console errors."有效的浏览器测试提示词
浏览器任务需要明确 URL、复现路径和期望结果。要求 Claude Code 捕获 console 输出并写明验收方式。
何时用 Chrome vs IDE
Chrome 检查
从已知 URL 开始
告诉 Claude Code 要打开的确切页面和路由。
阅读指南捕获 console 证据
接受根因前要求 console 或 network 发现。
阅读指南有意识地启用 --chrome
只有需要实时页面访问的任务才打开浏览器工具。
阅读指南用项目测试验证
如有前端或集成测试命令，应作为最后验收步骤。
阅读指南