不重启也能切换Codex App账号codex-auth实验性app命令全解【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-authcodex-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 等信息输出到终端方便核对。启动 AppWindows 走系统 GUI 启动器macOS 按 bundle identifier 打开应用环境变量只对这次启动生效不会污染你的 shell。app 命令上手步骤第一步安装 codex-authnpm 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 Appcodex-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 启动后新会话即使用当前切换后的账号之后再次switchapp就能在不重启的情况下换账号。想回到上一个账号时codex-auth switch -一键切回非常方便。app 参数速查表参数解析实现在 src/cli/commands/app.zig常用选项如下选项作用默认值--id id指定要启动的应用包Windows 传包名/AUMIDmacOS 传 bundle identifierWindowsOpenAI.CodexmacOScom.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 版 AppmacOS 打包版默认使用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 也可传完整 AUMIDCLI 路径错误显式路径必须真实存在且是文件否则删掉该参数让工具自动解析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），仅供参考