先确认本地node.js环境是否就绪、终端能否读取到真实网络配置、代理端口是否真正监听并可被cli继承——这三步没走通，后续改api key或换模型全是白忙；需依次验证node/npm/codex版本输出、不同终端path一致性、netstat/lsof监听状态、curl直连代理链路、环境变量大小写兼容性及/models接口分类诊断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex连接超时时，先确认本地Node.js环境是否就绪、终端能否读取到真实网络配置、代理端口是否真正监听并可被CLI继承——这三步没走通，后续改API Key或换模型全是白忙。
检查本地运行环境是否正常
打开终端（PowerShell / Git Bash / VSCode内置终端），逐行执行以下命令：
node -v → npm -v → codex --version
三者都必须稳定输出版本号。若codex --version卡住或报错，说明CLI根本没加载成功，此时不要查API密钥，先解决环境问题。
Windows用户特别注意：【PowerShell能跑不代表Git Bash也能跑，VSCode终端能跑不代表系统CMD也生效】，不同终端的PATH、环境变量、Node.js路径可能完全不同。
验证代理端口是否真实可用
方法一：用netstat或lsof确认监听状态
Windows执行：netstat -ano | findstr :7890；macOS/Linux执行：lsof -i :7890
必须看到LISTENING或LISTEN字样，否则代理工具（Clash、Stash等）根本没在该端口启动。
方法二：用curl直连测试链路通断
curl -x http://127.0.0.1:7890 https://api.openai.com/v1/models -I --max-time 10
只要返回HTTP状态码（如HTTP/2 401或HTTP/2 200），就证明代理链路通畅；若提示Connection refused，说明代理未运行或端口号填错。
确认Codex是否实际读取了代理配置
第一步：检查环境变量是否干扰
执行：echo %HTTP_PROXY% && echo %HTTPS_PROXY%（Windows）或echo $HTTP_PROXY && echo $HTTPS_PROXY（macOS/Linux）
使用 OpenAI Codex CLI 处理编码任务。触发词：codex、code review、fix CI、refactor code、implement feature、coding agent、gpt-5-codex。Clawdbot 可将编码工作委托给 Codex CLI 作为子代理或直接工具。
如果输出非空，【Codex不兼容大写HTTP_PROXY变量，即使值正确也会导致连接中断】，必须从系统环境变量中彻底删除这两项。
第二步：验证CLI是否继承代理
在终端中临时注入（仅当前会话有效）：export HTTP_PROXY="http://127.0.0.1:7890" → export HTTPS_PROXY="http://127.0.0.1:7890" → 再运行codex list
若此时能列出模型，说明问题出在配置文件或全局环境变量未生效；若仍超时，则代理端口或链路本身有问题。
用/models接口快速定位故障环节
第一步：准备诊断命令
确保已安装Node.js 20+，然后运行：
node llm-api-doctor.mjs --base-url https://api.openai.com/v1
该脚本会自动拼接/models路径、带上Authorization头发起GET请求，不发送任何提示词或上下文。
第二步：看classification输出
若返回classification: "auth_failed"，重点查API Key和Header格式；若为"network_timeout"，说明问题仍在本地网络层；若为"upstream_error"或"gateway_timeout"，则需检查Base URL或上游服务状态。
第三步：比对statusCode与retryAfterSeconds
401→密钥错误；404→Base URL漏写/v1；429→额度耗尽；502→网关异常；超时类错误则回到代理和防火墙排查。
