npm 安装 Codex 一直卡住:EAI_AGAIN、ETIMEDOUT、ECONNRESET 怎么排查
EAI_AGAIN 往往更偏 DNS 临时失败,ETIMEDOUT 更偏连接超时,ECONNRESET 则说明连接被对端或中间链路重置。三种错误都发生在“安装包”阶段,不应和后续模型 API 调用混为一谈。
EAI_AGAIN 往往更偏 DNS 临时失败,ETIMEDOUT 更偏连接超时,ECONNRESET 则说明连接被对端或中间链路重置。三种错误都发生在“安装包”阶段,不应和后续模型 API 调用混为一谈。
一、为什么会出现这个问题

- DNS、TCP、TLS、HTTP 任何一层都可能失败,仅凭“网页能开”无法证明终端网络正常。
- 浏览器、Node.js、Python、终端可能使用不同代理或证书环境。
- 长连接和流式响应比普通网页请求更容易受到超时、连接重置影响。
- 公司网络、Cloudflare、Nginx 或第三方网关可能成为额外故障点。
二、推荐的排查顺序
1. 先做最小网络测试
分别测试 DNS、HTTPS 和目标 API,不要一上来就改项目代码。curl 能提供状态码、响应头、TLS 和耗时信息,是定位网络问题的第一工具。
2. 比较浏览器与终端
浏览器正常而 CLI 失败时,重点检查终端代理、Node/Python 证书和环境变量;两者使用的网络栈并不完全相同。
3. 观察失败是否有固定时间
如果请求总在 60 秒、100 秒、120 秒附近断开,通常要重点检查某一层固定 timeout;随机断开更像链路抖动或上游重置。
三、可以直接复制的排查示例
npm config get registry
npm config get proxy
npm config get https-proxy
curl -I https://registry.npmjs.org/
npm config delete proxy
npm config delete https-proxy
npm cache verify
四、使用建议
“换 npm 源”只能解决包下载,不会自动解决 Codex 后续连接模型服务的问题。安装链路与调用链路要分开排查。
五、相关链接
- https://shop.chongplus.plus/
说明:以上第三方链接并非 OpenAI 官方站点。使用第三方服务前,请自行确认账号、隐私、数据存储、计费和服务条款。
相关文章
Codex 在 Docker 容器里运行失败怎么办?TTY、挂载和权限排查
围绕「Codex 在 Docker 容器里运行失败怎么办」给出面向 Codex 用户的原理、配置、操作步骤、排查方法与常见问题,适合新手直接照着实践。
Codex 找不到 Python 怎么办?脚本型 Skill 运行环境排查
围绕「Codex 找不到 Python 怎么办」给出面向 Codex 用户的原理、配置、操作步骤、排查方法与常见问题,适合新手直接照着实践。
Codex 执行 Shell 命令提示 Permission denied 怎么解决?
围绕「Codex 执行 Shell 命令提示 Permission denied 怎么解决」给出面向 Codex 用户的原理、配置、操作步骤、排查方法与常见问题,适合新手直接照着实践。
Codex 在 Linux 安装失败怎么办?权限、依赖和 Shell 排查
围绕「Codex 在 Linux 安装失败怎么办」给出面向 Codex 用户的原理、配置、操作步骤、排查方法与常见问题,适合新手直接照着实践。