讲师中心 微信公众号
AI工具推荐 视频效率加速

codex启动时连接超时怎么办?

夜宇吖_5225

夜宇吖_5225

发布时间:2026-08-08 19:10:38

|

231人浏览过

|

来源于php中文网

原创

Codex反复Reconnecting或超时的根本原因是本地网络延迟与默认配置不匹配,需延长MCP启动超时至60秒、禁用WebSocket改用HTTP协议、验证并配置正确代理端口、修复Windows回调端口冲突,并确保Node.js及Codex版本可用。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex启动时连接超时怎么办?

Codex启动时反复显示“Reconnecting”或直接卡在连接超时,不是账号失效也不是模型崩了,而是本地请求在60秒内没收到响应,系统判定失败并中断握手——此时命令行冻结、对话框空白、历史会话无法加载。

先确认本地环境是否就绪

打开终端,依次执行:node -vnpm -vcodex --version。三者都必须返回版本号,缺一不可。

若任一命令报 command not found,说明 Node.js 未安装或未加入 PATH,Codex 根本无法运行,后续所有配置都无效。

Windows 用户特别注意:PowerShell 能跑 ≠ Git Bash 能跑 ≠ VSCode 内置终端能跑,务必在你实际启动 Codex 的那个终端里验证。

延长 MCP 启动超时时间

第一步:用文本编辑器打开 Codex 配置文件 config.toml
macOS/Linux 路径:~/.codex/config.toml;Windows 路径:C:\Users\你的用户名\.codex\config.toml

第二步:在文件末尾新增以下配置块(必须顶格写,不能缩进):

[mcp_servers.codex_apps]<br>startup_timeout_sec = 60

【注意】这段必须放在 [mcp_servers] 下级,不能嵌套在 [model_providers] 或其他段落里;已有同名段落则直接修改数值即可。 默认30秒对国内代理链路明显不足,60秒才能覆盖 TLS 握手 + 上下文初始化 + 首 chunk 返回全过程。

强制禁用 WebSocket 改走 HTTP

方法一:修改配置文件
config.toml 最顶部(任何 [xxx] 段落之前)写入:model_provider = "openai_http"
然后在任意空白处添加完整段落:

[model_providers.openai_http]<br>name = "OpenAI HTTP only"<br>wire_api = "responses"<br>supports_websockets = false

【关键】model_provider = "openai_http" 必须顶格书写,缩进会导致解析失败,配置完全不生效。

codex-orchestration
codex-orchestration

通用 Codex 编排,使用 update_plan 与后台 PTY 终端并行执行 codex exec 工作进程。

下载

方法二:用环境变量绕过配置
在启动 Codex 前,执行:

export HTTPS_PROXY="http://127.0.0.1:7890"<br>export HTTP_PROXY="http://127.0.0.1:7890"

这一步只对当前终端会话有效;如需长期生效,请将两行追加到 ~/.zshrc(macOS/Linux)或 ~/.bashrc(Linux),然后执行 source ~/.zshrc

验证代理端口是否真正监听

① 打开终端,运行:
Windows:netstat -ano | findstr :7890
macOS/Linux:lsof -i :7890
确认输出中包含 LISTENINGLISTEN 状态。

② 若无输出,说明代理工具(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 401HTTP/2 200),即证明代理链路通畅;若提示 Connection refused,说明代理未运行或端口错误。

修复 Windows 登录回调端口冲突

管理员身份打开 PowerShell,执行:netsh interface ipv4 show excludedportrange protocol=tcp

重点查看输出中是否含 1359–1458 区间——Codex 默认用 1455 端口启动本地回调服务,一旦落入该区间,就会触发 os error 10013,导致监听失败→无法接收浏览器回调→登录超时。

若确认被排除,立即执行:net stop winnatnet start winnat
重启 WinNAT 服务后,系统会重新分配排除端口,1455 大概率被释放。

完成后无需重启电脑,直接重试 codex login 即可生效。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

394

2026.05.26

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

204

2026.05.26

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

157

2026.05.26

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

350

2026.05.27

Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

188

2026.06.10

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

0

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

0

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

0

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

0

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 151人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn