测试用 OpenAI Codex 构建的应用中的认证邮件

为什么邮件路径需要人工检查

Codex 是 OpenAI 的编程智能体。你可以在终端或编辑器中使用它，也可以把任务交给它在云端完成，再审查结果。它擅长认证相关的代码：表单、API 路由、令牌处理和模板。

但一项改动可能通过所有测试，却仍然发出链接到错误位置的邮件、因发件人未配置而从未送达，或者包含在任何人输入之前就过期的验证码。这些问题只有在真实邮件到达真实收件箱时才会出现。

它会构建哪种登录？

用你的应用已经在用的，或者你要求的那个。Supabase Auth、Clerk、Firebase Authentication、Auth.js 和 Better Auth 发送的邮件各不相同，而且各自都有一个最常导致问题的设置。在任务中写明你想要的方式，比如“邮箱和密码加确认码，再加 Google”，这样改动和你的检查覆盖的是同样的邮件。各登录服务发送哪些邮件。

合并前检查

1. 运行分支。 在本地启动，或者如果你的托管平台为每项改动创建预览部署，就打开它。
2. 在 Proxy Mail QA 中创建一个地址，然后注册、请求魔法链接或重置密码：改动涉及什么就测什么。
3. 使用该行中的验证码或链接。 验证码有 Copy 按钮；链接会变成按用途命名的按钮。
4. 完整阅读一遍邮件。 在收件箱视图中检查发件人、主题、措辞和每个链接。
5. 在地址上记下你的发现，让它跟着测试账号走。

如果预览或预发布部署上的链接指向 localhost，它会被标记。这通常意味着 URL 被硬编码或缺少环境变量：查看修复方法。

让 Codex 自己检查邮件

从 ChatGPT 的插件目录安装 Proxy Mail QA 插件：它可以在 Codex 和 ChatGPT 中使用。在提示时通过浏览器登录 Proxy Mail QA，并选择它可以使用的项目，不需要复制 API 密钥。

Codex IDE 扩展不支持插件。要在那里添加 MCP server，在终端中运行：

codex mcp add proxymail-qa --url https://api.proxymail.qa/mcp

Codex 会打开浏览器让你登录；如果没有打开，运行 codex mcp login proxymail-qa。Codex CLI、IDE 扩展和 ChatGPT 桌面应用共用这个设置。如果要改用 API 密钥，请参阅 MCP server 设置。

然后用平常的话提问：“在 localhost:3000 上用一个新的 Proxy Mail QA 地址注册，并确认邮件。”Codex 会创建地址、填写你的表单、等待验证码或链接，然后完成注册。它只拿到验证码或链接，从不获取邮件正文。

把发现变成下一个任务

给 Codex 一个明确的后续任务，而不是“邮件坏了”：

• “在预览部署中，验证链接使用的是 http://localhost:3000。从环境变量读取基础 URL。”
• “验证码邮件说 10 分钟有效，但服务器 2 分钟后就拒绝验证码。让两者一致。”
• “请求新的魔法链接时，应该让之前的链接失效。”

提示

• 每个场景一个地址。 批量创建几个，各自带生成的姓名和用户名，用于新用户、受邀用户和重置测试。
• 重复运行用加号标签。 name+pr482@mailclub.dev 会进入 name@mailclub.dev，并显示标签。
• 保存密码。 把注册时用的密码保存在同一行，加密并隐藏，需要时再查看。