TestSprite CLI 入门：给编码 Agent 装上真实浏览器验证闭环
按官方 Docs：先用 --dry-run 离线摸清命令，再对公开练习站跑一条通过、一条故意失败的云端浏览器测试，最后把验证闭环交给 Claude Code / Cursor 并接上 GitHub Actions 门禁。
入门·3 课时·63 分钟·图文实操
免费学习无需登录
你将学会
- 用 --dry-run 零成本熟悉 TestSprite CLI 命令与输出
- 写出合法的前端计划文件并在云端真实浏览器里跑出结论
- 按退出码与失败包定位问题并重跑
- 给 Claude Code / Cursor 装上验证技能并用固定说法驱动闭环
- 用 testsprite ci init 生成 GitHub Actions 门禁
适合谁
- 在用 Claude Code、Cursor、Codex 等编码 Agent 的开发者
- 想给 Web 应用补端到端测试的前端或全栈工程师
- 负责 CI 质量门禁的工程师
课前准备
- 会用终端与 Git
- 本机 Node.js 20.19+、22.13+ 或 24+
- TestSprite 免费账号（第 2、3 课需要）
课程目录
3 课时 · 63 分钟- 01装好 CLI：用 --dry-run 离线演练，再登录自检不花一个 credit，先用 --dry-run 把命令和输出格式摸熟；再拿 API key 登录，让 testsprite doctor 全部通过。图文18 分钟开始本课
- 02第一条云端浏览器测试：计划文件、退出码与失败包建一个前端项目，写两份计划文件——一条应当通过、一条故意写错预期——在 TestSprite 云端真实浏览器里各跑一次，读懂退出码和失败包，再重跑。图文25 分钟开始本课
- 03交给编码 Agent 闭环，并接上 GitHub Actions 门禁给编码 Agent 装上 TestSprite 技能，用几句固定说法让它自己完成「建 → 跑 → 读失败包 → 修 → 重跑」；再生成一份 GitHub Actions 工作流，让 PR 不过测试就不能合并。图文20 分钟开始本课
课程说明
TestSprite 是一个「AI 写端到端测试、在真实浏览器里跑、再告诉你哪里坏了」的测试平台。它的 CLI 把整套能力搬进终端和编码 Agent：创建测试、触发云端运行、拿到结构化的失败包、修完再重跑，退出码可以直接拿来做 CI 门禁。
本课完全按 TestSprite 官方 CLI 文档与官方仓库 README 整理，所有命令都在 CLI 0.15.0（npm 2026-10-19 发布）上实际跑过 --dry-run 核对输出，共 3 课时：
| 课时 | 你会做完的事 | 是否需要账号 |
|---|---|---|
| 1 | 装好 CLI，用 --dry-run 离线摸清命令，再用 API key 登录并自检 | 前半不需要，后半需要免费账号 |
| 2 | 写两份计划文件，对公开练习站跑一条通过、一条故意失败的测试，读失败包并重跑 | 需要（免费档每月 150 credits） |
| 3 | 给 Claude Code / Cursor 等装上验证技能，学会对 Agent 怎么说，并生成 GitHub Actions 门禁 | 需要 |
适合：已经在用 Claude Code、Cursor、Codex 等编码 Agent，想让 Agent 改完代码后「真的打开浏览器验一遍」再说完成的开发者。
先修：会用终端；本机装有 Node.js 20.19+、22.13+ 或 24+（21.x、23.x 不支持）。
官方来源：
- CLI 概览：https://docs.testsprite.com/cli/getting-started/overview
- 安装：https://docs.testsprite.com/cli/getting-started/installation
- Quickstart：https://docs.testsprite.com/cli/getting-started/quickstart
- 面向编码 Agent 的 Quickstart：https://docs.testsprite.com/cli/getting-started/quickstart-for-agents
- CI/CD：https://docs.testsprite.com/cli/integrations/ci-cd
- 官方仓库：https://github.com/TestSprite/testsprite-cli
- 定价：https://www.testsprite.com/pricing
绑定工具： TestSprite（/tools/testsprite/）· 官网 https://www.testsprite.com/