如何用 Claude Code 在本地页面验证浏览器连接
浏览器集成把代码修改与页面运行结果放进同一工作流，也把已登录会话和可点击操作暴露给代理。直接拿生产后台试连接，无法区分连接故障、页面缺陷和权限误用，失败代价也过高。本文只在本地或专用测试页面中验证三件事：页面能否打开、可见内容能否读取、受控表单能否按预期交互；不会使用真实凭据，也不会执行支付、删除或对外发送操作。
前置条件以当前文档为准
Chrome 集成的支持版本、账号条件、浏览器扩展和操作系统限制都可能变化。安装或升级前，应先查看 Claude Code Chrome 官方文档，并从文档指向的官方渠道取得扩展。Chrome Web Store 中的 Claude 扩展页面 可用于核对发布者和当前版本信息。
先在项目终端确认 CLI 可用：
然后确认本地应用已经由项目自身的开发命令启动，并记录测试页面地址。本文使用 http://localhost:3000 作为占位示例；实际端口必须来自项目配置或启动输出。
启动或连接 Chrome
按照当前官方文档，计划在会话开始时使用 Chrome，可以从项目目录运行：
已经进入 Claude Code 会话时，可以使用：
根据交互界面查看连接状态。若命令或界面与本文不同，以当前 claude 帮助和官方文档为准，不要猜测替代参数。
第一步：只读打开本地页面
首次任务不点击、不输入，只检查导航与页面读取：
把结果与浏览器中实际页面对照，确认：
- 地址与测试应用一致，没有跳到其他标签页或外部域名。
- 页面标题和主要区域确实可见。
- 代理没有声称读取到折叠、遮挡或尚未加载的内容。
如果导航失败，先记录错误和连接状态。不要同时修改应用代码、扩展配置和浏览器权限，否则无法判断是哪项变化解决了问题。
第二步：检查开发错误信号
在连接已经通过后，再要求读取当前版本确实提供的开发信息：
不同版本暴露的控制台、网络和页面信息可能不同。如果工具无法访问某类信息，应把它记录为能力边界，而不是推断“没有错误”。
对每条报告进行人工核对：控制台警告不一定是功能故障，失败请求也可能来自浏览器扩展、遥测或测试环境缺失。只有能对应到当前应用和复现步骤的信号，才进入代码排查。
第三步：使用专用测试表单
准备没有真实账户、支付或外部通知能力的测试页面。提示词同时限定输入、动作和停止条件：
示例输入只是无敏感信息的占位值，不表示目标应用一定接受这些字段。应按项目的测试数据规则替换，并确保请求只进入本地或隔离测试环境。
验证时关注：
- 是否只操作了指定页面和字段。
- 是否只提交一次，没有自动重复。
- 页面提示是否与项目预期一致。
- 是否产生了计划外请求、导航或数据变化。
- 任务是否在指定条件后停止。
为浏览器任务设置停止条件
浏览器任务比只读代码分析多了一类风险：一个看似普通的按钮可能立即写入数据或触发外部动作。提示词应明确以下边界：
- 允许访问的域名和页面。
- 允许点击、填写和提交的控件。
- 禁止使用的凭据与浏览器保存信息。
- 遇到登录、验证码、权限申请或不可逆按钮时停止。
- 出现意外页面、弹窗或重定向时停止并报告。
对于已经登录的浏览器配置，默认把会话视为敏感权限。更稳妥的测试方式是使用隔离的浏览器资料、专用测试账号和可恢复的数据，而不是依赖个人日常浏览器状态。
连接失败时保留证据
排查前记录：
先对照官方文档检查支持条件和安装状态。不要在没有明确原因时删除浏览器资料、放宽系统权限或反复重装；这些操作会改变故障现场，也可能影响现有登录数据。
结论与限制
浏览器连接的合理验收顺序是：只读打开本地页面，核对可见内容，再读取当前工具实际提供的开发信号，最后在隔离测试表单上执行一次受控交互。域名、输入、动作和停止条件都应在任务开始前明确。
这套流程只能证明特定环境中的连接和测试动作可用，不能证明生产页面安全，也不能替代人工检查、端到端测试或权限审计。浏览器集成能力与支持条件会变化，具体命令和限制仍以当前官方文档为准。
