codex-auth 10大核心命令完整清单list、login、switch、remove全解【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-authcodex-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 CLInpm install -g openai/codex之后可以用codex-auth login更方便地登录并添加账号。10 大核心命令清单总览命令一句话说明详细文档list列出所有已保存账号及使用状态docs/commands/list.mdlogin运行codex login并添加当前账号docs/commands/login.mdswitch交互式或直接切换活跃账号docs/commands/switch.mdremove删除账号支持按选择器或清空全部docs/commands/remove.mdalias为账号设置/清除别名方便记忆docs/commands/alias.mdimport导入 auth 文件或批量导入文件夹docs/commands/import.mdexport导出已保存账号的 auth 文件docs/commands/export.mdclean清理过期的备份和失效账号文件docs/commands/clean.mdconfig配置 live TUI 刷新间隔docs/commands/config.mdapp实验性带账号注入启动 Codex Appdocs/commands/app.md完整命令参考入口见 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.jsonalias 命令给账号起个易记的昵称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 Appcodex-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 个心法善用选择器行号、别名、邮箱片段、账号名片段都能作为选择器codex-auth switch 02比输入完整邮箱快得多--skip-api与--api默认走远程 API 刷新用量需curl可用--skip-api纯本地读取更快也更安全但本地数据可能滞后数小时--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-authnext。项目按 MIT 协议开源数据刷新行为说明详见 README。【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考