Codex CLI / VS Code / Cursor 报错 fetch failed 与 Connection Refused：终端代理配置排错指南
💡 核心速览：浏览器能正常访问 ChatGPT，但终端运行 codex、Cursor 或 VS Code 插件却报 fetch failed、连接超时或 SSL 证书错误？全面解析终端环境变量与代码工具代理注入命令。
一、 常见困惑：为什么网页能打开，终端和代码插件却连不上？
许多开发者在 VS Code、Cursor 或终端命令行中运行 codex 相关的 CLI 脚本或 AI 代码助手时，经常遭遇以下报错：
- • TypeError: fetch failed (cause: ConnectTimeoutError)
- • Client.Timeout exceeded while awaiting headers
- • Error: connect ECONNREFUSED 127.0.0.1:443
- • UNABLE_TO_VERIFY_LEAF_SIGNATURE (自签名证书拦截)
Windows / macOS 桌面托盘的「系统代理」开关（WinINet API）仅对 Chrome、Edge 等浏览器生效。系统终端（CMD、PowerShell、Bash）以及底层的 Node.js、Python、Go 运行时，默认根本不会读取系统托盘的代理注册表！因此代码请求全部直连国内裸网，必然超时失败。
二、 各环境终端代理一键注入命令 (随用随走)
打开 PowerShell 窗口，直接粘贴执行（注意将 7890 替换为你代理客户端的实际本地混合端口）：
# 临时为当前 PowerShell 终端设置 HTTP/HTTPS 代理 (默认端口通常为 7890)
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:ALL_PROXY="socks5://127.0.0.1:7890"
# 测试是否成功连通 OpenAI
curl -I https://api.openai.com/v1/models# 临时为当前 Bash / Zsh 终端注入代理 (关闭窗口后自动失效)
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5://127.0.0.1:7890"
# 测试连通性
curl -I https://api.openai.com/v1/models若 VS Code 插件报 UNABLE_TO_VERIFY_LEAF_SIGNATURE，通常是开启了本地 HTTPS 解密抓包导致的根证书不信任，按如下配置即可完美解决：
// 在 VS Code 用户设置 (settings.json) 中添加：
{
"http.proxy": "http://127.0.0.1:7890",
"http.proxyStrictSSL": false,
"http.proxySupport": "on"
}# 为 Git 设置专属代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
# 若需取消 Git 代理：
# git config --global --unset http.proxy
# git config --global --unset https.proxy三、 一劳永逸方案：开启客户端 TUN 模式
每次打开终端都要敲一次 export / $env 确实麻烦。最推荐的做法是在客户端（如 Clash Verge Rev、Sing-box）中直接开启 TUN 模式（虚拟网卡模式）：
TUN 驱动在操作系统网络层创建一张虚拟网卡，强制接管整台机器的所有出站 TCP/UDP 数据包。无论是终端命令行、VS Code、Docker 容器还是 Node.js，无需设置任何环境变量，流量全自动经由代理分流，彻底杜绝漏网和报错！
Plus 频次被卡？解锁 ChatGPT Pro 200/500 与 Business 独立配额
普通 Plus 频次限制严重阻断高强度 Coding 灵感。AI集采支持开通 Pro 200 (10x 旗舰) / Pro 500 (25x 顶配) 及企业 Business 空间，各席位额度独立不冲突，支持中国工商银行对公转账与 6% 增值税专用发票。
相关技术排障与常见问题推荐
查看全部问题Reconnecting 1/5 报错终极解决
运行 Codex CLI 或 VS Code / Cursor 插件时，频繁遭遇「Reconnecting… 1/5」至 5/5 中断？本文提供清晰极简的速查自救方案：通过 .codex/.env 注入代理、在 config.toml 中强制降级为 HTTP 稳定流、一键重置鉴权凭证与 TUN 模式优化，30 秒快速恢复流畅编码。
429 限流与使用额度耗尽解决
写代码一半提示「You've reached the current usage cap」或报错 429 Too Many Requests？掌握指数退避重试代码、会话瘦身压缩、轻重任务分流与高并发破解方案。
403 Access Denied 与人机死循环
挂了代理仍打不开 ChatGPT，提示 403 Access Denied 或验证码点了又弹死循环？手把手教你排查 IP 信誉分、WebRTC/DNS 泄漏、浏览器指纹污染与 TUN 网卡终极接管。