Cursor 代理设置：HTTP 兼容模式、模型地区与常见网络错误

Cursor 的网络问题出在哪

Cursor 本体可以离线写代码，但登录、Tab 补全、Chat 和 Agent 都要连接 Cursor 的海外服务器，再由服务器调用 Claude、GPT 等模型。所以网络问题分两层：

1. 编辑器能不能连上 Cursor 服务器：取决于本机代理有没有覆盖 Cursor 进程；
2. 服务器愿不愿意给你某个模型：取决于你的出口 IP 落在哪个地区。

AI 工具通用的地区和 IP 原理见AI 工具网络环境指南，本文只讲 Cursor 的部分。

让 Cursor 走代理

首选：TUN 模式

在 Clash Verge Rev、v2rayN 等客户端开启 TUN 模式后，Cursor、它内置的终端、Git 和浏览器都会走同一个出口，登录回调也不容易出错。这是梯子指南和机场Z 都优先推荐的做法，开启方法见 Clash 教程。

备选：在设置里填写 http.proxy

Cursor 基于 VS Code，沿用了 VS Code 的 http.proxy 设置项（Cursor 官方文档没有单独说明这一项，下面的写法以 VS Code 的设置为准）。按 Ctrl + Shift + P（macOS 为 Cmd + Shift + P）打开命令面板，搜索 Open User Settings (JSON)，加入：

{
  "http.proxy": "http://127.0.0.1:7897"
}

端口号是代理客户端的本地端口，例如 Clash Verge Rev 默认 7897、v2rayN 默认 10808，以你的设置为准。保存后完全退出并重新打开 Cursor。

HTTP/2 与兼容模式

Cursor 官方的网络配置文档说明，Chat 和 Agent 默认使用 HTTP/2 双向流式传输；部分代理或安全网关处理不好这种流式连接，官方点名最常见的是 Zscaler。遇到这种情况时 Cursor 会自动回退到 HTTP/1.1 的 SSE 模式，但回退并不总能救回来。

官方帮助页给出的手动办法：

1. 打开网络设置

   进入 Cursor Settings，找到 Network 一栏。

2. 切换兼容模式

   把 HTTP Compatibility Mode 设为 HTTP/1.1。较早的版本里相关选项的名称和位置可能不同，以你当前版本的界面为准。

3. 重启 Cursor

   完全退出后重新打开，再测试一次 Chat 或 Agent。

同一个 Network 页面里还有 Run Diagnostics 按钮，会测试到 Cursor 服务器的连接，并标出影响 AI 功能或更新的问题，排查时值得先跑一遍。

分流规则别漏掉 Cursor 域名

用规则模式时，要确认 Cursor 相关域名走代理。官方网络配置文档列出的域名主要在 cursor.sh、cursor.com、cursorapi.com、cursor-cdn.com 和 cursorvm.com 之下。以 Clash 规则为例，下面几行要放在 GEOIP,CN 和 MATCH 之前：

rules:
  - DOMAIN-SUFFIX,cursor.sh,AI
  - DOMAIN-SUFFIX,cursor.com,AI
  - DOMAIN-SUFFIX,cursorapi.com,AI
  - DOMAIN-SUFFIX,cursor-cdn.com,AI
  - DOMAIN-SUFFIX,cursorvm.com,AI

这里的 AI 是你自己建的手动选择策略组，名字可以按习惯改。

模型地区限制

Cursor 官方的 Regions 页面说明，部分模型供应商有基于地区的限制，涉及 Anthropic（Claude）、OpenAI（GPT 系列）和 Google（Gemini）。受限时这些模型不会报错，而是直接不出现在列表里，其余模型照常可用。

如果出口 IP 在中国大陆或香港，Claude、GPT 系列往往会一起消失。处理办法：

• 把 AI 策略组固定在美国、日本或新加坡节点，重启 Cursor；
• 临时选择 Auto，让 Cursor 每次挑一个当前可用的模型；
• 地区判断的更多细节见AI 地区不可用。

Remote SSH 与 VPN 的坑

用 Cursor 连接远程服务器开发时，官方帮助文档特别说明：AI 请求是从你本地的电脑发往 Cursor 服务器的，而不是从远程主机发出。所以远程开发时 AI 功能不可用，应先检查本机的代理，而不是去给服务器配代理。远程连接频繁掉线时，官方建议在本地 SSH 配置里加上保活参数：

ServerAliveInterval 60
ServerAliveCountMax 3

另一个容易忽略的点是 DNS。官方提到 Cursor 可能沿用之前 VPN 留下的 DNS 设置，断开 VPN 或切换代理方式后，如果出现 DNS 报错，要完全退出 Cursor 再打开，只重新加载窗口不够。DNS 问题的通用排查见 DNS 错误排查。

节点选择

Tab 补全是高频的小请求，对延迟最敏感；Agent 则是长连接，对丢包更敏感。日常使用选延迟低、晚高峰稳定的日本或新加坡专线比较平衡，需要最完整的模型列表时用美国节点。不要把 AI 策略组设成自动测速，出口频繁跳动容易让登录状态和长任务一起中断。机场对比见机场推荐。

常见网络错误

同样基于 VS Code 的 GitHub Copilot 也是用 http.proxy 配置代理，两篇可以对照阅读。