Codex 连不上怎么办？故障排查清单

遇到 stream disconnected before completion、error sending request、请求超时、地区不受支持或登录卡住时，按下面的顺序排查，大多数问题在前三步就能解决。

1. 运行检测脚本#

在出问题的那个终端里运行：

curl -fsSL https://app.keepkite.com/check.sh | bash

脚本会检查当前终端的代理环境变量、出口网络，以及 Codex 与 Claude 相关接口是否可达。提交工单时请附上完整输出，可以大幅缩短排查时间。

想先阅读脚本内容：

curl -fsSL https://app.keepkite.com/check.sh -o keepkite-check.sh && less keepkite-check.sh
bash keepkite-check.sh

2. 确认订阅有效并已更新#

• 在控制台确认套餐未过期、流量未用完。
• 在代理客户端里 手动更新一次订阅，节点列表会随线路调整而变化。
• 如果曾经重置过订阅链接，旧链接会失效，需要重新导入。

3. 确认流量真的走了代理#

最常见的原因是：客户端开着，但 Codex 的请求并没有经过它。

TUN 模式：客户端中 TUN 开关为开启状态，且模式为「规则」或「全局」。在 macOS / Windows 上首次开启 TUN 需要授权安装服务，未授权时开关会自动关闭。

环境变量：在运行 Codex 的同一个终端里检查：

env | grep -i _proxy

应当看到 HTTPS_PROXY=http://127.0.0.1:端口。注意：

• 端口必须与客户端的 混合端口 一致（Clash Verge Rev 默认 7897，其他客户端常见 7890）。
• 使用 http:// 前缀；Claude Code 不支持 socks5://。
• 新开的终端不会继承旧终端里 export 的变量，可以写进 ~/.zshrc / ~/.bashrc。
• IDE（VS Code、Cursor）从 Dock 或开始菜单启动时 不会读取 shell 配置文件里的变量，IDE 内请使用 TUN 或编辑器自己的代理设置。

4. 换一个节点#

打开 服务状态：

• 选择 在线 且 Codex（或 Claude）显示 「可达」 的节点。
• 「地区受限」表示该出口地区被服务商拒绝，换其他地区。
• 延迟高或频繁断流时，优先尝试地理位置更近的日本、新加坡、韩国线路。

5. 登录卡住或回调失败#

codex login、Gemini CLI 等使用浏览器登录时，会回调本机的 localhost 端口。如果这一步也被发往代理，就会一直转圈。

export NO_PROXY=localhost,127.0.0.1,::1

或者改用 TUN 模式。

6. DNS 与 IPv6#

• 客户端的 DNS 建议使用默认的 fake-ip / 增强模式，不要在系统里手动写死境外 DNS。
• 部分网络下 IPv6 会绕过代理，可在客户端里关闭 IPv6，或在系统网络设置中暂时关闭 IPv6 后重试。
• 公司网络如果有 HTTPS 拦截（自签名证书），Node.js 类工具需要 NODE_EXTRA_CA_CERTS 指定根证书。

7. 常见报错速查#

报错	可能原因	处理
stream disconnected before completion	节点不稳定或长连接被中断	换节点；Cursor 打开 HTTP/1.1 兼容模式
unsupported_country_region_territory	请求未走代理或出口地区不支持	检查第 3 步，换节点
error sending request / ECONNRESET	代理未生效、端口错误	检查 HTTPS_PROXY 端口
403 / Request not allowed（Claude）	出口地区受限	选 Claude「可达」的节点
登录页一直转圈	localhost 回调被代理	设置 NO_PROXY 或用 TUN
能打开网页但 CLI 不通	只开了浏览器代理 / 系统代理	开 TUN 或设置环境变量

还是不行？#

在控制台提交工单，附上：

1. 检测脚本的完整输出
2. 使用的工具与版本（如 codex --version）
3. 代理客户端名称、是否开启 TUN、当前节点名称
4. 报错截图或日志

我们会尽快协助排查。