codex运行报“缺少依赖文件”时，需先执行codex --version 2>&1捕获错误，提取如'xyz'或libssl.so.3等具体缺失名；再验证node -v/npm -v版本是否达标，检查npm root -g路径下@openai/codex是否存在；若存在则清理缓存并重装npm install -g @openai/codex --registry=https://registry.npmmirror.com；若为openssl类库缺失，windows用户需安装openssl并配置path。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex安装完成后运行报错提示“缺少依赖文件”，说明Node.js环境虽已就位，但关键运行时库未被正确加载或版本不匹配，此时不能直接重装，必须定位缺失项并针对性补全。
检查缺失依赖的具体名称
以管理员身份打开 PowerShell，执行 Codex 命令并捕获完整错误输出：codex --version 2>&1。如果返回类似 Error: Cannot find module 'xyz' 或 Cannot open shared object file: libssl.so.3 的内容，其中 【'xyz' 或 'libssl.so.3' 就是真正缺失的依赖名】，后续所有操作都围绕它展开。
若命令直接报 command not found，跳过本阶段，转到「验证 Node.js 环境是否生效」步骤。
验证 Node.js 环境是否生效
在同一个管理员 PowerShell 中，依次运行：
node -v → 查看是否输出 v22.x.x 或更高版本；
npm -v → 查看是否输出 v10.x.x 或更高版本；
npm root -g → 记下全局模块路径（如 C:\Users\XXX\AppData\Roaming\npm\node_modules）；
进入该路径，检查是否存在 @openai\codex 文件夹。若不存在，说明 npm 全局安装根本未成功，需重新执行安装命令；若存在但运行仍报缺依赖，说明是 Codex 自身依赖未被自动拉取。
强制重装 Codex 及其嵌套依赖
方法一：清理后重装（推荐用于 npm 安装场景）
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
第一步：卸载现有 Codex：npm uninstall -g @openai/codex；
第二步：清除 npm 缓存，避免旧包干扰：npm cache clean --force；
第三步：使用国内镜像源重新安装，降低下载中断风险：npm install -g @openai/codex --registry=https://registry.npmmirror.com。
方法二：跳过 peer 依赖警告强行安装（适用于报 “UNMET PEER DEPENDENCY” 类错误）
执行：npm install -g @openai/codex --legacy-peer-deps。这会忽略版本兼容性校验，让安装流程继续，适用于你确认底层 Node.js 版本足够新、且愿意承担轻微兼容风险的情况。
手动补全系统级共享库（仅 Windows 用户遇 libxxx.so / dll 报错时启用）
若错误信息含 libssl.so.3、libcrypto.so.3 或类似动态链接库名，这是 Codex 底层调用 OpenSSL 导致的问题。Windows 默认不提供这些 Linux 风格的 .so 文件，但 Codex for Windows 实际依赖的是 openssl.dll。
去 OpenSSL 官网下载 Windows 64 位完整安装包（非 Light 版），运行安装程序时勾选 【Add OpenSSL to the PATH】，然后重启 PowerShell 再试。
若仍失败，可临时将 OpenSSL 安装目录下的 bin 文件夹路径（如 C:\Program Files\OpenSSL-Win64\bin）手动追加到系统环境变量 PATH 中。
