不重启也能切换Codex App账号？codex-auth实验性app命令全解
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
codex-auth 是一款用于切换和管理 Codex 账号的命令行工具，支持 Codex CLI、VS Code 扩展与 Codex App 三类客户端。它的实验性app命令可以通过按进程注入环境变量，为 Codex App 动态指定一个托管的 codext CLI，从而让 Codex App 不重启也能切换账号——无论是新建对话、恢复旧会话，还是继续之前中断的对话，都能直接生效。本文带你完整看懂这个实验性命令的用法、参数与注意事项。
为什么切换账号总要重启 Codex 客户端？
Codex 各客户端启动时会加载一次认证信息。用switch切换账号后，通常要重启客户端才能让新账号生效。
而app命令的思路是：既然账号信息由 CLI 侧读取，那就在启动 Codex App 的这一次进程里注入环境变量CODEX_CLI_PATH，把官方 App 指向一个受管（managed）的 codext CLI。新 CLI 会读取当前活跃账号的认证快照，于是 App 无需重启就能"看到"新账号。
这个机制在 README.md 的 Codex App 一节中有专门说明，行为细节则记录在 docs/commands/app.md。
app 命令如何工作
执行codex-auth app时，命令会按以下顺序运行（核心逻辑见 src/workflows/app.zig）：
- 解析平台与 App ID：按
--platform或自动检测确定win/wsl/mac，并解析要启动的应用包。 - 检查 App 是否已在运行：若 Codex App 已打开，直接打印
Codex App is already running, launch skipped.并退出，不会重复启动。 - 解析 CLI 路径：若未显式指定，会自动检查托管缓存中是否有对应平台的 codext CLI；版本不一致或缺失时自动下载最新 release。
- 打印启动计划：在启动前把 Platform、Codex Home、App ID、CLI Path 等信息输出到终端，方便核对。
- 启动 App：Windows 走系统 GUI 启动器，macOS 按 bundle identifier 打开应用，环境变量只对这次启动生效，不会污染你的 shell。
app 命令上手步骤
第一步：安装 codex-auth
npm install -g @loongphy/codex-auth也可以免安装直接运行：
npx @loongphy/codex-auth list第二步：确认账号已就绪
建议先安装官方 Codex CLI，让login更省事：
npm install -g @openai/codex codex-auth login然后用 list 命令 查看账号列表与用量：
codex-auth list第三步：切换目标账号
codex-auth switch会打开交互式账号选择器；也可以直接按行号或别名/邮箱片段切换：
codex-auth switch 02 codex-auth switch work规则详见 docs/commands/switch.md。
第四步：用 app 启动 Codex App
codex-auth app若托管 CLI 需要更新，你会看到类似输出（示例来自 docs/windows.md）：
- Checking latest codext release... Downloading Codext CLI for WSL (v0.3.0) OK Downloaded Codext CLI for WSL (v0.3.0) - Environment Configuration ------------------------------------------------ Platform: WSL (auto-detected) Codex Home: C:\Users\Alice\.codext (explicit) App ID: OpenAI.Codex (default) CLI Path: C:\Users\Alice\.codext\accounts\codext-cli\codex-linux-x64 (downloaded) ---------------------------------------------------------------------------- Launching Codex App...App 启动后，新会话即使用当前切换后的账号；之后再次switch+app，就能在不重启的情况下换账号。想回到上一个账号时，codex-auth switch -一键切回非常方便。
app 参数速查表
参数解析实现在 src/cli/commands/app.zig，常用选项如下：
| 选项 | 作用 | 默认值 |
|---|---|---|
--id <id> | 指定要启动的应用包（Windows 传包名/AUMID，macOS 传 bundle identifier） | WindowsOpenAI.Codex，macOScom.openai.codex |
--codex-cli-path <path> | 显式注入CODEX_CLI_PATH，路径必须存在 | 自动解析托管 codext CLI |
--codex-home <path> | 注入CODEX_HOME，并决定使用哪套账号缓存 | 自动解析（CODEX_HOME→~/.codex） |
--platform win\|wsl\|mac | 选择运行平台；win/wsl会同步写入桌面端 WSL 设置 | 自动检测 |
--std | 以标准输出模式启动，日志直接打到终端，适合调试 | GUI 静默启动 |
注意app没有launch子命令，直接运行codex-auth app即是启动。
平台参数 win / wsl / mac 怎么选
- win：让 App 在 Windows 原生环境运行 agent，并选择 Windows 版托管 CLI。
--codex-cli-path必须是 Windows 进程能直接启动的可执行路径，不能填 WSL 里的命令名。 - wsl：让 App 在 WSL 内运行 agent，并选择 Linux 版托管 CLI。
- mac：直接启动 macOS 版 App；macOS 打包版默认使用
Contents/Resources/codex，显式设置--codex-cli-path会优先于内置 CLI。
未指定--platform时，Windows 会读取$CODEX_HOME/config.toml中的[desktop].runCodexInWindowsSubsystemForLinux设置自动判断（见 src/workflows/app.zig）；显式传入win或wsl时则会更新该设置。macOS 默认为mac。
托管 CLI 如何下载与缓存
省略--codex-cli-path时，app会拉取 codext 的最新 release 元数据，与本地缓存版本比对：
- 已缓存且版本一致：直接复用，跳过下载；
- 缺失或版本不同：只下载当前 CPU 架构对应的资产（如
win32-x64、linux-x64、darwin-arm64）。
缓存固定存放在：
$CODEX_HOME/accounts/codext-cli/codex-<platform> $CODEX_HOME/accounts/codext-cli/codex-<platform>.version整个下载、解压与版本记录流程可在 src/workflows/app.zig 中查看。
常见报错与排查
启动前，命令会先校验所有显式选项并一次性列出全部问题，而不是逐个报错，格式如下：
ERROR: --id: App ID does not exist "OpenAI.Codex" ERROR: --codex-cli-path: Path does not exist "C:\Program Files\..."排查建议：
- 提示 App 已在运行：先关闭 Codex App 再执行
app，否则命令会安全跳过启动； - App ID 不存在：检查
--id拼写；Windows 也可传完整 AUMID； - CLI 路径错误：显式路径必须真实存在且是文件，否则删掉该参数让工具自动解析；
- Windows 下行为异常：请确认运行的是 Windows 版
codex-auth.exe——WSL 构建无法启动 Windows App 包。
开始前的注意事项 ⚠️
app命令目前是实验性功能，官方明确提示它可能永远不稳定（详见 CHANGELOG.md 与 README.md）：
- 它依赖
CODEX_CLI_PATH注入机制，受官方 Codex App 与 Codex CLI 持续变动的影响，可能不生效； - 极端情况下可能影响 App 的正常运行，重要会话请先备份；
- 若你更在意稳定性，日常仍建议：
switch切换后重启客户端，或使用增强版 codext CLI 获得无缝自动切换。
写在最后
codex-auth app用一行命令把"切账号 → 重启 App"的循环压缩成"切账号 → 再启动一次 App"，新对话、恢复会话、续聊三种场景都能直接切换账号。虽然仍属实验性能力，但配合清晰的启动计划输出与完善的参数校验，已经足够在 Windows、WSL、macOS 上大胆试用。完整的命令参考请查阅 docs/commands/README.md 与 docs/commands/app.md。
【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
