如何5分钟安装上手codex-auth：新手快速开始Codex账号切换教程
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
codex-auth是一款开源的 Codex 账号切换 CLI 工具，帮你在一台机器上同时管理多个 Codex 账号，并快速切换当前生效的账号。它支持 Codex CLI、VS Code 扩展和 Codex App 三种客户端，5 分钟即可完成安装、添加账号和第一次切换。🚀
什么是 codex-auth？
简单来说，codex-auth解决的是这样的痛点：你有多封邮箱/多个 Codex 账号，但 Codex 默认只认~/.codex/auth.json里的那一个。
codex-auth会把每个账号的凭据统一保存在账号注册表中（~/.codex/accounts/registry.json），让你可以：
- 用
list一眼看到所有账号的套餐与额度用量； - 用
switch交互式或一行命令切换到任意账号； - 用
import/export批量迁移账号。
项目核心实现位于 src/ 目录，采用 Zig 编写，跨平台分发 npm 包（详见 docs/windows.md 了解 Windows 支持）。
一键安装 codex-auth（npm 全局安装）
确保机器上已安装 Node.js，然后执行：
npm install -g @loongphy/codex-auth不想全局安装？也可以直接用npx临时运行：
npx @loongphy/codex-auth list💡 提示：建议同时安装官方 Codex CLI，这样添加账号会更简单：
npm install -g @openai/codex
如果你尝鲜最新特性，可以安装 alpha 版本（当前文档基于 v0.3.x）：
npm install -g @loongphy/codex-auth@next当然，也支持从源码构建，仓库地址为https://gitcode.com/gh_mirrors/co/codex-auth，构建脚本与发布流程见 docs/release.md。
添加第一个账号：codex-auth login
安装完成后，第一条命令就是登录。它会自动调用codex login完成认证，再把当前账号存入注册表并设为生效账号（行为细节见 docs/commands/login.md）：
codex-auth login如果你的设备不方便走浏览器回调，可以用设备码模式：
codex-auth login --device-auth登录成功后，auth.json会被备份，账号快照存入~/.codex/accounts/目录，随时可以切回来。
快速切换账号：codex-auth switch 用法
添加好几个账号后，switch就是你的主力命令（完整规则见 docs/commands/switch.md）：
# 交互式选择器，方向键/回车切换 codex-auth switch # 直接按行号或账号片段切换，一条命令搞定 codex-auth switch 02 codex-auth switch work # 切回上一个账号，非常顺手 codex-auth switch -查询式切换支持按行号、别名、邮箱片段、账号名片段匹配；匹配到多个账号时会自动退回交互选择。切换成功后，auth.json会被更新为新账号的快照。
⚠️ 重要提醒：对Codex CLI和Codex App用户，切换账号后需要重启客户端，新账号才会生效。
查看账号列表与额度用量
list命令会以表格展示所有已存账号的套餐、Credits、5 小时/每周用量和最近活动（用法见 docs/commands/list.md）：
codex-auth list # 默认带 API 刷新，数据最新 codex-auth list --active # 只刷新当前账号的用量 codex-auth list --live # 终端内实时刷新 codex-auth list --skip-api # 纯本地数据，不发起远程请求额度数据不会刷新时，可以对比--skip-api与默认模式排查原因，官方 FAQ 中已有说明。
进阶操作：别名、导入导出与清理
多账号管理到一定规模后，这些命令会让你事半功倍（命令清单见 docs/commands/README.md）：
# 给账号起别名，切换更快 codex-auth alias set work mywork codex-auth alias clear mywork # 导入 auth 文件（单个文件或整个文件夹） codex-auth import /path/to/auth.json --alias personal # 导出所有账号的凭据文件，方便备份迁移 codex-auth export # 删除账号（交互选择或直接指定） codex-auth remove work codex-auth remove --all # 清理备份与过期文件 codex-auth clean常见问题（新手必看）
Q：为什么额度用量不刷新？默认走 API 刷新（需系统有curl）；加--skip-api则读本地会话文件，但数据可能滞后数小时。
Q：切换后客户端里还是旧账号？Codex CLI / Codex App 需要重启后新账号才生效；VS Code 扩展则可以直接生效。
Q：如何卸载？
npm uninstall -g @loongphy/codex-auth更多学习资源
- 命令参考总览：docs/commands/README.md
- JSON 输出接口（方便接入自己的脚本/GUI）：docs/json-api.md
- 表格布局规则：docs/table-layout.md
- 版本发布说明：CHANGELOG.md
现在，打开终端敲下npm install -g @loongphy/codex-auth，5 分钟后你就能在多个 Codex 账号之间自由穿梭了。✨
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
