codex连接超时需按顺序逐层排查：先验本地环境（node/npm/codex版本）、再查配置文件路径与格式（config.toml顶格写model_provider、auth.json仅保留密钥）、接着测网络链路（curl测连通性、代理监听、api直连）、最后用llm-api-doctor.mjs精准定位故障类型并依nextactions修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex连接超时不是网络断了，而是请求发出后30秒内没收到任何响应，命令卡死、对话中断、Reconnecting反复出现，此时必须按固定顺序逐层排查，跳过任意一层都可能白改配置。
先确认本地环境是否正常
很多“连不上”根本没走到API那一步，本地命令都跑不通，后面所有操作都是无效动作。
打开终端，依次执行：
node -v → npm -v → codex --version
重点看三件事：Node.js版本是否低于20；npm是否报command not found；codex --version是否稳定输出版本号。Windows用户特别注意：PowerShell能跑不代表Git Bash也能跑，VSCode终端能跑不代表系统CMD一定生效——不同终端读取的环境变量路径完全不同。
【如果 codex --version 报错或无输出，立刻停在这里，不要继续改 config.toml 或 auth.json】
检查配置文件是否被正确读取
Codex配置不生效，90%是因为改错了文件位置或格式错误，而不是内容写错。
方法一：确认 config.toml 路径正确
Windows 用户去 C:\Users\你的用户名\.codex\config.toml；macOS/Linux 用户去 ~/.codex/config.toml。若文件资源管理器里看不到 .codex 文件夹，请先开启“显示隐藏的项目”。
方法二：验证 model_provider 是否顶格书写
打开 config.toml，把 model_provider = "letaicode" 这行放在文件最开头，不能缩进、不能嵌套在任何 [xxx] 段落里。缩进会导致解析失败，整个配置静默失效。
方法三：检查 auth.json 是否干净
打开 ~/.codex/auth.json（Windows为 C:\Users\你的用户名\.codex\auth.json），只保留一行：{"OPENAI_API_KEY":"sk-xxx"}，删掉所有注释、空行、多余字段。多一个逗号或换行都会触发401。
验证网络链路是否真正通畅
第一步：测试基础连通性
在终端执行：curl -I https://chatgpt.com --max-time 10
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
第二步：确认代理端口是否监听
若你配置了代理，运行：netstat -ano | findstr :7890（Windows）或 lsof -i :7890（macOS/Linux），输出中必须含 LISTENING 状态。没有输出=代理根本没启动。
第三步：绕过浏览器直测API可达性
执行：curl -x http://127.0.0.1:7890 https://api.openai.com/v1/models -I --max-time 10
只要返回 HTTP/2 401 或 200，就证明代理链路通畅；若提示 Connection refused 或 timeout，说明代理未工作或端口不对。
【别用浏览器访问 api.openai.com 测试——它可能走缓存或插件代理，结果不可信】
用 /models 命令精准定位故障环节
同一个“连接超时”，可能是密钥失效、Base URL 错误、服务限流或 DNS 失败，靠猜会越改越乱。
第一步：确保已安装 Node.js 20+
第二步：下载诊断工具 llm-api-doctor.mjs，放在当前目录
第三步：执行探测命令
node llm-api-doctor.mjs --base-url https://letaicode.cn/codex
第四步：查看输出中的 classification 字段
如果是 “auth_failed”，说明 auth.json 密钥无效或格式错误；如果是 “endpoint_not_found”，说明 Base URL 少了 /v1 或域名拼错；如果是 “rate_limited”，需检查额度或加 retry-after；如果是 “network_error”，才需要回头查代理或 DNS。
第五步：根据 nextActions 字段执行对应修复
例如输出含 “retryAfterSeconds: 60”，就等1分钟后重试；含 “statusCode: 404”，就立刻核对 Base URL 路径。
