AutoTeam — ChatGPT Team账号自动轮转管理

Skill by ara.so — Daily 2026 Skills collection.

AutoTeam 是一个自动化工具，用于管理 ChatGPT Team 账号的轮转：自动注册账号、获取 Codex OAuth 认证、监控额度余量、在额度低时智能切换账号，并将认证文件同步到 CLIProxyAPI。

Skill by ara.so — Daily 2026 Skills collection.

AutoTeam 是一个自动化工具，用于管理 ChatGPT Team 账号的轮转：自动注册账号、获取 Codex OAuth 认证、监控额度余量、在额度低时智能切换账号，并将认证文件同步到 CLIProxyAPI。

安装

前置条件

Python 3.10+
uv 包管理器
Chromium（由 Playwright 管理）

Python 3.10+
uv 包管理器
Chromium（由 Playwright 管理）

一键安装

bash

git clone https://github.com/cnitlrt/AutoTeam.git
cd AutoTeam
bash setup.sh

bash

git clone https://github.com/cnitlrt/AutoTeam.git
cd AutoTeam
bash setup.sh

等价于: uv sync && uv run playwright install chromium

undefined

undefined

手动安装

bash

uv sync
uv run playwright install chromium
cp .env.example data/.env

bash

uv sync
uv run playwright install chromium
cp .env.example data/.env

编辑 data/.env 填入必要配置

undefined

undefined

配置

环境变量（

data/.env

）

环境变量（

data/.env

）

env

undefined

env

undefined

临时邮箱服务（CloudMail）

CLOUDMAIL_API_KEY=$CLOUDMAIL_API_KEY CLOUDMAIL_DOMAIN=example.com

CPA（CLIProxyAPI）连接

CPA_BASE_URL=http://your-cpa-host:port CPA_API_KEY=$CPA_API_KEY

AutoTeam API 鉴权

AUTOTEAM_API_KEY=$AUTOTEAM_API_KEY

ChatGPT Team 管理员账号

TEAM_ADMIN_EMAIL=admin@example.com TEAM_ADMIN_PASSWORD=$TEAM_ADMIN_PASSWORD

额度阈值（低于此值触发轮转）

QUOTA_THRESHOLD=100

Team 目标成员数

TEAM_SIZE=5

Web 面板端口

PORT=8787

undefined

PORT=8787

undefined

首次启动配置向导

bash

uv run autoteam api

bash

uv run autoteam api

首次启动自动引导配置 CloudMail、CPA、API Key 并验证连通性

undefined

undefined

CLI 命令

bash

undefined

bash

undefined

启动 Web 面板 + HTTP API（推荐，默认端口 8787）

uv run autoteam api

智能轮转，补满到 N 个账号（默认 5）

uv run autoteam rotate uv run autoteam rotate 8

查看所有账号状态和额度

uv run autoteam status

检查所有账号额度

uv run autoteam check

手动添加一个新账号

uv run autoteam add

补满成员到目标数量

uv run autoteam fill uv run autoteam fill 10

清理多余成员

uv run autoteam cleanup uv run autoteam cleanup 5

同步认证文件到 CPA

uv run autoteam sync

管理员登录（刷新 admin session）

uv run autoteam admin-login

undefined

uv run autoteam admin-login

undefined

Docker 部署

快速启动

bash

git clone https://github.com/cnitlrt/AutoTeam.git && cd AutoTeam
mkdir -p data && cp .env.example data/.env

bash

git clone https://github.com/cnitlrt/AutoTeam.git && cd AutoTeam
mkdir -p data && cp .env.example data/.env

编辑 data/.env

docker compose up -d

undefined

docker compose up -d

undefined

docker-compose.yml

结构

docker-compose.yml

结构

yaml

services:
  autoteam:
    build: .
    ports:
      - "8787:8787"
    volumes:
      - ./data:/app/data   # 持久化配置、数据库、认证文件
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

yaml

services:
  autoteam:
    build: .
    ports:
      - "8787:8787"
    volumes:
      - ./data:/app/data   # 持久化配置、数据库、认证文件
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

Docker 常用操作

bash

undefined

bash

undefined

查看实时日志

docker compose logs -f autoteam

重启服务

docker compose restart autoteam

进入容器执行 CLI

docker compose exec autoteam uv run autoteam status

停止服务

docker compose down

undefined

docker compose down

undefined

HTTP API

所有 API 请求需携带鉴权头：

Authorization: Bearer $AUTOTEAM_API_KEY

所有 API 请求需携带鉴权头：

Authorization: Bearer $AUTOTEAM_API_KEY

核心端点

bash

undefined

bash

undefined

获取账号状态列表

GET /api/accounts

触发轮转任务

