codex-session

Zero-friction multi-account session switcher for Codex CLI

---

这是什么 / What

Codex 只支持单账号登录。多个 ChatGPT 账号（不同 Plan、不同 Team、不同 Org）来回切换，需要手动删除 auth.json、手动复制备份。

codex-session 把这个流程变成一行命令。每次运行自动保存当前 token，切换账号瞬间完成。

同邮箱多身份（如 free + team）也完美支持 — 目录结构按 email/account_id 二级组织，不会互相覆盖。

Codex supports only a single login. Switching between ChatGPT accounts means manually deleting and copying auth.json files. codex-session reduces this to a single command — auto-saves your current session, switches instantly.

Same email, multiple identities (e.g. free + team) are fully supported — the two-level email/account_id directory structure prevents overwrites.

安装 / Install

git clone https://github.com/hicancan/codex-session.git <your-path>
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;<your-path>", "User")

将 <your-path> 替换为你想存放的位置（如 D:\tools\codex-session），重启终端后 codex-session 全局可用。

使用 / Usage

# 显示已保存账号，选择切换（紧凑模式）
codex-session

# 全量字段对比表（含完整 account_id、org_id）
codex-session list

# 精确切换（同邮箱多身份时自动提示选择）
codex-session switch user@example.com

# 按 email + plan 切换
codex-session switch user@example.com:free

# 按 email + account_id 前缀切换
codex-session switch user@example.com:f51bce00

# 按 account_id 前缀全局搜索切换
codex-session switch f51bce00

# 模糊匹配 email
codex-session switch user

# 保存当前 session 并删除 auth.json，准备登录新号
codex-session logout

Switch 匹配策略 / Matching Strategy

输入	匹配逻辑
email	精确匹配 email → 唯一则切换，多个则列出 plan/account_id
email:<plan>	email + plan_type 精确定位
email:<acct_prefix>	email + account_id 前缀精确定位
<acct_prefix>	全局搜索 account_id 前缀 → 唯一则切换
<fuzzy>	模糊匹配 email → 唯一则切换

原理 / How It Works

Codex 登录 → ~\.codex\auth.json 生成
     ↓
codex-session  →  自动保存到 sessions\<email>\<account_id>\auth.json
     ↓
codex-session switch xxx  →  覆盖 ~\.codex\auth.json，完成切换

• 自动保存 — 每次运行都持久化当前 session，token 永不过期

• 自动覆盖 — 同 email + 同 account_id 自动覆盖，始终最新

• 同邮箱多身份 — 不同 account_id 分目录存储，互不覆盖

• 自动清理 — logout 自动保存 + 删除，为登录新号准备

• Auto-save — persists current session on every invocation

• Auto-overwrite — same email + same account_id sessions overwritten, always fresh

• Multi-identity — same email, different account_ids coexist in separate directories

• Auto-cleanup — logout saves + deletes, ready for new login

安全 / Security

问题	答案
token 会推到 GitHub 吗？	不会。sessions/ 目录已在 .gitignore 中
其他人能看到我的 token 吗？	不能。所有 session 数据仅在本地
token 刷新了怎么办？	每次运行自动保存，始终跟着官方刷新

No. sessions/ is gitignored. Only the script itself is tracked. All tokens stay local.

文件结构 / Structure

codex-session/
├── .gitignore              # 忽略 sessions/（token 安全）
├── codex-session.cmd        # CMD 入口 → pwsh
├── codex-session.ps1        # 主脚本，纯 PowerShell，零依赖
└── sessions/                # 账号数据（gitignored）
    ├── <email>/
    │   └── <account_id>/    # 完整 UUID，全局唯一 session 标识
    │       └── auth.json
    ├── alice@gmail.com/
    │   ├── f51bce00-9872-4a18-acf3-0fcae3d0911c/  # free 个人
    │   │   └── auth.json
    │   └── 61f07e41-95b2-446a-b6b8-b168fdf27f15/  # team 成员
    │       └── auth.json
    └── bob@outlook.com/
        └── 61f07e41-95b2-446a-b6b8-b168fdf27f15/
            └── auth.json

License

MIT