gpt-team-register

用于自动化注册或登录 ChatGPT Team / Business 子账号的小工具。

这个仓库既可以直接当命令行脚本使用，也可以作为 Codex skill 集成到你的工作流中。核心逻辑基于 Playwright，会打开真实浏览器，自动完成 ChatGPT 登录页、SSO 选择、SAML 表单填写，以及首次登录后的常见引导步骤。

功能特性

• 支持通过单个账号 ID 注册或登录 Team / Business 子账号
• 自动按 [email protected] 规则生成邮箱
• 复用持久化浏览器配置，减少重复 Cloudflare 校验
• 遇到 invalid SAML request 时自动重试
• 自动选择默认 onboarding 身份并跳过常见引导弹窗
• 创建/登录成功后自动保存 ChatGPT access_token / session_token
• 支持把 Codex 内置浏览器里的 /api/auth/session JSON 桥接保存成本地 session cache
• 可选择运行结束后保留浏览器，便于人工检查

运行要求

• Node.js
• Playwright
• 可用的 Chromium / Chrome 浏览器
• 可访问目标 Team / Business SSO 流程

脚本现在不再强依赖 macOS 固定路径。

浏览器解析顺序如下：

1. --chrome-path
2. 环境变量 CHROME_PATH
3. 环境变量 GOOGLE_CHROME_BIN
4. 常见系统路径自动探测
5. Playwright 默认 Chromium

Playwright 解析顺序如下：

1. 环境变量 PLAYWRIGHT_PACKAGE_PATH
2. 当前 Node.js 环境中的 playwright
3. NODE_PATH 中可解析的 playwright
4. 环境变量 CODEX_RUNTIME_NODE_DIR 对应运行时目录

快速开始

克隆仓库：

git clone [email protected]:ikunycj/gpt-team-register.git
cd gpt-team-register

直接注册或登录一个账号：

./register-team-account ikun0000002

默认会自动生成邮箱：

[email protected]

创建/登录成功后会自动保存 ChatGPT session cache 到：

chatgpt_sessions/[email protected]

这个文件包含 token，已经被 .gitignore 忽略，不要提交到 GitHub。

如果浏览器出现 Cloudflare 校验，请在打开的 Chrome 窗口中手动完成，然后回到终端按回车继续。

推荐用法

方式一：脚本完整自动流程

适合常规批量注册/登录。脚本会打开自己的 Chrome / Chromium profile，完成 SSO、onboarding，并保存 session cache。

./register-team-account ikun0000002

常用选项：

./register-team-account ikun0000002 --close
./register-team-account ikun0000002 --role 产品管理
./register-team-account ikun0000002 --session-output-dir ./chatgpt_sessions
./register-team-account ikun0000002 --no-save-session

方式二：Codex 内置浏览器流程

适合在 Codex 里可视化接管页面、处理 Cloudflare、人工观察注册过程。流程是：

1. 用 Codex 内置浏览器登录或注册到 https://chatgpt.com/
2. 确认页面在 Business 工作区，聊天框可用
3. 打开 https://chatgpt.com/api/auth/session
4. 把返回的 JSON 交给本地保存器

保存方式可以任选一种：

# 从文件保存
./fetch-json-save --email [email protected] --session-json-file auth-session.json

# 从标准输入保存
cat auth-session.json | ./fetch-json-save --email [email protected] --session-json-stdin

保存后会生成：

chatgpt_sessions/[email protected]

作为脚本使用

显式指定邮箱：

./register-team-account --id ikun0000002 --email [email protected]

运行完成后自动关闭浏览器：

./register-team-account ikun0000002 --close

在点击 Sign In 前保留人工确认：

./register-team-account ikun0000002 --confirm

禁用持久化浏览器配置：

./register-team-account ikun0000002 --no-persistent

指定首次登录角色：

./register-team-account ikun0000002 --role 产品管理

指定浏览器路径：

./register-team-account ikun0000002 --chrome-path /path/to/chrome

也可以通过环境变量指定：

CHROME_PATH=/path/to/chrome ./register-team-account ikun0000002

如果你的环境里 node 可执行文件或 playwright 安装位置不标准，也可以这样覆盖：

NODE_BIN=/path/to/node \
PLAYWRIGHT_PACKAGE_PATH=/path/to/node_modules/playwright/index.js \
./register-team-account ikun0000002

如果你已经通过 register-team-account 登录了持久化浏览器 profile，可以保存 ChatGPT 会话缓存：

./fetch-json-save --email [email protected]

