Claude Code 桌面版新增应用内浏览器之后,开发团队最应该先补的不是一堆新提示词,而是一套清晰的验收清单。
据 Claude Developers 官方账号 2026-07-11 发布的信息,Claude Code 桌面版现在可以在应用中调出文档、设计稿或其他网站,并读取页面、点击、与网页交互。浏览器运行在沙箱中,会话持久保留可配置。
这篇不写成 API 教程,因为官方发布没有公开可编程浏览器接口。更实用的做法是,把它当成开发任务里的验证环节来设计。
1. Issue 模板
md
## 任务目标
修复或验证的目标是什么?
示例,修复登录页错误提示在空输入和密码错误场景下展示不一致的问题。
## 资料范围
Claude Code 可以读取:
- 官方文档,[URL]
- 设计稿,[URL]
- 本地页面,http://localhost:3000/login
- 测试环境页面,[URL]
Claude Code 不可以读取:
- 生产后台
- 真实客户数据
- 支付、退款、权限修改页面
- 含个人信息或财务数据的页面
## 修改范围
允许修改:
- src/pages/login/*
- src/components/form/*
- src/i18n/login/*
禁止修改:
- package.json
- 鉴权中间件
- 支付逻辑
- 生产环境配置
- 权限策略
这部分的目的,是先把 AI 的活动范围圈出来。范围越清楚,后面的浏览器验证越稳。
2. 浏览器验证步骤
md
## 浏览器验证步骤
1. 打开本地页面
URL,http://localhost:3000/login
2. 检查页面加载
- 页面首屏正常渲染
- 无空白页
- 控制台无 error
3. 检查空输入状态
- 不输入邮箱和密码
- 点击登录
- 页面展示空输入提示
- 错误文案不遮挡按钮
4. 检查错误密码状态
- 输入测试邮箱
- 输入错误密码
- 点击登录
- 页面展示错误密码提示
5. 检查成功路径
- 使用测试账号登录
- 能跳转到测试首页
- 控制台无 error
6. 检查移动端宽度
- 切换到 375px 宽度
- 表单、按钮、错误文案不重叠
如果团队有 Playwright 或 Cypress,可以把这些步骤再转成自动化测试。但即使没有自动化测试,这份人工验收步骤也能让 Claude Code 的浏览器操作更可控。
3. 交付格式
md
## 交付结果
### 修改文件
- [文件路径],[改了什么]
### 验证通过
- [通过项 1]
- [通过项 2]
- [通过项 3]
### 验证失败
- [失败项]
- 复现步骤,[步骤]
- 当前现象,[现象]
- 建议下一步,[建议]
### 无法确认
- [无法确认的原因,例如需要真实账号、需要生产权限、需要人工视觉判断]
### 需要人工确认
- [需要人类点头的动作,例如合并代码、发布、修改权限]
重点是不要让 AI 只回一句「已完成」。开发任务的交付应该包含证据。
4. 权限边界配置表
| 类型 | 建议 |
|---|---|
| 可以开放 | 官方文档、帮助中心、本地开发页面、测试环境、脱敏示例数据 |
| 默认不开放 | 生产后台、真实客户数据、支付退款页面、权限变更页面 |
| 必须人工确认 | 合并生产代码、发布线上版本、修改权限策略、保存长期登录会话 |
官方提到浏览器运行在沙箱中,但沙箱不等于所有动作都安全。团队仍然应该把生产、支付、权限和敏感数据放在人工确认后面。
5. 一个完整任务片段
text
你要修复登录页错误提示。
只能读取官方文档、设计稿和 http://localhost:3000/login。
可以修改 src/pages/login、src/components/form、src/i18n/login。
不要修改 package.json、鉴权中间件、支付逻辑、权限策略和生产配置。
修改后打开本地页面,检查页面加载、空输入、错误密码、成功跳转、移动端 375px 宽度和控制台 error。
交付时列出修改文件、验证通过项、验证失败项、无法确认项和需要人工确认项。
6. 自检清单
md
- [ ] 任务目标是否只有一个?
- [ ] 是否写清楚可读取资料?
- [ ] 是否写清楚不可读取页面?
- [ ] 是否限制了可修改目录?
- [ ] 是否列出禁止修改项?
- [ ] 是否提供本地或测试环境 URL?
- [ ] 是否写清楚点击和输入步骤?
- [ ] 是否要求检查控制台 error?
- [ ] 是否要求输出失败项?
- [ ] 是否列出人工确认点?
结论
Claude Code 应用内浏览器的价值,不在于让 AI 任意操作网页,而在于把网页验证纳入 AI 编程任务。开发团队应该先从低风险页面、本地环境和测试环境开始,把任务边界、验证步骤和交付格式写清楚。
ClaudeAPI 为独立第三方技术服务商。Claude、Claude Code、Anthropic 等名称归其各自权利方所有,本文仅基于公开信息进行技术解读,不代表 ClaudeAPI 与相关权利方存在官方授权、代理、经销、合作或背书关系。
本文的持续更新版本可查看:Claude Code 应用内浏览器发布,AI 编程开始补上验证闭环