如何在Windows上流畅使用codex-authPowerShell、ANSI颜色与WSL兼容完整指南【免费下载链接】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 三种客户端。在 Windows 上使用它时新手最常遇到三个问题PowerShell 里乱码或颜色异常、ANSI 颜色序列显示成奇怪符号、以及不知道 WSL 和原生 Windows 两种模式怎么选。本指南带你逐一解决这些问题让账号切换体验像 Mac 一样顺滑。一键安装步骤在 Windows 上快速装好 codex-auth只要装好了 Node.js建议 18打开 PowerShell 或 Windows Terminal执行下面任意一条命令即可# 全局安装之后可直接使用 codex-auth 命令 npm install -g loongphy/codex-auth # 或者不安装临时运行 npx loongphy/codex-auth list 官方建议即使你主要用 VS Code 扩展或 Codex App也推荐安装 Codex CLInpm install -g openai/codex。这样可以用codex-auth login一键完成登录并添加账号流程最简单。安装完成后用这条命令验证是否成功codex-auth list --skip-api最快配置方法账号管理与切换的日常用法codex-auth 把账号统一保存在 Codex 主目录下Windows 上默认解析为USERPROFILE/.codex详见 docs/commands/README.md。日常最核心的四条命令命令作用codex-auth login运行codex login并把当前账号加入管理列表codex-auth list列出已保存账号与用量状态codex-auth switch交互式选择并切换活跃账号codex-auth switch 02直接按行号或账号选择器切换# 交互式切换带 TUI 选择器 codex-auth switch # 给账号起个别名切换更直观 codex-auth alias set work 工作号 codex-auth switch 工作号 # 导入 / 导出账号多设备同步利器 codex-auth import ./auth.json --alias personal codex-auth export ./backup⚠️ 注意切换账号后Codex CLI 和 Codex App 需要重启客户端新账号才会生效。各命令的完整说明见 docs/commands/ 目录下的对应文档如 login.md、switch.md。PowerShell 乱码、颜色异常怎么办ANSI 颜色兼容原理这是 Windows 用户最关心的部分。不同 Windows 控制台宿主PowerShell、Windows Terminal、cmd.exe、CI 日志对 UTF-8 和 ANSI 转义序列的处理方式并不相同因此 codex-auth 对 Windows 输出做了保守化处理规则定义在 docs/windows.md核心实现在 src/terminal/color.zig。它的工作逻辑非常聪明只在 TTY真实终端输出时启用颜色——输出被重定向到文件时自动变纯文本日志里不会出现花里胡哨的转义码设置NO_COLOR环境变量可全局关闭颜色先探测再输出程序会通过 Windows API 检查目标控制台句柄是否已开启ENABLE_VIRTUAL_TERMINAL_PROCESSING虚拟终端处理。若未开启会尝试主动开启只有确认开启成功才会输出 ANSI 颜色无法验证时优雅降级回退为纯文本绝不输出可能乱码的 ANSI 转义序列。同时Windows 下的状态标记默认使用ASCII 字符如OK、-不会出现勾号、警告符号、项目符号等 Unicode 字形从根源上避免了 PowerShell 老版本编码下的小方框乱码。示例输出Codex App is already running, launch skipped. - Checking latest codext release... Downloading Codext CLI for WSL (v0.3.0) OK Downloaded Codext CLI for WSL (v0.3.0) 如果你看到颜色显示正常但担心某些环境异常最简单的兜底就是设置NO_COLOR或直接使用 Windows Terminal它对虚拟终端支持最完整。WSL 兼容指南原生 Windows 与 WSL 双模式怎么选codex-auth 对 Windows 子系统的支持体现在两个层面1. 路径解析自动适配两种环境命令解析 Codex 主目录codex_home的顺序是CODEX_HOME环境变量 →HOME/.codex→ Windows 下的USERPROFILE/.codex实现见 src/registry/common.zig。这意味着你既可以在 WSL 里直接运行 Linux 版 codex-auth也可以在 Windows 原生环境运行两边各自读取对应系统的主目录互不冲突。2.app命令用--platform选择运行时平台实验性的app命令用于启动 Codex App 并实现免重启换号它通过--platform明确指定运行模式详细说明见 docs/commands/app.md# 以 Windows 原生方式运行自动检测为默认 codex-auth app --platform win # 让 App 在 WSL 内运行 agent并选用 Linux 托管 CLI codex-auth app --platform wslwin写入 Windows 桌面设置App 原生运行并选择 Windows 托管 CLIwsl写入桌面设置让 agent 在 WSL 中运行并选择 Linux 托管 CLI省略参数时程序会读取$CODEX_HOME/config.toml中的[desktop].runCodexInWindowsSubsystemForLinux配置自动判断实现见 src/workflows/app.zig。⚠️ 两个常见坑Windows 原生启动时--codex-cli-path必须指向 Windows 进程可以启动的可执行文件路径WSL 里的命令名如codex-custom不是合法路径托管 CLI 会缓存到$CODEX_HOME/accounts/codext-cli/codex-platform版本不同才会重新下载不会重复占用网络。一个容易忽略的细节curl 依赖codex-auth 默认通过 API 刷新账号用量与团队名所有请求经由系统curl发起见 docs/api.md。Windows 10/11 自带 curl一般无需处理如果你的环境找不到 curlJSON 模式下会报curl_unavailable错误有两个选择# 1. 确保 curl 在 PATH 中Windows 通常默认满足 where curl # 2. 或临时改用本地模式跳过 API 刷新 codex-auth list --skip-api常见问题速查QAQ1PowerShell 里输出的表格边框是断开的优先改用 Windows Terminal旧版控制台宿主对等宽字符渲染不佳属于宿主限制而非工具 bug。Q2WSL 里登录的账号和 Windows 原生里的账号能互相看见吗不能直接共享因为两边主目录不同HOME/.codexvsUSERPROFILE/.codex。可用codex-auth export导出一侧、codex-auth import导入另一侧完成迁移。Q3如何让app每次都固定用 WSL 模式用codex-auth app --platform wsl显式指定一次即可该设置会写回桌面配置项后续省略参数也会自动沿用。Q4想升级到最新特性安装 alpha 版本npm install -g loongphy/codex-authnext见 README.md 中的版本说明。总结在 Windows 上使用 codex-auth 其实没有任何坑颜色有自动探测与降级保护状态输出坚持 ASCII 保证乱码免疫路径解析同时兼容USERPROFILE原生与HOMEWSL两套环境app命令再用--platform帮你锁定运行时。只要按上文完成安装与基础配置你就可以放心地在 PowerShell 或 WSL 中管理多个 Codex 账号了 更多细节建议查阅项目文档docs/windows.md、docs/commands/README.md、docs/api.md。【免费下载链接】codex-authA CLI tool to switch and manage Codex accounts项目地址: https://gitcode.com/gh_mirrors/co/codex-auth创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考