POST /api/rotate Content-Type: application/json {"target": 5}

检查额度

POST /api/check

补满成员

POST /api/fill {"target": 5}

清理多余成员

POST /api/cleanup {"keep": 5}

同步认证到 CPA

POST /api/sync

获取任务历史

GET /api/tasks

获取实时日志

GET /api/logs

获取/更新巡检配置

GET /api/patrol/config PUT /api/patrol/config Content-Type: application/json {"enabled": true, "interval_minutes": 30, "threshold": 100}

undefined

GET /api/patrol/config PUT /api/patrol/config Content-Type: application/json {"enabled": true, "interval_minutes": 30, "threshold": 100}

undefined

Python 调用示例

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

获取账号状态

with httpx.Client() as client: resp = client.get(f"{BASE_URL}/api/accounts", headers=HEADERS) accounts = resp.json() for acc in accounts: print(f"{acc['email']}: quota={acc['quota']}, status={acc['status']}")

触发轮转

with httpx.Client(timeout=300) as client: resp = client.post( f"{BASE_URL}/api/rotate", headers=HEADERS, json={"target": 5} ) task = resp.json() print(f"Task ID: {task['task_id']}, Status: {task['status']}")

undefined

with httpx.Client(timeout=300) as client: resp = client.post( f"{BASE_URL}/api/rotate", headers=HEADERS, json={"target": 5} ) task = resp.json() print(f"Task ID: {task['task_id']}, Status: {task['status']}")

undefined

Web 管理面板

访问

http://localhost:8787

后查看以下页面：

页面	功能
📊 仪表盘	账号统计、状态表格、登录/移出/删除/同步操作
👥 Team 成员	全部 Team 成员（含外部成员）列表
⚡ 操作 & 任务	一键轮转/检查/补满/清理/同步 + 任务历史
📋 日志	实时日志查看器
⚙️ 设置	管理员登录 + 主号 Codex 同步 + 巡检配置

访问

http://localhost:8787

后查看以下页面：

页面	功能
📊 仪表盘	账号统计、状态表格、登录/移出/删除/同步操作
👥 Team 成员	全部 Team 成员（含外部成员）列表
⚡ 操作 & 任务	一键轮转/检查/补满/清理/同步 + 任务历史
📋 日志	实时日志查看器
⚙️ 设置	管理员登录 + 主号 Codex 同步 + 巡检配置

工作原理

轮转流程

检查额度
  └─ 低于阈值?
       ├─ 否 → 退出
       └─ 是 → 移出当前账号
                └─ 有备用账号?
                     ├─ 是 → 验证额度 → 加入 Team → 同步 CPA
                     └─ 否 → 注册新账号
                              └─ 临时邮箱 → ChatGPT 注册
                                   └─ 验证码 → Codex OAuth
                                        └─ 加入 Team → 同步 CPA

检查额度
  └─ 低于阈值?
       ├─ 否 → 退出
       └─ 是 → 移出当前账号
                └─ 有备用账号?
                     ├─ 是 → 验证额度 → 加入 Team → 同步 CPA
                     └─ 否 → 注册新账号
                              └─ 临时邮箱 → ChatGPT 注册
                                   └─ 验证码 → Codex OAuth
                                        └─ 加入 Team → 同步 CPA

账号状态机

new → registering → registered → codex_auth → active → low_quota → removed
                        ↓                                              ↑
                      failed                                      (可复用)

new → registering → registered → codex_auth → active → low_quota → removed
                        ↓                                              ↑
                      failed                                      (可复用)

常见模式

自动化巡检脚本

python

import httpx
import os
import time

BASE_URL = os.environ.get("AUTOTEAM_BASE_URL", "http://localhost:8787")
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

def check_and_rotate():
    """检查额度，必要时触发轮转"""
    with httpx.Client(timeout=60) as client:
        # 先检查额度
        check_resp = client.post(f"{BASE_URL}/api/check", headers=HEADERS)
        check_resp.raise_for_status()
        
        # 获取账号状态
        accounts_resp = client.get(f"{BASE_URL}/api/accounts", headers=HEADERS)
        accounts = accounts_resp.json()
        
        low_quota = [a for a in accounts if a.get("quota", 999) < 100 and a["status"] == "active"]
        
        if low_quota:
            print(f"检测到 {len(low_quota)} 个低额度账号，触发轮转...")
            rotate_resp = client.post(
                f"{BASE_URL}/api/rotate",
                headers=HEADERS,
                json={"target": 5},
                timeout=300
            )
            print(f"轮转结果: {rotate_resp.json()}")
        else:
            print("所有账号额度正常")

if __name__ == "__main__":
    check_and_rotate()

python

import httpx
import os
import time