如果登录流程是在 Codex 内置浏览器里完成的，可以先打开：

https://chatgpt.com/api/auth/session

再把返回的 JSON 交给本地保存器：

./fetch-json-save --email [email protected] --session-json-file auth-session.json

如果你只想从命令行直接传入 JSON：

./fetch-json-save --email [email protected] --session-json '{"accessToken":"...","sessionToken":"..."}'

作为 Skill 使用

仓库中已经包含 Codex skill 定义：

• skills/gpt-team-register/SKILL.md
• skills/gpt-team-register/config.json

适合的使用场景：

• 让 Codex 帮你注册新的 Team 子账号
• 在已有流程失败后让 Codex 自动重试
• 将这套注册流程纳入你自己的技能库或自动化工作流

如果你把这个仓库作为 skill 使用，注册流程会强制使用 Codex 内置浏览器；脚本保留为独立命令行工具和 session 保存辅助工具。

参数说明

--id            账号 ID，同时作为 SSO userid
--email         显式指定邮箱
--domain        邮箱域名，默认：hegiw77632.cloud-ip.cc
--sso           SSO 按钮名称，默认：codex
--role          首次登录角色，默认：工程
--confirm              点击 Sign In 前要求人工确认
--headless             以无头模式运行 Chrome
--close                结束后自动关闭浏览器
--no-save-session      创建/登录成功后不保存 ChatGPT session cache
--session-output-dir  自定义自动保存 session cache 的目录
--no-persistent        禁用持久化浏览器配置目录
--profile-dir    自定义浏览器配置目录
--chrome-path    指定 Chrome / Chromium 可执行文件路径
--retries      SAML 过期后的重试次数

fetch-json-save 参数：

--email         邮箱，通常直接使用完整邮箱
--output-dir     自定义输出目录，默认：chatgpt_sessions
--save-chatgpt-session 兼容参数，显式使用会话保存模式
--session-json   从 ChatGPT /api/auth/session JSON 直接保存
--session-json-file  从文件读取 ChatGPT /api/auth/session JSON
--session-json-stdin   从标准输入读取 ChatGPT /api/auth/session JSON
--profile-dir    自定义浏览器配置目录，默认：.browser-profile
--storage-state  额外导入 Playwright storageState cookies
--password      写入 session cache 的 chatgpt_password 字段
--name          写入 session cache 的 name 字段
--birthdate     写入 session cache 的 birthdate 字段
--chrome-path    指定 Chrome / Chromium 可执行文件路径
--compact              使用紧凑 JSON，不做缩进

Session Cache 格式

chatgpt_sessions/.json 大致结构如下：

{
  "email": "[email protected]",
  "saved_at": "2026-06-08T15:30:00.000Z",
  "chatgpt_password": "",
  "name": "",
  "birthdate": "",
  "access_token": "...",
  "session_token": "...",
  "cookies": [],
  "raw_session": {}
}

access_token、session_token 和 raw_session 都属于敏感数据。chatgpt_sessions/ 已被 .gitignore 忽略。

工作流程

1. 打开 https://chatgpt.com/auth/login
2. 检查当前是否已有登录态，必要时先退出
3. 输入目标邮箱
4. 选择指定的 SSO 提供方
5. 填写 SAML 页面中的邮箱和用户 ID
6. 提交 Sign In
7. 若 SAML 请求过期，则自动重新发起并重试
8. 完成首次登录后的常见引导流程
9. 保存 ChatGPT session cache

浏览器配置目录

默认持久化浏览器配置目录为：

.browser-profile/

这个目录会保留一定的浏览器状态，有助于减少重复验证和重复登录。

注意事项

• 这个脚本更适合“可见浏览器 + 人工可接管”的使用方式
• Cloudflare、CAPTCHA 或额外安全验证仍然需要手动完成
• 当前脚本针对的是特定 Team / Business 工作区和 SSO 按钮名称
• 这不是一个通用的 OpenAI 账号注册库
• 不要提交 .browser-profile/、chatgpt_sessions/、gpt-rt/ 或任何包含 token 的 JSON 文件

仓库结构

.
├── register-team-account
├── fetch-json-save
├── README.md
├── scripts/
│   └── register-team-account.mjs
│   └── fetch-json-save.mjs
└── skills/
    └── gpt-team-register/
        ├── config.json
        └── SKILL.md

开源协议

本项目采用 Apache License 2.0。详见仓库根目录 LICENSE。

致谢

感谢 Linux.do 社区成员的讨论、反馈、建议与支持。