ClaudeX 是一个用于自动化创建 Claude 账号，并保存账号的会话状态等数据的Cli工具

注意：本项目会请求 claude.ai 。请确认你的使用方式符合相关服务条款、当地法律法规要求。

• 批量注册账号：生成临时邮箱、发送 Claude magic link、读取验证邮件、换取会话 Cookie。
• 并发执行注册：通过 -j/--concurrent 控制并发数量。
• 保存账号记录：默认写入 accounts.json。
• 批量检查账号：读取账号 Cookie，查询账号状态、套餐和模型限制。
• 支持代理：注册请求可通过 PROXY 配置代理。
• 支持按账号派生请求头标识：同一账号保持稳定，不同账号分散。

.
├── main.py                 # CLI 入口
├── requirements.txt        # Python 依赖
├── .env.example            # 环境变量示例
├── accounts.json           # 账号记录文件，本地敏感文件
└── claudex/
    ├── accounts.py         # 账号文件读写与账号池
    ├── check.py            # 账号状态和用量检查
    ├── config.py           # 环境变量、请求头和代理配置
    ├── moemail.py          # MoeMail API 客户端
    ├── register.py         # 注册流程
    └── session.py          # requests Session 工具

• Python 3.9+
• 可访问的 MoeMail 服务
• MoeMail API Key

安装依赖：

pip install -r requirements.txt

复制示例环境变量：

cp .env.example .env

Windows PowerShell 可以使用：

Copy-Item .env.example .env

至少需要配置：

MOEMAIL_API_KEY=mk_your_api_key_here
MOEMAIL_BASE_URL=https://your-moemail-instance.example.com

常用配置项：

注册 1 个账号：

python main.py register

注册 10 个账号，并发 3 个任务：

python main.py register -n 10 -j 3

使用指定账号文件：

python main.py --accounts data/accounts.json register -n 5

注册成功后，账号记录会追加写入 accounts.json。

检查默认账号文件：

python main.py check

检查指定账号文件：

python main.py --accounts data/accounts.json check

检查命令会输出每个账号的状态、套餐和部分模型限制。如果 Cookie 失效，会标记为过期或错误。

accounts.json 是一个 JSON 数组，每条记录大致如下：

[
  {
    "email": "example@domain.com",
    "uuid": "account_uuid",
    "email_address": "example@domain.com",
    "org_uuid": "organization_uuid",
    "org_name": "Organization Name",
    "cookies": {
      "sessionKey": "..."
    },
    "saved_at": "2026-07-10T10:00:00Z"
  }
]

该文件包含登录 Cookie，等同于账号会话凭据。请只保存在本机可信目录，不要上传到代码仓库或发送给他人。

注册流程位于 claudex/register.py：

1. 检查当前出口 IP。
2. 从 MoeMail 获取可用邮箱域名。
3. 创建临时邮箱。
4. 查询 Claude 登录方式。
5. 发送 magic link。
6. 轮询临时邮箱并提取 nonce。
7. 验证 magic link，保存账号信息和 Cookie。

检查流程位于 claudex/check.py：

1. 读取 accounts.json。
2. 用保存的 Cookie 创建会话。
3. 请求 Claude 账号和组织访问接口。
4. 输出账号状态、套餐和模型限制。

• .env 和 accounts.json 都是敏感文件，已在 .gitignore 中排除时也不要手动提交。
• 并发注册可能触发目标服务的频率限制，建议从较小并发开始。
• check 命令当前使用直连请求，不读取 PROXY。
• 源码中的部分中文注释和 CLI 帮助文本存在编码损坏，不影响主要逻辑，但后续可以统一修复为 UTF-8。
• Claude Web 接口可能随时间变化；如果出现非 JSON 响应、401、403、429 或接口字段缺失，需要根据实际响应更新代码。

本项目没有额外构建步骤。常用命令：

python main.py --help
python main.py register -n 1
python main.py check

建议在修改网络请求逻辑后，至少验证：

• .env 能正确加载。
• MoeMail 配置接口可用。
• 注册失败时不会破坏已有 accounts.json。
• check 能正确识别正常、过期和错误账号。

欢迎提交 issue 和 pull request。参与贡献前请阅读 CONTRIBUTING.md，并确认不会提交 .env、accounts.json、Cookie、API Key 或代理凭据。

本项目基于 MIT License 开源。