BASE_URL = os.environ.get("AUTOTEAM_BASE_URL", "http://localhost:8787")
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

def check_and_rotate():
    """检查额度，必要时触发轮转"""
    with httpx.Client(timeout=60) as client:
        # 先检查额度
        check_resp = client.post(f"{BASE_URL}/api/check", headers=HEADERS)
        check_resp.raise_for_status()
        
        # 获取账号状态
        accounts_resp = client.get(f"{BASE_URL}/api/accounts", headers=HEADERS)
        accounts = accounts_resp.json()
        
        low_quota = [a for a in accounts if a.get("quota", 999) < 100 and a["status"] == "active"]
        
        if low_quota:
            print(f"检测到 {len(low_quota)} 个低额度账号，触发轮转...")
            rotate_resp = client.post(
                f"{BASE_URL}/api/rotate",
                headers=HEADERS,
                json={"target": 5},
                timeout=300
            )
            print(f"轮转结果: {rotate_resp.json()}")
        else:
            print("所有账号额度正常")

if __name__ == "__main__":
    check_and_rotate()

配置巡检（通过 API）

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

开启自动巡检，每 30 分钟检查一次，额度低于 100 触发轮转

with httpx.Client() as client: resp = client.put( f"{BASE_URL}/api/patrol/config", headers=HEADERS, json={ "enabled": True, "interval_minutes": 30, "threshold": 100, "target_size": 5 } ) print(resp.json())

undefined

with httpx.Client() as client: resp = client.put( f"{BASE_URL}/api/patrol/config", headers=HEADERS, json={ "enabled": True, "interval_minutes": 30, "threshold": 100, "target_size": 5 } ) print(resp.json())

undefined

批量同步认证文件

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

def sync_active_accounts():
    """只同步 active 账号的认证文件到 CPA"""
    with httpx.Client(timeout=120) as client:
        resp = client.post(f"{BASE_URL}/api/sync", headers=HEADERS)
        result = resp.json()
        print(f"同步结果: 成功={result.get('synced', 0)}, 失败={result.get('failed', 0)}")
        return result

sync_active_accounts()

python

import httpx
import os

BASE_URL = "http://localhost:8787"
HEADERS = {"Authorization": f"Bearer {os.environ['AUTOTEAM_API_KEY']}"}

def sync_active_accounts():
    """只同步 active 账号的认证文件到 CPA"""
    with httpx.Client(timeout=120) as client:
        resp = client.post(f"{BASE_URL}/api/sync", headers=HEADERS)
        result = resp.json()
        print(f"同步结果: 成功={result.get('synced', 0)}, 失败={result.get('failed', 0)}")
        return result

sync_active_accounts()

故障排查

注册失败 / 验证码超时

bash

undefined

bash

undefined

问题：验证码有效期短，网络延迟导致失败

解决：使用延迟低的代理，或住宅代理

配置代理（在 .env 中）

HTTP_PROXY=http://user:pass@proxy-host:port HTTPS_PROXY=http://user:pass@proxy-host:port

undefined

HTTP_PROXY=http://user:pass@proxy-host:port HTTPS_PROXY=http://user:pass@proxy-host:port

undefined

Playwright 浏览器问题

bash

undefined

bash

undefined

重新安装 Chromium

uv run playwright install chromium

Docker 中确认浏览器依赖

docker compose exec autoteam uv run playwright install-deps chromium

undefined

docker compose exec autoteam uv run playwright install-deps chromium

undefined

CPA 同步失败

bash

undefined

bash

undefined

验证 CPA 连接

curl -H "Authorization: Bearer $CPA_API_KEY" $CPA_BASE_URL/health

检查 AutoTeam 日志

uv run autoteam api # 查看 Web 面板日志页

或

docker compose logs -f autoteam | grep "sync"

undefined

docker compose logs -f autoteam | grep "sync"

undefined

账号被封 / IP 被标记

bash

undefined

bash

undefined

症状：注册成功率低，频繁出现 Cloudflare 挑战

解决方案：

1. 使用住宅代理（非 VPS IP）

2. 降低注册频率，在 .env 中增加延迟

REGISTER_DELAY_SECONDS=30

3. 减少并发（AutoTeam 同时只允许一个 Playwright 操作）

undefined

undefined

查看详细日志

bash

undefined

bash

undefined

CLI 模式下增加详细输出

uv run autoteam rotate --verbose

Docker 中查看完整日志

docker compose logs --tail=200 autoteam

Web 面板实时日志

访问 http://localhost:8787 → 日志页面

undefined

undefined

数据库重置

bash

undefined

bash

undefined

清除本地数据（保留配置）

rm data/autoteam.db

重新启动后会自动初始化

uv run autoteam api

undefined

uv run autoteam api

