“command not found”或“无法识别为cmdlet”表明系统未在path中找到codex可执行文件；需先用npm list -g @openai/codex确认是否安装成功，再用where.exe codex验证路径是否纳入环境变量，最后通过修改path或改用standalone安装器修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在终端输入 codex 命令后提示“command not found”或“无法将‘codex’项识别为 cmdlet”，说明系统根本没找到这个可执行文件，不是命令写错了，而是安装路径没被识别。
确认是否真的安装成功
先别急着重装，打开 PowerShell 或 CMD，运行：
npm list -g @openai/codex
如果返回空或显示“empty”，说明 npm 根本没装上这个包——可能因为网络中断、权限拒绝或 npm 配置异常。
如果看到类似 @openai/codex@0.147.0 的输出，再执行：
where.exe codex（Windows）或 which codex（macOS/Linux）
没结果？那说明虽然包装了，但可执行文件没正确链接到 PATH。
检查并修复 PATH 环境变量
npm 全局安装的命令默认放在：
Windows：%USERPROFILE%\AppData\Roaming\npm
macOS/Linux：~/.local/bin 或 /usr/local/bin
运行：
echo $PATH（macOS/Linux）或 echo %PATH%（Windows）
看输出里有没有包含上面那个路径。没有？那就得手动加。
方法一（Windows PowerShell，永久生效）：
在管理员权限下运行：
$env:Path += ";$env:USERPROFILE\AppData\Roaming\npm"
然后执行：
[Environment]::SetEnvironmentVariable("Path", $env:Path, "User")
方法二（macOS/Linux）：
编辑 ~/.zshrc（macOS 默认）或 ~/.bashrc（Linux 常见），追加一行：
export PATH="$HOME/.local/bin:$PATH"
保存后执行：
source ~/.zshrc
【关键提醒】改完 PATH 后必须新开一个终端窗口验证，旧窗口不会自动刷新环境变量。
配置 OpenClaw 多提供商认证与 OpenAI Codex OAuth 备用方案，实现自动模型切换，适用于多 OpenAI Codex 账户设置。
绕过 PATH 直接调用可执行文件
如果你只想快速验证 CLI 是否可用，不用管 PATH：
Windows：直接进入 %USERPROFILE%\AppData\Roaming\npm，找到 codex.cmd 或 codex.ps1，双击或右键“复制路径”，在终端中粘贴完整路径后加空格和参数，例如：
"C:\Users\你的用户名\AppData\Roaming\npm\codex.cmd" --version
macOS/Linux：运行：
$(npm bin -g)/codex --version
这一步能立刻判断是 PATH 问题还是二进制本身损坏。如果这里也报错，说明安装过程出问题了，不是路径的事。
换用 Standalone 安装方式（推荐）
npm 安装容易受 Node.js 版本、权限策略、代理设置干扰。官方更推荐使用独立安装器，它会把 codex.exe 直接放进系统级路径，不依赖 npm 生态。
第一步：彻底卸载 npm 版本
npm uninstall -g @openai/codex
第二步：下载并运行官方安装脚本
PowerShell 中执行：
Invoke-WebRequest -Uri "https://chatgpt.com/codex/install.ps1" -OutFile "$env:TEMP\install.ps1"; & "$env:TEMP\install.ps1"
第三步：重启终端，直接输入：
codex --version
如果显示版本号（如 codex-cli 0.147.0），说明已就位。这一步跳过了 npm 的所有中间环节，路径由安装器自动注册，Windows 用户尤其稳定。
