codex 请求卡顿主因是未设超时,需配置 codex_request_timeout(如120000毫秒)、codex_stream_timeout(≥请求超时,推荐180000)、mcp startup_timeout_sec(建议60)及禁用websocket改用openai_http。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在用 Codex 调用后端接口(如 OpenAI API、自建模型服务等)时,发现请求卡住几十秒甚至几分钟才报错或重连,根本原因不是接口没响应,而是 Codex 客户端未主动设限——它默认等待操作系统级 TCP 超时(可能长达 15 分钟),而非按业务需求设定合理超时阈值。
设置全局请求超时(影响所有同步/流式调用)
第一步:在终端中执行命令,将请求超时设为 120 秒
export CODEX_REQUEST_TIMEOUT=120000
第二步:使配置永久生效,写入 shell 配置文件
echo 'export CODEX_REQUEST_TIMEOUT=120000' >> ~/.zshrc && source ~/.zshrc
这一步必须在启动 codex 前完成;若已启动 codex,需关闭当前终端并新开一个——【旧终端不会自动继承新环境变量】。
第三步:验证是否生效
codex --print "test" --max-turns 1
单独控制流式响应超时(专用于长输出场景)
方法一:使用环境变量(推荐长期使用)
export CODEX_STREAM_TIMEOUT=180000
方法二:命令行临时指定(适合单次调试)
codex --timeout 120000 --stream-timeout 180000 "分析这段代码"
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
流式超时必须 ≥ 请求超时,否则会在响应中途被强制切断——【180000 毫秒是安全下限,低于此值易触发 Stream timeout No data received】。
调整 MCP 服务启动超时(仅当启用 codex_apps 时生效)
① 打开 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 返回全过程。
强制禁用 WebSocket 改用 HTTP 协议(规避长连接挂起)
方法一:修改 config.toml 配置文件
在文件最顶部(任何 [xxx] 段落之前)添加:
model_provider = "openai_http"
然后在任意空白处新增段落:
[model_providers.openai_http]
name = "OpenAI HTTP only"
wire_api = "responses"
supports_websockets = false
【model_provider 必须顶格写,缩进会导致解析失败】
方法二:临时绕过配置,直接使用环境变量启动
codex --model-provider openai_http "分析这段代码"







