Cursor 网络配置教程

Cursor 是基于 VS Code 的桌面应用，部分请求不一定遵循终端里的环境变量，所以 TUN 模式是最省心的方案。

第一步：导入订阅并开启 TUN#

1. 按 Codex CLI 教程 导入 KeepKite 订阅。
2. 在客户端打开 TUN（虚拟网卡）模式，代理模式选「规则」。
3. 完全退出 Cursor（macOS 用 Cmd + Q，Windows 在托盘里退出），再重新打开。

第二步（可选）：只使用系统代理时#

不能开 TUN 时，打开 Cursor 的 settings.json（命令面板 → Preferences: Open User Settings (JSON)），加入：

{
  "http.proxy": "http://127.0.0.1:7897",
  "http.proxySupport": "override",
  "http.noProxy": ["localhost", "127.0.0.1"]
}

端口换成你客户端的混合端口，保存后重启 Cursor。

第三步：开启 HTTP/1.1 兼容模式#

部分网络环境下，HTTP/2 长连接容易被中断，表现为对话卡住、Agent 半途断开。在 Cursor Settings → Network 中把 HTTP 兼容模式改为 HTTP/1.1，然后点击 Run Diagnostic 检查各项是否通过。

第四步：在 Cursor 中使用 Codex 插件#

Cursor 中安装的 OpenAI Codex 插件同样受益于 TUN 模式，无需单独配置。如果插件登录卡住，确认 http.noProxy 中包含 localhost。

验证#

在 Cursor 内置终端运行：

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

然后在 Chat 中发送一条消息。若 Network 诊断仍有失败项，请参考 故障排查。