Codex 卸载与重新安装教程Codex 命令行工具用久了之后最常见的问题不是“不会用”而是环境乱了旧版本残留、Node 版本不对、PATH 指向了错误位置、API Key 配到了另一个终端里。遇到codex: command not found、登录失败、请求超时、升级后无法启动时不建议一上来反复安装先按顺序把当前环境查清楚。一、安装前先检查环境Codex CLI 通常依赖 Node.js 和 npm所以第一步先看本机有没有可用的 Node 环境。### token云桥中转 0029.org ### node -v npm -v如果这两条命令都能输出版本号说明基础环境至少是可用的。建议 Node.js 使用较新的 LTS 版本例如 18 或 20 以上。版本太老时安装过程中可能出现依赖解析失败、语法不兼容等问题。再看一下当前是否已经安装过 Codexcodex --version which codexWindows PowerShell 可以用where codex这里重点看两件事第一命令是否存在第二命令实际指向哪里。有些机器上以前用 npm 装过后来又用其他方式装过结果 PATH 里有多个codex执行到的并不是你刚安装的那个。二、卸载旧版本1. npm 全局安装的卸载方式如果之前是通过 npm 全局安装的一般用下面的命令卸载npm uninstall -g openai/codex卸载后再确认一次codex --version如果仍然能输出版本号说明系统里还有其他来源的 Codex继续用which codex或where codex查路径。2. 清理 npm 缓存如果你遇到过安装中断、依赖下载失败、版本号不更新可以顺手清理一下 npm 缓存npm cache verify一般不需要强制清缓存。如果确认缓存损坏再执行npm cache clean --force--force不要没事就用它会跳过 npm 的保护机制。多数情况下npm cache verify已经够用。3. 检查全局安装目录有时卸载失败是权限问题先看 npm 全局目录在哪里npm root -g npm prefix -gmacOS 或 Linux 上如果目录在系统路径下可能会遇到权限不足。不要急着所有命令都加sudo更推荐把 npm 全局目录配置到用户目录避免后续继续出权限坑。三、重新安装 Codex确认旧版本清理干净后再执行安装npm install -g openai/codex安装完成后先不要直接跑项目先验证命令是否可用codex --version codex --help如果这里正常说明可执行文件和 PATH 基本没问题。若提示command not found通常是 npm 全局 bin 目录没有加入 PATH。查看 npm 全局 bin 目录npm bin -g如果你的 npm 版本不支持这条命令可以用npm prefix -g然后检查对应目录下的bin是否在 PATH 中。macOS 或 Linux 可以查看echo $PATHWindows PowerShell 可以查看$env:Path四、配置 API Key 和环境变量Codex 能启动不代表能正常请求模型API Key 配置才是第二个关键点。最简单的方式是通过环境变量配置。macOS / Linuxexport OPENAI_API_KEY你的_API_Key这只对当前终端窗口有效。想长期生效可以写入 shell 配置文件例如使用 zsh 时echo export OPENAI_API_KEY你的_API_Key ~/.zshrc source ~/.zshrc使用 bash 时通常写入echo export OPENAI_API_KEY你的_API_Key ~/.bashrc source ~/.bashrcWindows PowerShell当前窗口临时生效$env:OPENAI_API_KEY你的_API_Key写入用户环境变量[Environment]::SetEnvironmentVariable(OPENAI_API_KEY, 你的_API_Key, User)设置后建议重新打开一个终端再验证环境变量是否能读到echo $env:OPENAI_API_KEY如果你使用的是中转接口通常还需要配置 Base URL具体变量名以你使用的 CLI 版本和文档为准。实际项目里我会优先选延迟稳定、日志清楚、余额和 Key 管理方便的平台比如 token 云桥 AI 中转站 0029.org尤其适合本地调试和多人共用 Key 的场景但配置时一定要确认接口地址、模型名和鉴权格式是否和 Codex 当前版本匹配。五、网络验证不要省很多安装问题看起来像 Codex 报错实际是网络不通。先确认 npm 源能访问npm ping再确认接口域名能连通。macOS / Linux 可以用curl -I https://api.openai.com如果你配置了代理也要确认当前终端能读取代理变量echo $HTTP_PROXY echo $HTTPS_PROXYWindows PowerShellecho $env:HTTP_PROXY echo $env:HTTPS_PROXY代理只在浏览器里可用不代表终端也可用。很多新手在这里卡很久网页能打开命令行却一直超时就是终端没有走代理。六、常见安装坑1. 安装成功但 codex 命令不存在优先检查 npm 全局 bin 目录是否加入 PATH。不要重复安装十几次路径不对时装多少次都一样。2. 权限不足 EACCESmacOS / Linux 常见。临时可以用sudo npm install -g但长期不推荐。更好的方式是调整 npm 全局目录到用户目录避免全局包都写到系统目录。3. Key 配了但仍提示未授权先确认变量名是否写错再确认新终端是否重新打开。还要注意复制 Key 时不要带空格、换行或中文引号。4. 请求超时或连接失败按顺序查本机网络、代理设置、DNS、接口地址、Base URL。不要先怀疑 Codex 本身网络层问题更常见。5. 升级后行为异常先看当前版本codex --version再卸载重装。如果仍然异常检查是否有多个codex可执行文件残留尤其是 Windows 上不同 Node 安装目录并存时很容易发生。总结Codex 卸载和重新安装的核心不是一条安装命令而是按顺序确认Node/npm 环境、旧版本路径、全局 PATH、API Key、网络连通性。遇到问题时先定位是哪一层坏了再处理通常比反复重装更快。