codex-auth 10大核心命令完整清单：list、login、switch、remove全解

codex-auth 10大核心命令完整清单：list、login、switch、remove全解

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

codex-auth是一款开源命令行（CLI）工具，专门用来切换和管理多个 Codex 账号，兼容 Codex CLI、VS Code 扩展和 Codex App。如果你同时使用工作账号和个人账号，只需一条命令就能在账号间快速切换。本文将带你完整了解它的 10 大核心命令：list、login、switch、remove、alias、import、export、clean、config、app，并附上常用技巧，让你成为 Codex 多账号管理高手 🚀

如何安装 codex-auth：一行命令搞定

使用 npm 全局安装即可：

npm install -g @loongphy/codex-auth

不想全局安装也可以直接临时运行：

npx @loongphy/codex-auth list

💡小提示：建议同时安装官方 Codex CLI（npm install -g @openai/codex），之后可以用codex-auth login更方便地登录并添加账号。

10 大核心命令清单总览

完整命令参考入口见 docs/commands/README.md。

list 命令：一眼查看账号用量

list是日常使用频率最高的命令，它会从registry.json读取所有账号，以表格展示账号、套餐、额度、5 小时/每周用量和最近活跃时间：

codex-auth list # 默认模式，刷新用量 codex-auth list --active # 只刷新当前活跃账号 codex-auth list --live # 实时刷新视图（需要终端 TTY） codex-auth list --skip-api # 纯本地模式，不发起远程请求 codex-auth list --json # 输出机器可读的 JSON

• 支持按邮箱分组显示同一邮箱下的多个账号快照
• 表格中的行号可直接用于switch和remove
• 远程刷新失败时会显示401、TimedOut等状态提示

详细行为说明见 docs/commands/list.md。

login 命令：快速添加新账号

login会自动调用codex login，登录成功后读取auth.json并把这个账号加入注册表，同时设为当前活跃账号：

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

⚠️ 注意：通过login添加的账号不会自动获得别名，如需别名可改用import <文件> --alias <别名>。

switch 命令：多账号秒切的核心

switch是 codex-auth 的灵魂命令，支持三种切换方式：

codex-auth switch # 打开交互选择器，方向键选择后回车 codex-auth switch 02 # 直接按行号切换 codex-auth switch work # 按别名/邮箱片段/账号名片段切换 codex-auth switch - # 一键切回上一个账号

切换成功时它会自动完成四件事：备份原auth.json→ 复制目标账号快照到~/.codex/auth.json→ 更新active_account_key→ 记录上一个活跃账号（供switch -回退使用）。

• 匹配唯一时立即切换；匹配多个时自动回落到交互选择
• --live模式切换后选择器保持打开，方便连续切换
• 加--json可输出结构化结果，适合脚本调用

更多细节参考 docs/commands/switch.md。

⚠️重要：切换账号后，Codex CLI 和 Codex App 需要重启才能生效。

remove 命令：安全删除账号

codex-auth remove # 交互式删除 codex-auth remove work # 按选择器删除（可传多个） codex-auth remove --all # 清空全部账号

它的安全设计值得点赞 ✅：

• 默认本地模式运行，删除不会被刷新任务阻塞
• 选择器匹配多个账号时会先询问确认；非 TTY 环境下模糊匹配会直接失败，防止误删
• 删除的账号如果是活跃账号，会自动晋升剩余账号并重写auth.json

alias 命令：给账号起个易记的昵称

codex-auth alias set work # 按行号/片段匹配账号，设置别名 codex-auth alias set work work # 之后 switch work 即可直达 codex-auth alias clear work # 清除别名

规则很简单：空别名和纯数字别名会被拒绝（数字保留给行号选择器），重复检测忽略大小写。

import / export：账号迁移与备份

导入支持三种场景：

codex-auth import /path/to/auth.json --alias personal # 导入单个文件 codex-auth import /path/to/folder # 批量导入文件夹内所有 .json codex-auth import --cpa <path> # 导入 CLIProxyAPI token JSON codex-auth import --purge # 注册表与文件不同步时的修复重建

导出则是 import 的镜像操作，导出的目录可以直接被import读回，方便在多台机器之间迁移账号：

codex-auth export ./backup-dir codex-auth export --cpa ./backup-dir # 导出 CLIProxyAPI 格式

详细说明见 docs/commands/import.md 和 docs/commands/export.md。

clean 命令：保持数据目录整洁

clean会清理~/.codex/accounts/下不再被引用的快照文件和过期备份，同时保留registry.json仍引用的活跃账号文件。即使注册表丢失，它也会跳过快照删除以保留恢复数据，非常稳健：

codex-auth clean # 常规清理 codex-auth clean background # 一次性移除旧版本遗留的后台任务注册

config 命令：调整实时视图刷新节奏

codex-auth config live --interval 10 # 设置 live TUI 刷新间隔（5~3600 秒）

该值会持久化保存在registry.json中，作用于list --live、switch --live等实时模式。

app 命令：实验性启动 Codex App

codex-auth app # 使用检测到的默认配置启动 codex-auth app --id <id> # 指定打包应用 ID codex-auth app --platform wsl # Windows 下选择 win / wsl / mac 运行平台

该命令会注入CODEX_HOME和CODEX_CLI_PATH等环境变量来启动 Codex App，实现新会话、恢复会话等场景下的账号切换。⚠️ 请注意：app仍是实验性功能，可能随官方 Codex App 的变动而失效，使用时风险自担。

实战技巧：高效管理多账号的 3 个心法

1. 善用选择器：行号、别名、邮箱片段、账号名片段都能作为选择器，codex-auth switch 02比输入完整邮箱快得多
2. --skip-api与--api：默认走远程 API 刷新用量（需curl可用）；--skip-api纯本地读取，更快也更安全，但本地数据可能滞后数小时
3. --json自动化：几乎所有核心命令都支持 JSON 输出，方便接入自己的 GUI 或脚本，契约见 docs/json-api.md

# 典型工作流：查看 → 切换 → 回退 codex-auth list codex-auth switch work codex-auth switch -

总结

codex-auth 用 10 个简洁的命令覆盖了 Codex 多账号管理的完整生命周期：添加（login/import）→查看（list）→切换（switch）→组织（alias）→迁移（export/import）→清理（remove/clean）。掌握这份清单，你就是多账号切换的高效使用者了 🎯

项目文档基于 v0.3.x 编写，如需体验最新功能可安装@loongphy/codex-auth@next。项目按 MIT 协议开源，数据刷新行为说明详见 README。

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