codex更新失败需先判断类型：若codex --version显示版本过低且命令报“版本过旧”，说明协议不兼容，须手动替换二进制文件；若能正常输出版本但codex run连接auth.openai.com失败，则属网络问题，应检查代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex版本更新失败时，自动更新机制常因网络拦截、权限不足或配置残留卡死在“正在安装”状态，而错误提示却只显示“版本过旧”，根本看不出真实原因。
先确认你遇到的是哪类失败
打开终端，执行：codex --version。如果返回的版本号比官网最新版低两小版本以上（如官网是3.4.2，你显示3.2.0），且运行任意命令都报“此环境中的Codex版本过旧”，说明不是网络更新失败，而是本地二进制文件与远程服务协议已不兼容——这种情况必须手动替换可执行文件，不能靠npm install -g或codex update修复。
如果codex --version能正常输出，但codex run报错“Failed to connect to auth.openai.com”，则属于网络层问题，应优先检查代理配置，而非升级程序本身。
方法一：Windows/macOS/Linux 通用的手动二进制替换法
第一步：访问官方 GitHub Releases 页面，找到对应系统架构的最新 codex-x.x.x 可执行文件（非源码包，非 .msix，非 .deb）。
第二步：关闭所有正在运行的 Codex 进程，包括后台可能残留的 codex daemon 或通过 VSCode 插件启动的子进程。
第三步：将新下载的二进制文件直接复制到原安装路径，覆盖旧文件。Linux/macOS 用户需执行：sudo cp ./codex /usr/local/bin/codex；Windows 用户请用资源管理器右键“以管理员身份粘贴”。【跳过此步会导致权限拒绝，且无明确报错】
第四步：在全新终端窗口中运行 codex --version 验证。若仍显示旧版本，请检查是否 PATH 中存在多个 codex —— 运行 which codex（macOS/Linux）或 where codex（Windows）定位真实路径。
方法二：离线安装包回退（适用于 UI 失效/中文消失/插件崩溃）
从每日更新的 Codex 历史版本合集下载你需要的稳定旧版：https://pan.quark.cn/s/ea9b32048698。
解压后找到 CodexSetup.exe（Windows）或 Codex-x.x.x.dmg（macOS），双击运行。安装向导会自动卸载当前版本并保留全部用户数据（配置、历史记录、profile 设置）。
注意：该安装包不依赖微软商店，企业网络或精简系统下可直接运行；安装完成后无需重启终端，新版本立即生效。
方法三：WSL 环境下彻底重装（推荐给 npm 安装用户）
① 彻底清除旧环境：
执行 sudo rm -rf /home/$USER/.nvm/versions/node/*/lib/node_modules/@openai/codex 和 sudo rm -rf /home/$USER/.codex*。
② 下载最新预编译二进制：
用 wget 或 curl -L 获取 Linux x64 版本，例如：curl -L https://github.com/GitHub_Trending/codex31/releases/download/v3.4.2/codex-3.4.2-linux-x64 -o ~/codex。
③ 赋予执行权限并全局注册：chmod +x ~/codex && sudo mv ~/codex /usr/local/bin/codex。
这一步绕过了 npm 缓存污染和 node-gyp 编译失败风险，实测耗时不到 20 秒，且不会触发任何“版本过旧”校验拦截。
