安装指南
June 20, 2025 · View on GitHub
🔧 前置要求
安装 Playwright MCP
本项目依赖 Playwright MCP 来执行浏览器自动化。重要:使用以下命令安装以启用会话持久化功能:
claude mcp add playwright -- npx -y @playwright/mcp@latest \
--user-data-dir ~/.cache/claude-playwright \
--storage-state ~/.cache/claude-playwright/auth-state.json \
--save-trace \
--output-dir ~/CascadeProjects/claude-code-playwright-mcp-test/screenshots
新功能说明:
--storage-state: 自动保存和恢复登录状态--user-data-dir: 持久化浏览器数据--save-trace: 保存调试跟踪文件--output-dir: 指定截图输出目录
更多安装信息请参考:Playwright MCP 官方仓库
🚀 快速开始
1. 安装依赖
确保已安装 Playwright MCP(参考上面的前置要求)。
💡 初次使用? 建议先观看我们的演示视频了解框架的实际使用!
2. 配置环境变量
编辑对应环境的配置文件:
# 开发环境
.env.dev
# 测试环境
.env.test
# 生产环境
.env.prod
3. 执行测试
# 在Claude Code中使用项目命令,执行订单测试
/run-yaml-test file:test-cases/order.yml env:dev
4. 查看测试报告
# 启动报告索引查看器,浏览所有测试报告
/view-reports-index
# 或使用npm命令
npm run view-reports