企业官网建设流程全解析

Codex多账号切换神器codex-auth：一个工具搞定Codex账号管理完全指南

【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth

codex-auth是一款专治 Codex 多账号切换难题的命令行神器 🚀。它让你在一个终端里登录、切换、管理多个 Codex 账号，实时查看每个账号的用量额度，告别手动复制粘贴auth.json的繁琐操作。无论是个人号、团队号还是 API Key 账号，一个工具统统搞定。

为什么需要 Codex 账号切换工具？

如果你同时拥有多个 Codex/ChatGPT 账号（个人、工作、团队），大概率遇到过这些痛点：

• 🔄手动切换麻烦：每次都要备份~/.codex/auth.json，再换回另一个账号的凭证文件
• 📊额度看不到：不知道当前账号的 5 小时窗口和周额度还剩多少
• 📦账号难管理：多个auth.json散落在各目录，不知道哪个是哪个
• 🆓重启客户端：切换后还要重启 Codex CLI 或 App 才能生效

codex-auth正是为了解决这些问题而生：它统一管理所有账号快照，一条命令完成切换，还能实时刷新用量数据。它兼容Codex CLI、VS Code 扩展和Codex App三种客户端。

快速安装：两条命令上手

安装非常简单，通过 npm 全局安装即可：

npm install -g @loongphy/codex-auth

不想全局安装也可以直接用npx运行：

npx @loongphy/codex-auth list

💡提示：建议同时安装 Codex CLI（npm install -g @openai/codex），这样后续添加账号会更顺畅，即使用 VS Code 扩展也建议装。

新手最快上手三步

1. 登录账号：codex-auth login（或--device-auth设备码登录）
2. 查看账号：codex-auth list，表格化展示所有账号和额度
3. 一键切换：codex-auth switch，交互式选择或用codex-auth switch 02直接切换

核心命令详解

1️⃣ codex-auth list：账号与用量总览

list命令会列出所有已存储账号，并同步刷新用量数据，展示计划（PLAN）、积分（CREDITS）、5小时窗口、周额度等列。

codex-auth list # 全部账号 + API 实时刷新用量 codex-auth list --active # 只刷新当前激活账号，速度更快 codex-auth list --live # 实时 TUI 视图，自动定时刷新 codex-auth list --skip-api # 仅本地数据，不发网络请求

--live模式会打开持续刷新的终端表格，支持鼠标滚轮滚动，方便长时间监控多个账号的额度变化。

2️⃣ codex-auth switch：一键切换账号

这是最核心的命令，支持三种切换方式：

codex-auth switch # 打开交互式账号选择器 codex-auth switch 02 # 按行号直接切换 codex-auth switch work # 按别名/邮箱片段匹配切换 codex-auth switch - # 快速切回上一个账号

切换成功后，工具会自动备份当前auth.json、写入新账号快照并记录切换历史，详见 docs/commands/switch.md。switch --live还会让选择器保持打开，切换后界面立即更新，无需重新执行命令。

⚠️注意：切换账号后，Codex CLI 和 Codex App 用户需要重启客户端才能使新账号生效。

3️⃣ codex-auth login：登录并自动入库

login会先运行codex login完成官方登录流程，然后把新账号自动导入统一管理：

codex-auth login # 浏览器登录 codex-auth login --device-auth # 设备码登录（适合无浏览器环境）

登录成功后该账号会自动设为激活状态，无需手动导入，详见 [docs/详见 docs/commands/login.md。

4️⃣ codex-auth import / export：账号导入与导出

批量导入导出的利器，适合多机同步或备份迁移：

codex-auth import /path/to/auth.json --alias personal # 导入单个账号文件 codex-auth import ./auth_folder # 批量导入目录 codex-auth export ./backup # 导出所有账号快照

导出的目录可以直接用import再导入，完美闭环。另外还支持--cpa导入/导出 CLIProxyAPI 的 token JSON，详见 docs/commands/import.md 和 docs/commands/export.md。

5️⃣ codex-auth alias：给账号起别名

账号多了之后，给常用账号起个短别名，切换效率翻倍：

codex-auth alias set 01 work # 设置别名 codex-auth alias clear work # 清除别名

设置后，列表会显示为work(test@example.com)格式，之后codex-auth switch work即可精准切换，详见 docs/commands/alias.md。

6️⃣ codex-auth remove / clean：清理与维护

codex-auth remove work # 按选择器删除账号 codex-auth remove --all # 清空所有账号 codex-auth clean # 清理备份和过期快照

高级玩法 🎮

实时 TUI 监控

v0.3 版本主打的Live TUI体验：list --live、switch --live、remove --live都会打开持续刷新的终端表格，支持鼠标滚轮滚动、原生文本选择复制。刷新间隔可通过配置调整：

codex-auth config live --interval 30 # 设置 30 秒刷新一次

Codex App 无重启切换（实验性）

codex-auth app

实验性命令，可让 Codex App 在不重启的情况下切换账号，支持新会话、恢复会话和继续中断的对话。该功能仍在快速演进中，详见 docs/commands/app.md。

JSON 输出：为自研 GUI 打基础

list、switch <query>、remove都支持--json参数，输出机器可读的 JSON 文档，方便你基于它开发图形界面工具。接口契约详见 docs/json-api.md。

常见问题 FAQ

Q：用量额度为什么没刷新？默认走 API 实时刷新；如果加了--skip-api，则读取本地~/.codex/sessions/下的记录文件，数据可能滞后数小时。想要最新数据请用默认的 API 模式。

Q：切换后为什么没生效？Codex CLI 和 Codex App 用户请重启客户端再试。

Q：从旧版本升级要注意什么？v0.3.0 移除了后台自动切换功能（用codex-auth clean background清理旧注册），registry 索引已自动迁移到schema_version 4，详见 CHANGELOG.md。

Q：用量数据从哪来？API 模式会向 OpenAI 端点发起请求刷新用量和团队名称；本地模式只扫描本地文件，更安全但可能滞后。完整说明见 docs/api.md 与 README.md。

命令速查表 ⚡

总结

codex-auth把 Codex 多账号管理压缩成了几行简洁的命令：login入库、list看额度、switch一键切换、import/export批量迁移，配合 Live TUI 和 JSON 输出，个人号与团队号混用的场景下尤其省心。如果你正在为 Codex 账号来回切换而头疼，这个免费开源的 CLI 工具值得一试 💪

【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth