先确认 Codex CLI 是否加载成功：若 codex --version 卡住或报错，而 node -v、npm -v 正常，则说明环境变量未注入生效；需运行 codex env inspect 查看变量状态，清除 HTTP_PROXY/HTTPS_PROXY 等干扰变量，并检查 config.toml 中 shell_environment_policy 的 inherit 设置是否为 full。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在终端里输入 codex --version 却卡住或报错，而其他命令如 node -v、npm -v 都能正常返回时，说明 Codex CLI 根本没加载成功——此时查 API Key、改配置文件全是白费力气，必须先确认环境变量是否真正注入并生效。
确认 Codex 是否读取到环境变量
在终端中直接运行：codex env inspect
这条命令会输出 Codex 实际加载的全部环境变量及其来源（如 shell、config、env 文件等）和当前状态。如果某变量显示 [hidden] 且状态为 active，说明它已被识别并启用；若显示 inactive 或根本未列出，则该变量未被 Codex 加载。
注意：这个命令只对 Codex CLI 有效，VS Code 插件或桌面端不支持。
检查环境变量是否被系统级干扰覆盖
执行：echo %HTTP_PROXY% && echo %HTTPS_PROXY%（Windows PowerShell）
或echo $HTTP_PROXY && echo $HTTPS_PROXY（macOS/Linux）
如果输出非空，【Codex 不兼容大写 HTTP_PROXY 变量，即使值正确也会导致连接中断】。必须从系统环境变量中彻底删除这两项，不能只清空值——留着空变量名仍会触发兼容性拦截。
同理，检查是否存在残留的 OPENAI_* 前缀变量：gci Env:OPENAI*（PowerShell）
若存在 OPENAI_BASE_URL 或 OPENAI_API_BASE，它们会强制覆盖 Codex 内置地址，引发 404 错误。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
验证环境变量是否被终端继承
第一步：确认当前终端是否加载了 shell 配置文件
PowerShell 用户检查：notepad $PROFILE
查看是否漏掉了 $env:PATH += "..." 或 Set-Item Env:CODER_ENV "dev" 类赋值语句。
第二步：区分终端类型的影响
【PowerShell 能跑不代表 Git Bash 也能跑，VS Code 终端能跑不代表系统 CMD 也生效】——不同终端的 PATH、Node.js 路径、环境变量加载机制完全独立。必须在你实际运行 codex 的那个终端里执行验证命令。
第三步：临时注入测试
在当前终端中执行：export CODER_ENV="staging"（macOS/Linux）
或$env:CODER_ENV="staging"（PowerShell）
再立即运行 codex env inspect，观察 CODER_ENV 是否变为 active。若仍是 inactive，说明 Codex 启动时未继承该会话变量。
排查 Codex 自身的环境继承策略
打开配置文件：notepad C:\Users\用户名\.codex\config.toml（Windows）
或vi ~/.codex/config.toml（macOS/Linux）
查找 [shell_environment_policy] 区块：
若存在 inherit = "core"，表示 Codex 启动子 shell 时只继承有限核心变量（如 PATH、HOME），【自定义环境变量默认不会传递进去】。
解决方法：将该行改为 inherit = "full"，保存后彻底退出 Codex 进程（任务管理器中杀掉所有 codex.exe 或 node 相关进程），再重新启动终端运行命令。
