codex连接超时首要排查配置文件：windows用户需确认config.toml无.txt后缀，macos/linux用户须确保文件位于~/.codex/且含auth.json与config.toml；config.toml顶部必须为model_provider = "letaicode"，[model_providers.letaicode]区块base_url须为https://letaicode.cn/codex；auth.json须为单行严格json格式；重启前需清空sessions缓存并验证状态栏显示“letaicode · gpt-5.5”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex连接超时不是网络问题第一反应，而是本地配置文件是否被正确读取、写入位置是否准确、内容结构是否合规——Windows用户常把config.toml.txt当成config.toml，macOS用户常把文件放在~/.codex之外的任意目录，Linux用户可能因权限问题导致CLI根本无法访问该路径。
确认配置文件真实存在且路径正确
打开终端，直接执行：ls -la ~/.codex/（macOS/Linux）或在PowerShell中运行：Get-ChildItem C:\Users\$env:USERNAME\.codex\ -Force。必须看到auth.json和config.toml两个文件同时存在，且没有多出config.toml.txt、config.toml.bak之类带后缀的副本。
如果命令报错“找不到路径”，说明【.codex文件夹根本没创建】，此时要回到Codex安装文档，先执行codex init或手动创建该目录并放入标准配置文件，否则后续所有修改都无效。
Windows用户特别注意：资源管理器默认隐藏扩展名，右键→属性→看“名称”字段是否真为config.toml，而不是config.toml.txt。用记事本另存为时若未取消勾选“将所有文件保存为.txt”，就会踩这个坑。
检查config.toml是否被真正加载
第一步：在终端运行codex --version。如果命令失败或无输出，说明Node.js环境已断裂，配置文件再对也读不到——此时先修复本地环境，不要继续改config.toml。
第二步：打开config.toml，确认model_provider = "letaicode"这一行位于文件最顶部，前面不能有任何空行、BOM头、注释或旧配置残留。Codex解析器遇到第一个[xxx]段落就停止向上读取，若这行被压在几十行旧配置下面，等于完全没生效。
第三步：检查[model_providers.letaicode]区块是否完整，base_url必须是https://letaicode.cn/codex，不能漏掉/codex后缀，也不能写成http://。写错会导致403或空响应，表现和超时几乎一样。
验证auth.json是否干净可用
方法一：用VS Code或nano直接打开~/.codex/auth.json，文件内容必须严格为一行JSON：{"OPENAI_API_KEY":"sk-xxx"}。不能有换行、多余空格、逗号、其他字段或注释。
方法二：在终端执行cat ~/.codex/auth.json | jq .（需安装jq），若返回Parse error或null，说明JSON格式损坏；若返回{}，说明文件为空；只有返回{"OPENAI_API_KEY":"sk-..."}才算通过。
【auth.json里多一个字段、少一个引号、多一个逗号，都会导致401而非超时】。Codex不会报错提示，只会静默失败并不断重连。
强制重启并验证配置是否生效
① 关闭所有Codex Desktop窗口，包括系统托盘里的进程；
② 在终端中执行killall codex（macOS/Linux）或taskkill /f /im codex.exe（Windows），确保后台服务彻底退出；
③ 删除~/.codex/sessions/下所有.jsonl文件——这些是旧会话缓存，可能硬编码了已失效的model_provider，不删会持续走错误通道；
④ 重新启动Codex Desktop，或在终端运行codex chat，发送“hello”测试；
⑤ 观察右下角状态栏：若显示“letaicode · gpt-5.5”，说明配置已加载；若仍显示“openai”或“reconnecting”，说明config.toml未生效或auth.json被忽略。
