答案是PATH未包含codex全局安装路径。需先执行codex --version验证命令识别，再检查Node/npm版本是否达标（node≥22.0.0、npm≥10.0.0），确认~/.local/bin/codex存在后，将该路径手动加入PATH并重启终端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在终端输入 codex run test 或 codex "run unit tests" 后，直接报出 command not found: codex，根本没走到测试逻辑就卡在命令识别层——这不是模型或配置问题，而是系统压根没把 codex 当成一个可执行程序看待。
确认命令是否被系统识别
第一步：在终端中执行 codex --version。
如果返回 command not found、'codex' 不是内部或外部命令 或 PowerShell 的 无法将“codex”项识别为 cmdlet，说明问题停留在安装或环境变量层面。【此时不要去改 AGENTS.md、不要碰 config.toml、更别急着重装 OpenAI 账号】。
这一步操作起来很简单，直接敲完回车就行，3 秒内就能排除 90% 的假性故障。
重装 CLI 并刷新终端会话
执行全局重装命令：
npm install -g @openai/codex@latest
安装完成后，必须关闭当前终端窗口，再新开一个终端——旧终端的 shell 环境不会自动加载新写入的 PATH，反复在同一个窗口里试只会浪费时间。
注意：如果你用的是 oh-my-zsh 或自定义 shell 配置，安装后可能还需手动刷新配置（如 source ~/.zshrc），但优先尝试新开终端，这是最干净的验证方式。
检查 Node.js 和 npm 版本是否达标
方法一：运行 node -v 和 npm -v。
Node.js 必须 ≥ 22.0.0，npm 必须 ≥ 10.0.0；低于这个版本，npm 无法正确注册全局 bin 路径，哪怕安装日志显示成功，【codex 二进制文件实际未被链接到 PATH 中】。
方法二：快速验证安装路径是否生效：
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
macOS / Linux 用户执行：ls ~/.local/bin/codex
Windows 用户执行：dir "%USERPROFILE%\.local\bin\codex.exe"
如果文件存在但仍提示 command not found，说明该路径未加入系统 PATH。
修复 PATH 环境变量
① 查看当前 PATH 是否包含 Codex 安装目录：
macOS / Linux：echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
② 若无输出，将路径追加进 shell 配置文件：
Zsh 用户（macOS 默认）：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Bash 用户（部分 Linux 发行版）：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
③ Windows PowerShell 用户（需管理员权限）：$p = [Environment]::GetEnvironmentVariable('PATH','User'); [Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')
执行完第③步后，必须重启 PowerShell 或 Windows Terminal 才能生效。