undefined

项目结构

AutoTeam/
├── data/               # 持久化数据（.env、数据库、认证文件）
│   ├── .env
│   └── autoteam.db
├── docs/               # 详细文档
│   ├── getting-started.md
│   ├── configuration.md
│   ├── docker.md
│   ├── api.md
│   ├── architecture.md
│   └── troubleshooting.md
├── src/autoteam/       # 源码
│   ├── cli.py          # CLI 入口
│   ├── api.py          # FastAPI 应用
│   ├── rotator.py      # 轮转核心逻辑
│   ├── browser.py      # Playwright 自动化
│   ├── quota.py        # 额度检查
│   └── sync.py         # CPA 同步
├── frontend/           # Vue 3 Web 面板
├── docker-compose.yml
├── setup.sh
└── pyproject.toml

AutoTeam/
├── data/               # 持久化数据（.env、数据库、认证文件）
│   ├── .env
│   └── autoteam.db
├── docs/               # 详细文档
│   ├── getting-started.md
│   ├── configuration.md
│   ├── docker.md
│   ├── api.md
│   ├── architecture.md
│   └── troubleshooting.md
├── src/autoteam/       # 源码
│   ├── cli.py          # CLI 入口
│   ├── api.py          # FastAPI 应用
│   ├── rotator.py      # 轮转核心逻辑
│   ├── browser.py      # Playwright 自动化
│   ├── quota.py        # 额度检查
│   └── sync.py         # CPA 同步
├── frontend/           # Vue 3 Web 面板
├── docker-compose.yml
├── setup.sh
└── pyproject.toml

重要限制

IP 风险：VPS IP 容易被 OpenAI/Cloudflare 标记，强烈建议使用住宅代理
并发限制：同一时间只允许一个 Playwright 操作，避免竞态
服务条款：使用本工具可能违反 OpenAI 服务条款，风险自担
验证码时效：OpenAI 验证码有效期极短，高延迟网络下成功率低

IP 风险：VPS IP 容易被 OpenAI/Cloudflare 标记，强烈建议使用住宅代理
并发限制：同一时间只允许一个 Playwright 操作，避免竞态
服务条款：使用本工具可能违反 OpenAI 服务条款，风险自担
验证码时效：OpenAI 验证码有效期极短，高延迟网络下成功率低

autoteam-chatgpt-rotation

Original

Translation

AutoTeam — ChatGPT Team账号自动轮转管理

AutoTeam — ChatGPT Team账号自动轮转管理

安装

安装

前置条件

前置条件

一键安装

一键安装

等价于: uv sync && uv run playwright install chromium

等价于: uv sync && uv run playwright install chromium

手动安装

手动安装

编辑 data/.env 填入必要配置

编辑 data/.env 填入必要配置

配置

配置

环境变量（data/.env）

环境变量（data/.env）

临时邮箱服务（CloudMail）

临时邮箱服务（CloudMail）

CPA（CLIProxyAPI）连接

CPA（CLIProxyAPI）连接

AutoTeam API 鉴权

AutoTeam API 鉴权

ChatGPT Team 管理员账号

ChatGPT Team 管理员账号

额度阈值（低于此值触发轮转）

额度阈值（低于此值触发轮转）

Team 目标成员数

Team 目标成员数

Web 面板端口

Web 面板端口

首次启动配置向导

首次启动配置向导

首次启动自动引导配置 CloudMail、CPA、API Key 并验证连通性

首次启动自动引导配置 CloudMail、CPA、API Key 并验证连通性

CLI 命令

CLI 命令

启动 Web 面板 + HTTP API（推荐，默认端口 8787）

启动 Web 面板 + HTTP API（推荐，默认端口 8787）

智能轮转，补满到 N 个账号（默认 5）

智能轮转，补满到 N 个账号（默认 5）

查看所有账号状态和额度

查看所有账号状态和额度

检查所有账号额度

检查所有账号额度

手动添加一个新账号

手动添加一个新账号

补满成员到目标数量

补满成员到目标数量

清理多余成员

清理多余成员

同步认证文件到 CPA

同步认证文件到 CPA

管理员登录（刷新 admin session）

管理员登录（刷新 admin session）

Docker 部署

Docker 部署

快速启动

快速启动

编辑 data/.env

编辑 data/.env

docker-compose.yml 结构

docker-compose.yml 结构

Docker 常用操作

Docker 常用操作

查看实时日志

查看实时日志

重启服务

重启服务

进入容器执行 CLI

进入容器执行 CLI

停止服务

停止服务

HTTP API

HTTP API

核心端点

环境变量（
`data/.env`
）

环境变量（
`data/.env`
）

`docker-compose.yml`
结构

`docker-compose.yml`
结构