Codex连接超时导致命令卡死、对话中断、Reconnecting循环,根本原因是默认超时阈值与国内网络延迟不匹配,需手动延长全局请求超时至120秒、MCP启动超时至60秒、流式响应超时至180秒,并验证代理端口及链路可用性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex连接超时后命令卡死、对话中断、Reconnecting循环反复出现,说明客户端在发起请求后无法在预期时间内收到服务端响应,此时需手动延长超时阈值而非重试。
修改全局请求超时时间
第一步:在终端中执行以下命令,将请求超时设为120秒
export CODEX_REQUEST_TIMEOUT=120000
第二步:使设置永久生效,追加到shell配置文件
echo 'export CODEX_REQUEST_TIMEOUT=120000' >> ~/.zshrc && source ~/.zshrc
第三步:验证是否生效,运行简单指令测试
codex --print "test" --max-turns 1
这一步必须在启动codex前完成;若已启动,需关闭当前终端并新开一个——【旧终端不会自动继承新环境变量】。
调整MCP服务启动超时
打开Codex配置文件config.toml,路径通常为~/.codex/config.toml(Windows为C:\Users\用户名\.codex\config.toml)。
在文件末尾新增如下配置块:
[mcp_servers.codex_apps]
startup_timeout_sec = 60
注意:该段落必须独立存在,不能嵌套在其他[xxx]下;若已有同名段落,直接修改数值即可。默认30秒对国内代理链路明显不足,60秒可覆盖TLS握手+上下文初始化+首chunk返回全过程。
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
同步设置流式响应超时
方法一:使用环境变量
export CODEX_STREAM_TIMEOUT=180000
方法二:命令行临时指定
codex --timeout 120000 --stream-timeout 180000 "分析代码"
流式超时必须≥请求超时,否则会在响应中途被强制切断——【180000毫秒是安全下限,低于此值易触发Stream timeout No data received】。
验证代理链路是否真正可用
① 确认代理端口处于监听状态:
macOS/Linux执行 lsof -i :7890;Windows执行 netstat -ano | findstr :7890
② 若无LISTEN输出,说明代理未运行或端口错误——请检查Clash/Surge等工具的HTTP代理端口是否启用且数值一致。
③ 运行穿透测试:
curl -x http://127.0.0.1:7890 https://api.openai.com/v1/models -I --max-time 10
只要返回HTTP状态码(如HTTP/2 401),即证明代理链路通畅;若提示Connection refused,则代理未运行或端口不匹配。

















