autoteam-chatgpt-rotation

AutoTeam — ChatGPT Team Account Automatic Rotation Management

Skill by ara.so — Daily 2026 Skills collection.

AutoTeam is an automation tool for managing ChatGPT Team account rotation: automatically registering accounts, obtaining Codex OAuth authentication, monitoring quota remaining, intelligently switching accounts when quota is low, and syncing authentication files to CLIProxyAPI。

Installation

Prerequisites

• Python 3.10+
• uv package manager
• Chromium (managed by Playwright)

One-Click Installation

git clone https://github.com/cnitlrt/AutoTeam.git
cd AutoTeam
bash setup.sh
# 等价于: uv sync && uv run playwright install chromium

Manual Installation

uv sync
uv run playwright install chromium
cp .env.example data/.env
# 编辑 data/.env 填入必要配置

Configuration

Environment Variables (data/.env）

# 临时邮箱服务（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

First-Launch Configuration Wizard

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

CLI Commands

# 启动 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

Docker Deployment

Quick Start

git clone https://github.com/cnitlrt/AutoTeam.git && cd AutoTeam
mkdir -p data && cp .env.example data/.env
# 编辑 data/.env
docker compose up -d

docker-compose.yml structure

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

Common Docker Operations

# 查看实时日志
docker compose logs -f autoteam

# 重启服务
docker compose restart autoteam

# 进入容器执行 CLI
docker compose exec autoteam uv run autoteam status

# 停止服务
docker compose down

HTTP API

All API requests must carry the authentication header:

Authorization: Bearer $AUTOTEAM_API_KEY

Core Endpoints

# 获取账号状态列表
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}

Python Call Example

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']}")

Web Management Panel

Access http://localhost:8787 to view the following pages:

Page	Function
📊 Dashboard	Account statistics, status table, login/remove/delete/sync operations
👥 Team Members	List of all Team members (including external members)
⚡ Operations & Tasks	One-click rotation/check/refill/cleanup/sync + task history
📋 Logs	Real-time log viewer
⚙️ Settings	Admin login + main account Codex sync + inspection configuration

How It Works

Rotation Process

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

Account State Machine

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

Common Patterns

Automated Inspection Script

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()

Configure Inspection (via API)

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())

Batch Sync Authentication Files

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()

Troubleshooting

Registration Failure / Verification Code Timeout

# 问题：验证码有效期短，网络延迟导致失败
# 解决：使用延迟低的代理，或住宅代理
# 配置代理（在 .env 中）
HTTP_PROXY=http://user:pass@proxy-host:port
HTTPS_PROXY=http://user:pass@proxy-host:port

Playwright Browser Issues

# 重新安装 Chromium
uv run playwright install chromium

# Docker 中确认浏览器依赖
docker compose exec autoteam uv run playwright install-deps chromium

CPA Sync Failure

# 验证 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"

Account Banned / IP Flagged

# 症状：注册成功率低，频繁出现 Cloudflare 挑战
# 解决方案：
# 1. 使用住宅代理（非 VPS IP）
# 2. 降低注册频率，在 .env 中增加延迟
REGISTER_DELAY_SECONDS=30

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

View Detailed Logs

# CLI 模式下增加详细输出
uv run autoteam rotate --verbose

# Docker 中查看完整日志
docker compose logs --tail=200 autoteam

# Web 面板实时日志
# 访问 http://localhost:8787 → 日志页面

Database Reset

# 清除本地数据（保留配置）
rm data/autoteam.db

# 重新启动后会自动初始化
uv run autoteam api

Project Structure

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

Important Limitations

• IP Risk: VPS IPs are easily flagged by OpenAI/Cloudflare; using residential proxies is strongly recommended
• Concurrency Limit: Only one Playwright operation is allowed at a time to avoid race conditions
• Terms of Service: Using this tool may violate OpenAI's Terms of Service; use at your own risk
• Verification Code Validity: OpenAI verification codes have an extremely short validity period, resulting in a low success rate on high-latency networks