先验证基础环境：运行node -v、npm -v、codex --version，若前两者失败则Node.js未就位；若仅codex失败，再检查which -a codex、echo $PATH及npm config get prefix，确保Codex路径已加入当前终端PATH。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在终端输入 codex 命令后报错，比如提示“command not found”“Permission denied”或直接卡住无响应，问题往往不出在 Codex 本身，而是终端根本没加载正确环境——此时必须立刻验证当前 Shell 是否已识别基础依赖，而不是急着重装或改配置。
确认当前终端是否处于有效运行环境
打开终端，先不输 codex，直接运行这三行命令：
node -v → npm -v → codex --version
如果 node 或 npm 报错或无输出，说明 Node.js 环境未就位，Codex 根本无法启动；如果前两者正常但 codex --version 报错，才进入下一步排查。Mac 和 Linux 用户尤其要注意：Terminal.app、iTerm2、VSCode 内置终端可能加载不同 shell 配置，别在一个终端里设了 PATH 却在另一个里测试。
检查 PATH 是否包含 Codex 安装路径
方法一：快速定位安装位置
运行 which -a codex，若无任何输出，说明全局未安装或路径未生效；若只输出一个路径（如 /usr/local/bin/codex），继续验证该路径是否在当前 PATH 中。
方法二：比对 PATH 实际内容
执行 echo $PATH，观察输出中是否含 codex 所在目录；若用 npm 全局安装，典型路径为 ~/.local/bin（Linux/macOS）或 %APPDATA%\npm（Windows）。【注意：Windows 用户若用 PowerShell 设置 Path，CMD 将完全读不到，必须统一终端类型】
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
方法三：验证 npm prefix 是否被覆盖
运行 npm config get prefix，把结果路径手动拼到 $PATH 里测试：export PATH="$(npm config get prefix)/bin:$PATH" → 再试 codex --version。这步能绕过系统级 PATH 配置失效的问题，临时验证是否路径错位。
区分终端会话与真实环境变量
第一步：判断你是否真的在目标环境中
执行 uname -a，若输出含 “Microsoft” 或 “WSL”，说明你已在 WSL 子系统内；若显示 Darwin 或 Linux 内核但无 WSL 字样，则是原生 macOS/Linux 终端；若看到 Windows NT，则你仍在 Windows 原生命令行里——【所有 Codex 环境变量设置必须与当前终端类型严格匹配，跨环境设置无效】。
第二步：检查关键环境变量是否被正确加载
运行 echo $OPENAI_API_KEY（或 $CODEX_API_KEY，取决于你用的密钥类型），若为空，说明密钥根本没注入当前会话；再运行 env | grep -i api，确认输出中没有引号包裹（如 OPENAI_API_KEY="sk-xxx" 是错的，必须是 OPENAI_API_KEY=sk-xxx）。
第三步：验证 shell 配置文件是否生效
→ 若用 bash：cat ~/.bashrc | grep OPENAI
→ 若用 zsh（macOS Catalina 后默认）：cat ~/.zshrc | grep OPENAI
→ 若用 fish：cat ~/.config/fish/config.fish | grep OPENAI
只要对应文件里有 export 行且没被注释掉，就执行 source ~/.zshrc（或对应文件）立即重载。
