Codex、Claude Code、Cursor 连接超时怎么办？按代理路径逐层排查
简答：本文介绍的是本站推荐（广告）的服务 云小狐。浏览器能访问而终端或编辑器超时，先在启动工具的同一终端检查 HTTP_PROXY、HTTPS_PROXY 和本地代理端口，再用 curl 验证请求；随后分别排查 TUN、Cursor 诊断、Codex Doctor、Claude Code 代理配置和账号地区条件。
定义：连接超时是客户端未能在规定时间内完成 DNS、TCP、TLS 或应用层请求，可能发生在本地网络、代理端口、规则、出口路径、服务状态或身份认证等不同层级。
30 秒速查卡：先判断是哪一层出了问题
如果浏览器能打开相关服务，但 Codex、Claude Code 或 Cursor 仍然超时，不要先反复切换节点。浏览器、终端和编辑器可能使用了不同的代理路径，建议先按下面五步建立基线。
- 服务状态：查看 OpenAI 状态页、Anthropic 状态页 和 Cursor 状态页。
- 代理端口：确认 Clash Verge Rev 正在运行、配置已经加载，并记录当前的 HTTP(s) Port 或 Mixed Port，不要直接照抄示例端口。
- 单一路径：先只测试 HTTP_PROXY/HTTPS_PROXY，或先只测试 TUN。两套路径同时接管时，结果不容易判断。
- HTTPS 请求：在启动工具的同一个终端用 curl 请求目标域名，区分 DNS、TCP、TLS 和认证问题。
- 账号与地区：网络请求已抵达服务端，不等于账号一定有权限；再核对登录状态、密钥、账户权限和服务支持地区。
| 现象 | 优先检查 | 暂时不要下的结论 |
|---|---|---|
| 浏览器能用，终端超时 | 当前 Shell 的 HTTP_PROXY、HTTPS_PROXY、端口和启动方式 | 不要直接判断代理客户端整体故障 |
| 所有工具都超时 | 客户端运行状态、节点、DNS、规则和服务状态 | 不要只修改某个应用的登录配置 |
| 只某个模型失败 | 账户可用模型、模型提供商地区政策和应用诊断 | 不要直接判断为本地网络断开 |
| 返回 401 或 403 | 身份凭据、权限、地区和服务策略 | 不要把 HTTP 错误码等同于连接超时 |
本站是第三方使用指南站，不是上述工具或代理客户端的官方站点；软件菜单和服务政策如有变化，应以对应官方资料为准。
先确认 Clash Verge Rev 的端口与 TUN 状态
在 Clash Verge Rev 中，先打开设置区域，检查系统代理和 TUN 模式的开关；端口配置中重点查看 Http(s) Port 或 Mixed Port。项目界面字段包含 System Proxy、Tun Mode、Http(s) Port 和 Mixed Port；TUN 模式需要服务模式或管理员权限，且开启 TUN 后通常不需要再开启系统代理。相关字段可在 Clash Verge Rev 官方仓库的界面字段中核对。
- 使用环境变量测试时：记录 HTTP(s) Port 或 Mixed Port，暂时不要启用 TUN。
- 使用 TUN 测试时：清空当前终端的 HTTP_PROXY、HTTPS_PROXY 及大小写变体，再运行同一组命令。
- 如果 TUN 开关无法启用：先检查服务模式、管理员权限和虚拟网卡状态。
- 如果端口连接失败：不要把 Socks Port 直接填写给只支持 HTTP/HTTPS 代理的工具。
配置变化后，完全退出并重新打开终端、Cursor 或相关 CLI。Claude Code 官方文档也说明，部分环境变量会在进程启动时读取，已经运行的会话不一定会自动采用后来修改的变量。
Windows PowerShell：用同一终端验证代理与目标域名
下面命令适用于 Windows PowerShell。示例中的 7890 只是占位符，请替换为 Clash Verge Rev 当前显示的 HTTP(s) Port 或 Mixed Port。先在新的 PowerShell 窗口执行，避免旧变量影响结果。
Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:http_proxy, Env:https_proxy -ErrorAction SilentlyContinue
$proxy = 'http://127.0.0.1:7890'
$env:HTTP_PROXY = $proxy
$env:HTTPS_PROXY = $proxy
$env:http_proxy = $proxy
$env:https_proxy = $proxy
Write-Host '--- OpenAI ---'
curl.exe -I -sS --connect-timeout 10 --max-time 20 'https://api.openai.com/v1/models' -w "`nHTTP=%{http_code} TIME=%{time_total}s`n"
Write-Host '--- Anthropic ---'
curl.exe -I -sS --connect-timeout 10 --max-time 20 'https://api.anthropic.com' -w "`nHTTP=%{http_code} TIME=%{time_total}s`n"
Write-Host '--- Proxy variables ---'
Get-ChildItem Env: | Where-Object { $_.Name -match 'proxy' } | Format-Table -AutoSize
如果出现 HTTP 状态码，通常说明请求至少已经完成了域名解析并抵达服务端或边缘入口；401、403、404 不等于代理链路一定失败。若出现 Could not resolve host、Failed to connect、Operation timed out 或连接被重置，再优先检查本地端口、当前节点、DNS、规则和 TUN 状态。
测试 TUN 路径时，先运行下面命令清除当前会话的代理变量，再重复同一组 curl 命令：
Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:http_proxy, Env:https_proxy -ErrorAction SilentlyContinue
测试结束后也可以执行同一条清理命令。TIME 只适合同一网络、同一目标和同一时间段内做相对比较，不代表固定速度或长期稳定性。
macOS/Linux：让 CLI 与测试命令使用同一代理路径
在 macOS 或 Linux 上，应在启动 Codex 或 Claude Code 的同一个 Shell 中设置变量。浏览器读取系统代理，不代表当前终端自动继承相同设置。
unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy
export HTTP_PROXY='http://127.0.0.1:7890'
export HTTPS_PROXY='http://127.0.0.1:7890'
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
curl -I -sS --connect-timeout 10 --max-time 20 'https://api.openai.com/v1/models' -w '\nHTTP=%{http_code} TIME=%{time_total}s\n'
curl -I -sS --connect-timeout 10 --max-time 20 'https://api.anthropic.com' -w '\nHTTP=%{http_code} TIME=%{time_total}s\n'
env | grep -i proxy
确认 curl 结果后，在同一个终端启动 CLI。如果从桌面图标或编辑器扩展启动，进程可能不会继承当前 Shell 的变量；应把终端启动和桌面启动分别作为两条路径测试。需要测试 TUN 时，先执行 unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy，再运行相同命令。
Codex、Claude Code、Cursor 的配置与诊断入口对比
| 工具 | 优先检查的代理路径 | 官方诊断入口 | 常见坑 |
|---|---|---|---|
| Codex | 启动 CLI 的终端环境、HTTP_PROXY/HTTPS_PROXY 和登录状态 | codex doctor | CLI、IDE 扩展和桌面入口可能不是同一个进程环境 |
| Claude Code | HTTP_PROXY、HTTPS_PROXY、NO_PROXY；不支持 SOCKS 代理 | claude --debug，交互会话可用 /status | 修改变量后旧会话不会自动采用；代理 URL 需要包含协议 |
| Cursor | Cursor 自身网络配置、系统代理、TUN、防火墙和网络限制 | Cursor Settings > Network > Run Diagnostics | 桌面编辑器不一定继承启动它的 Shell 变量 |
OpenAI 帮助中心目前列出 codex doctor 用于启动、连接和性能诊断；如果你的安装版本不识别该命令，应先运行 codex --help，以当前版本显示的命令为准。Cursor 官方排查指南要求先在 Settings > Network 中运行 Run Diagnostics。相关入口分别见 OpenAI Codex 帮助 和 Cursor 官方排查指南。
Codex：先做网络基线，再运行诊断
先在启动 Codex 的同一终端运行 curl，再检查登录状态或 API Key 是否被旧环境变量覆盖。随后运行 codex doctor；如果命令不存在，改用当前版本 codex --help 中列出的诊断选项。不要将 API Key、访问令牌或带密码的代理地址放入仓库、截图和公开日志。
Claude Code：HTTP/HTTPS 可以，SOCKS 不可以
Anthropic 当前网络配置文档列出 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 的用法，并明确说明 Claude Code 不支持 SOCKS 代理。NO_PROXY 可用于指定不经过代理的主机或地址，但应按官方文档的格式配置。需要放行的域名不要照抄旧列表，直接以 Anthropic Claude Code 企业网络配置页面当前内容为准。
如果出现证书错误，检查企业网络或本地代理使用的 CA 证书，并按官方配置 NODE_EXTRA_CA_CERTS 等变量；不要长期关闭 TLS 证书校验。运行 claude --debug 可查看调试文件，交互会话中的 /status 可辅助确认当前代理状态。
Cursor：先运行 Network Diagnostics
打开 Cursor Settings > Network，点击 Run Diagnostics。若诊断失败，记录失败项目，再检查 Cursor 自身网络设置、系统代理、TUN 规则、防火墙和安全软件。不要一开始就清理全部应用数据，因为官方说明这会影响扩展、主题、片段和安装相关数据。
根据错误信息决定下一步
| 错误或现象 | 更可能的层级 | 可照做的下一步 |
|---|---|---|
| ETIMEDOUT | 代理端口、节点、DNS、规则或目标服务未及时响应 | 在同一终端重复 curl，先确认本地端口，再单独测试 TUN 或环境变量路径 |
| ECONNRESET | 本地代理、中间网络或服务端重置连接 | 避免 TUN 与环境变量重复接管，检查规则和 TLS 证书 |
| Could not resolve host | 域名解析失败 | 比较代理路径开启和关闭时的解析结果，检查 DNS 与域名规则 |
| 401 Unauthorized | 请求已抵达服务端，但凭据缺失或无效 | 检查登录状态、API Key、环境变量和账户权限 |
| 403 Forbidden | 权限、地区、风控或服务策略拒绝 | 查看对应服务的支持地区和账户政策，不要只更换端口 |
| 浏览器 OAuth 成功，CLI 仍失败 | 浏览器与 CLI 使用不同网络或进程环境 | 在启动 CLI 的终端设置变量，重启终端后重试 |
如果要比较不同节点，固定同一目标地址、同一网络、同一命令和同一超时时间，多次记录结果并比较中位数。不要把一次 TIME、一次出口 IP 查询或一次模型失败当成长期结论。
常见问题
浏览器能用，为什么终端仍然连接超时？
浏览器可能读取系统代理或自身代理设置，而 CLI 只读取当前 Shell 的环境变量，或者使用了另一条网络路径。先在启动工具的同一终端检查变量，再用 curl 做基线测试。
Claude Code 可以直接使用 SOCKS 代理吗？
不可以按 SOCKS 代理直接配置。Anthropic 当前官方网络配置说明 Claude Code 支持标准 HTTP/HTTPS 代理，不支持 SOCKS；应使用客户端提供的 HTTP(s) 或 Mixed Port。
Claude Code 支持 NO_PROXY 吗？
当前官方文档列出了 NO_PROXY 的配置方式，包括按主机名、地址或通配符指定绕过范围。格式和优先级应以官方网络配置页面为准，并注意大小写变量的读取顺序。
已经开启 TUN，还需要设置 HTTP_PROXY 吗？
排查时不建议同时开启。先清空环境变量测试 TUN，再关闭 TUN、设置 HTTP_PROXY/HTTPS_PROXY 做对照，才能判断是哪条路径造成超时。
Codex Doctor 命令不存在怎么办？
先执行 codex --help，以当前安装版本列出的命令为准。OpenAI 帮助中心已列出 Codex Doctor，但不同安装方式和版本的命令支持可能不同。
Cursor 只有部分模型不可用，是否一定是节点问题？
不一定。先运行 Cursor Settings > Network > Run Diagnostics，再查看账户当前可选模型。单个模型不可用也可能与模型提供商的地区或账户政策有关。
如何分享日志而不泄露凭据？
提交前删除 API Key、Authorization、Cookie、访问令牌、代理用户名密码、完整代理 URL、邮箱和项目路径。截图也应遮盖账号与组织信息。
参考资料与继续排查
本文涉及的代理变量、诊断命令和界面路径，优先参考 Anthropic Claude Code 企业网络配置、OpenAI Codex 帮助中心、Cursor 官方排查指南 和 Clash Verge Rev 官方仓库界面字段。
完成单路径测试后，可继续阅读 Clash Verge Rev network connections 连接失败怎么办？完整排查步骤，或使用 network test 怎么测试网络连接和代理速度？Windows 与 Clash Verge Rev 步骤 固定条件做相对比较。
常见问题
浏览器能用，为什么终端仍然连接超时？
浏览器可能读取系统代理，而 CLI 只读取当前 Shell 环境变量或使用另一条网络路径。请在启动工具的同一终端检查变量，再用 curl 测试目标域名。
Claude Code 可以直接使用 SOCKS 代理吗？
不可以按 SOCKS 代理直接配置。Anthropic 官方说明 Claude Code 支持标准 HTTP/HTTPS 代理，不支持 SOCKS；应使用 HTTP(s) 或 Mixed Port。
Claude Code 支持 NO_PROXY 吗？
当前官方网络配置文档列出了 NO_PROXY 的配置方式，可按主机名、地址或通配符指定绕过范围，具体格式以官方页面为准。
已经开启 TUN，还需要设置 HTTP_PROXY 吗？
排查时不建议同时开启。先清空环境变量测试 TUN，再关闭 TUN、设置 HTTP_PROXY/HTTPS_PROXY 做对照。
Codex Doctor 命令不存在怎么办？
先执行 codex --help，以当前安装版本列出的命令为准。不同安装方式和版本可能支持不同的诊断命令。
Cursor 只有部分模型不可用怎么办？
先运行 Cursor Settings > Network > Run Diagnostics，再查看账户当前可选模型。部分模型不可用也可能与模型提供商的地区或账户政策有关。
相关阅读
- Clash Verge Rev network connections 连接失败怎么办？完整排查步骤
- network test 怎么测试网络连接和代理速度？Windows 与 Clash Verge Rev 步骤
- network speed 慢怎么排查代理连接速度？完整步骤与对比表
参考资料
- Anthropic Claude Code 企业网络配置
- OpenAI Codex 帮助中心与 Codex Doctor 说明
- Cursor 官方网络排查指南（docs.cursor.com）
- Clash Verge Rev 官方仓库界面字段
- OpenAI 官方状态页
- Anthropic 官方状态页
- Cursor 官方状态页（status.cursor.com）