codex-register

用于自动注册 OpenAI 账号、读取邮箱验证码、生成 Codex OAuth 授权文件，也支持批量处理指定邮箱列表。

免责声明

本项目仅供学习、研究与接口行为测试使用。使用者应自行确保其用途符合目标平台的服务条款、当地法律法规以及所在网络环境的合规要求。

因使用本项目导致的账号风险、访问限制、数据丢失、封禁、法律责任或其他任何损失，均由使用者自行承担，项目作者与维护者不承担任何直接或间接责任。

环境要求

• Node.js 20.18+
• 可用代理，默认读取 config.json.defaultProxyUrl
• 一个可用邮箱 provider：cloudflare、gmail 或 hotmail

快速开始

安装依赖：

npm install

复制并修改配置：

copy config.example.json config.json

最小配置示例：

{
  "provider": "cloudflare",
  "defaultProxyUrl": "http://127.0.0.1:10808",
  "defaultPassword": "kuaileshifu88",
  "loopDelayMs": 30000,
  "cloudflareEmailDomain": "example.com",
  "cloudflareApiBaseUrl": "https://mail-api.example.workers.dev",
  "cloudflareApiKey": "your_api_key"
}

开发模式运行：

npm run dev

构建并运行：

npm run build
npm run start

运行命令

主程序：

npm run dev
npm run dev -- --n 1
npm run dev:sign
npm run dev:at
npm run dev:mode1

构建后运行：

npm run start
npm run start -- --n 1
npm run start:sign
npm run start:at
npm run start:mode1

参数说明：

• --n <次数>：自动模式最多跑多少轮。
• --sign：直接注册并授权。
• --at：只注册 ChatGPT 并保存 ChatGPT accessToken 到 auth/at/。
• --mode 1：注册流程在进入基础资料页前停止。
• --st：使用浏览器模式获取 Sentinel token，需要本机 Edge/Chrome 或设置 SENTINEL_BROWSER_PATH。

npm 11 会把 npm run dev -- --sign、npm run dev -- --mode 1 这类未知参数当作 npm config 并输出 warning。程序兼容这种传参，但推荐使用 npm run dev:sign、npm run start:sign、npm run dev:at、npm run start:at、npm run dev:mode1、npm run start:mode1。

批量注册

批量入口只处理你提供的邮箱列表：

npm run batch -- --emails a@example.com,b@example.com
npm run batch -- --file emails.txt

参数说明：

• --emails <邮箱列表>：逗号分隔的邮箱列表。
• --file <文件>：每行一个邮箱。
• --delay-ms <毫秒>：每个邮箱之间的等待时间，默认 3000。
• --stop-on-error：任一邮箱失败时停止。
• --sign：直接注册并授权。

配置项

通用配置：

• provider：邮箱 provider，只支持 cloudflare、gmail、hotmail。
• defaultProxyUrl：默认代理地址。
• defaultPassword：注册默认密码。
• loopDelayMs：自动模式每轮间隔时间，单位毫秒。

Gmail：

• gmailAccessToken：Gmail API access token。
• gmailEmailAddress：Gmail 主邮箱地址，程序会生成 plus alias。

Cloudflare：

• cloudflareEmailDomain：Cloudflare Email Routing 域名。
• cloudflareApiBaseUrl：邮件 Worker 地址。
• cloudflareApiKey：邮件 Worker 的 x-api-key。

CLIProxyAPI 自动上传：

• cliproxyApiAutoUploadAuth：授权成功后是否自动上传 auth 文件。
• cliproxyApiBaseUrl：CLIProxyAPI 管理地址。
• cliproxyApiManagementKey：CLIProxyAPI 的 MANAGEMENT_KEY。

Provider

Cloudflare

适合自有域名和长期自动注册。

{
  "provider": "cloudflare",
  "cloudflareEmailDomain": "example.com",
  "cloudflareApiBaseUrl": "https://mail-api.example.workers.dev",
  "cloudflareApiKey": "your_api_key"
}

部署说明见 MAIL_WORKER_DEPLOY.md。

Gmail

{
  "provider": "gmail",
  "gmailAccessToken": "your_gmail_access_token",
  "gmailEmailAddress": "your_gmail@gmail.com"
}

临时 token 获取教程见 GMAIL_OAUTH_PLAYGROUND.md。

Hotmail

{
  "provider": "hotmail"
}

账号放在 hotmail/tokens.txt，格式：

邮箱----密码----client_id----refresh_token

程序会随机取一个账号生成别名邮箱，刷新 token，并读取收件箱和垃圾箱里的验证码邮件。刷新后的 refresh_token 会回写到 tokens.txt。

授权文件

Codex OAuth 授权文件会保存到 auth/，文件名格式为：

日期-邮箱.json

生成的 auth JSON 包含：

{
  "type": "codex",
  "priority": 10,
  "websockets": true
}

如果启用 CLIProxyAPI 自动上传，auth 文件仍会先保存到本地 auth/，上传失败只输出警告，不中断主流程。

相关文档

• MAIL_WORKER_DEPLOY.md：Cloudflare 邮件 Worker 部署。
• GMAIL_OAUTH_PLAYGROUND.md：Gmail 临时 access token 获取。