TestSprite setup命令完全指南一条命令配置API Key并接入Claude Code等8大AI编程代理【免费下载链接】testsprite-cliOfficial TestSprite CLI — AI-powered automated testing from your terminal项目地址: https://gitcode.com/gh_mirrors/te/testsprite-cliTestSprite setup 命令是官方 CLI 的入门总入口它让你一条命令完成API Key 配置、密钥校验并自动把测试验证技能安装到你正在使用的Claude Code、Codex、Cursor、Cline、Windsurf、Kiro、Copilot、Antigravity等 8 大 AI 编程代理中。装好之后你的 AI 代理就能自己创建测试、运行测试、读取失败原因并修复代码——而不需要你手动教它。为什么用 setup 命令一站式配置以前配置一个测试 CLI 往往要分三步填密钥、配代理、写提示词。testsprite setup把这件事压缩成一次交互它按固定顺序执行编排逻辑见 init.ts识别代理— 先探测你用哪些 AI 编码代理写入文件前会让你确认写入密钥— 提示输入 API Key输入是掩码的先调用GET /me验证密钥有效再持久化安装技能— 为检测到的每个代理放入「验证循环」技能文件打印摘要— 告诉你装了哪些目标、密钥来源和端点。 设计要点setup是唯一的凭据写入入口未识别任何代理时默认安装到claude并且确认前不会写任何文件。前置条件快速安装 TestSprite CLI要求Node.js 20.19 / 22.13 / 24两种方式任选npm install -g testsprite/testsprite-cli # 全局安装 # 或者不安装直接用 npx testsprite/testsprite-cli --version安装后可以先不配密钥验证环境testsprite --version testsprite project list --dry-run --output json # 离线假数据验证装好即可--dry-run是全局参数跳过网络和凭据、输出与真实 API 一致的样例数据非常适合在学习阶段试错。一条命令完成配置testsprite setup 用法详解交互模式推荐新手testsprite setup执行后它会依次询问① 你的 API Key② 确认安装到哪些代理已预填检测结果直接回车接受或输入逗号分隔列表缩小范围。非交互模式CI / 脚本TESTSPRITE_API_KEYsk-... testsprite setup --from-env --yes--from-env从环境变量TESTSPRITE_API_KEY读取密钥--yes表示全程不提问、接受默认值。密钥存在哪里凭据以 INI 格式保存在~/.testsprite/credentials文件权限0600。如果 HOME 不可写如只读环境--from-env模式会降级为「仅本次会话使用环境变量密钥」JSON 摘要里会标明persisted: false——注意认证成功不等于密钥已保存。配置成功后如何验证testsprite auth status # 查看当前 profile 对应用户、密钥、权限范围 testsprite agent status # 检查各代理技能文件是否新鲜/被改动/缺失 testsprite doctor # 一键体检Node 版本、凭据、连通性、代理技能失败退出码非 0doctor的诊断实现见 doctor.ts在 CI 里可以用testsprite doctor ...作为前置关卡。8 大 AI 编程代理的自动检测它怎么知道你在用谁setup不用你手动声明代理——它合并了两类证据来检测检测逻辑见 agent-detect.ts证据类型示例说明环境变量CLAUDECODE、CURSOR_AGENT识别正在调用 CLI 的代理仓库痕迹.claude/、.cursor/、.clinerules/、AGENTS.md等识别这个仓库用过哪些代理检测出的全部目标都会被安装比如你同时有.claude/和.cursor/两者都会装上并在终端先展示列表供你确认。一个细节它会区分「仓库里的配置是我自己装的」和「确实有人在用」避免检测结果自我强化。各代理的技能文件落点一览完整定义见 agent-targets.ts代理技能文件位置Claude Code.claude/skills/skill/SKILL.mdCursor.cursor/rules/skill.mdcCline.clinerules/skill.mdWindsurf.windsurf/rules/skill.mdCodexAGENTS.md仅写入哨兵标记区绝不覆盖你的内容Copilot.github/instructions/skill.instructions.mdKiro.kiro/skills/skill/SKILL.mdAntigravity.agents/skills/skill/SKILL.md 检测结果不是你想要的加--agent target显式指定例如testsprite setup --agent codex。setup 会给你装上哪两个技能每个代理都会收到两个开箱即用的技能文件默认技能集DEFAULT_SKILLStestsprite-verify技能模板— 验证循环代码改完后代理会用 CLI 跑覆盖该改动的测试、读取失败产物截图、DOM、根因假设、建议修复点确认通过后才报告完成testsprite-onboard技能模板— 首次引导仓库还没有任何测试时代理会基于代码库批量创建一套覆盖主要用户流的测试并冒烟运行。装上之后代理的日常工作流就闭环了test create → run → failure get → 修复 → rerun每一次通过都会沉淀进你的持久测试套件。常用参数速查参数作用--api-key key直接传密钥跳过交互询问--from-env从TESTSPRITE_API_KEY环境变量读取--agent target只安装到指定代理8 个目标任选--no-agent只配密钥跳过技能安装--force覆盖已有技能文件自动留.bak备份--dir path指定技能安装的项目根目录-y, --yes非交互接受全部默认值--output json输出机器可读摘要方便脚本消费--dry-run离线演练完整流程不写文件在 CI 里组合使用TESTSPRITE_API_KEYsk-... testsprite setup --from-env --agent claude --output json常见问题 FAQQ老脚本里用了testsprite init或auth configure还能跑吗能。两者都是已弃用的隐藏别名会打印一行提示auth configure现在实际执行完整setup流程现有脚本无需改动。Q输入了不认识的代理名怎么办setup会友好地重新询问还可以输入none跳过安装而手工修复用的agent install会直接报错退出让你重新选择。Q怎么确认技能文件没有过期运行testsprite agent status它会逐个目标报告ok / stale / modified / absent / corrupt有异常时退出码为 1可直接用作 CI 门禁。Q想完全手动配置每一步参考 DOCUMENTATION.md 的 Manual setup 章节先setup --no-agent只配密钥再单独用testsprite agent install target安装技能。写在最后testsprite setup的价值在于把「配置密钥 教会 AI 代理用测试」合并成了一次确认装完后你的 Claude Code 或 Codex 就会在每次改动后自动验证自己的代码失败时读取自洽的失败产物、修好再重跑。新手只需记住两行命令——npm install -g testsprite/testsprite-cli testsprite setup然后让代理开始干活。更多命令、标志与退出码说明见 DOCUMENTATION.md 和 README.md。【免费下载链接】testsprite-cliOfficial TestSprite CLI — AI-powered automated testing from your terminal项目地址: https://gitcode.com/gh_mirrors/te/testsprite-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
