首先要验证基础运行环境是否就绪:在实际运行codex的终端中依次执行node -v、npm -v、codex --version,三者必须稳定输出;若codex --version无响应或报错,说明全局安装失败或path未生效,此时配置文件、代理、api密钥均无效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex连接超时后,首先要确认命令行环境本身是否就绪——很多“超时”其实根本没走到网络层,连Node.js都没加载成功,此时查代理、换API密钥全是白费功夫。
验证基础运行环境是否可用
打开你实际运行codex的那个终端(不是VSCode集成终端、不是PowerShell、不是Git Bash中随便一个——是你敲下codex命令时用的那个),逐行执行:
node -v → npm -v → codex --version
三者必须都有稳定输出。如果codex --version无响应或报错,说明全局安装失败或PATH未生效,【此时配置文件、代理、API密钥全都不起作用】。
Windows用户特别注意:PowerShell里能跑≠CMD能跑≠Git Bash能跑。你在哪个终端敲codex,就在那个终端里验这三个命令。
检查全局安装状态
运行:npm list -g @openai/codex
如果输出empty或报ENOENT,说明包根本没装上。必须用管理员权限重装:npm install -g @openai/codex
macOS/Linux用户若用nvm管理Node版本,请确保当前shell激活的是LTS版本(nvm use --lts),否则全局安装可能落在错误的Node路径下。
排查环境变量干扰
方法一:检查代理变量是否冲突
Windows执行:echo %HTTP_PROXY% && echo %HTTPS_PROXY%;macOS/Linux执行:echo $HTTP_PROXY $HTTPS_PROXY
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
只要任一变量非空,就立刻删除——Codex不兼容大写HTTP_PROXY变量,即使值正确也会导致连接中断。
方法二:检查API密钥是否加载
运行:echo $CODEX_API_KEY(macOS/Linux)或echo %CODEX_API_KEY%(Windows)
输出为空说明Key未设置。别手动粘贴到终端里试——容易多一个空格或少一个字符,【必须通过系统环境变量或~/.codex/.env文件写入】。
定位配置文件加载路径
第一步:确认config.toml是否存在且可读
Windows用户直接在资源管理器地址栏粘贴:C:\Users\你的用户名\.codex\config.toml,按回车。如果打不开,或文件名是config.toml.txt,说明配置未生效。
第二步:强制触发配置读取校验
把config.toml临时重命名为config.toml.bak,再运行codex --version。如果终端立刻报错config file not found,说明程序确实在读这个位置;如果依然无响应,说明它压根没走到配置加载阶段——问题出在更底层。
第三步:区分CLI与插件的配置路径
VSCode插件默认读~/.codex/,但Windows上~可能指向C:\Users\用户名或C:\Users\用户名\AppData\Roaming\Code\User,不能假设一致。










