Codex频繁超时根本原因是默认超时阈值与国内网络延迟不匹配,需延长MCP启动超时至60秒、禁用WebSocket改用HTTP协议、配置正确代理端口并统一UTF-8编码环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex频繁提示网络连接超时,说明客户端在发起请求后无法在预期时间内收到服务端响应,此时命令卡死、对话中断、Reconnecting循环反复出现,根本原因不是“连不上”,而是默认超时阈值与国内真实网络延迟特征不匹配。
延长MCP服务启动超时时间
第一步:打开Codex配置文件 config.toml,路径通常为 ~/.codex/config.toml(Windows为 C:\Users\用户名\.codex\config.toml)。
第二步:在文件末尾新增以下配置块:
[mcp_servers.codex_apps]
startup_timeout_sec = 60
这一步必须加在 [mcp_servers] 下级,不能嵌套在其他段落里;若已有同名段落,直接修改数值即可。默认30秒对国内代理链路明显不足,60秒可覆盖TLS握手+上下文初始化+首chunk返回全过程。
强制禁用WebSocket降级HTTP协议
方法一:修改 model_provider 配置
在 config.toml 文件最顶部(任何 [xxx] 段落之前)写入:
model_provider = "openai_http"
然后在文件任意空白处添加完整段落:
[model_providers.openai_http]
name = "OpenAI HTTP only"
wire_api = "responses"
supports_websockets = false
⚠️ 注意:model_provider 必须顶格写,不能缩进,否则解析失败导致配置不生效。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:使用环境变量绕过配置文件
在 Codex 启动前,执行:
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
这一步只对当前终端会话有效,适合临时验证;若需长期生效,请将两行追加到 ~/.zshrc 或 ~/.bashrc 中并执行 source ~/.zshrc。
验证代理端口是否真正可用
① 打开终端,运行:netstat -ano | findstr :7890(Windows)或 lsof -i :7890(macOS/Linux),确认输出中包含 LISTENING 或 LISTEN 状态。
② 若无输出,说明代理未监听该端口——请打开你的代理工具(Clash、Stash、Surge等),检查HTTP/Socks5端口设置,确保已启用且端口号与配置一致。
③ 运行测试命令: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的编码环境
在 VS Code 终端或系统终端中,运行:chcp 65001(Windows)或 echo $LANG(macOS/Linux),确认输出为 UTF-8。
若 Windows 终端显示 活动代码页: 936,则立即执行 chcp 65001 切换为 UTF-8;否则 Codex 在传输中文提示词或错误日志时可能触发解码异常,间接引发连接重置。
VS Code 用户还需检查设置中 terminal.integrated.defaultProfile.windows 是否指向 PowerShell(而非 CMD),PowerShell 默认支持 UTF-8,CMD 需手动切换才稳定。

















