Cursor代理设置教程：系统代理、TUN模式与编辑器代理配置

Cursor 的聊天、补全和 Agent 功能，请求由编辑器及其后台进程发出，只开系统代理不一定生效。最省心的做法是开启代理客户端的 TUN 模式；不想开 TUN 时，可以在编辑器设置里填写代理地址，或者从已设置代理变量的终端启动 Cursor。无论用哪种方式，最后都要用网络诊断和连接日志确认请求真的走了代理。Cursor 对网络的整体要求见 Cursor 网络要求。

三种方式怎么选

方式一：开启 TUN 模式（推荐）

TUN 模式不依赖程序是否支持代理，Cursor、集成终端里的命令、各种插件都会被接管。在代理客户端中开启 TUN 或“虚拟网卡”模式即可，通常需要管理员权限或安装系统服务。详细步骤见 Clash Verge TUN 模式教程。

开启后注意两点：不要同时运行其他 VPN 或加速器；DNS 建议交给代理客户端处理，避免解析结果与出口地区不一致。

方式二：编辑器代理设置

Cursor 基于 VS Code，保留了 VS Code 的代理相关设置项。打开命令面板（Windows 为 Ctrl+Shift+P，macOS 为 Cmd+Shift+P），搜索“Open User Settings (JSON)”，加入：

{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxySupport": "override"
}

端口以代理客户端实际显示的为准，保存后完全退出并重新打开 Cursor。这些设置项继承自 VS Code，对扩展市场、插件请求一般有效，但 Cursor 自家的 AI 请求是否完全遵循，取决于具体版本，具体菜单以当前版本为准。

方式三：从已设置代理的终端启动

安装 Cursor 的命令行启动命令后（可在命令面板中搜索 install 相关命令找到），在已设置代理变量的终端里启动，编辑器会继承这些变量：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1
cursor .

$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1"
cursor .

注意：如果 Cursor 已经在运行，新命令可能只是打开一个新窗口，并不会重新读取变量，需要先完全退出。

分流规则

Cursor 的 AI 请求一般先发往 Cursor 自己的服务端，再由服务端调用模型，因此分流时优先保证 Cursor 相关域名走代理。以 Clash 类客户端为例（域名以实际连接日志为准）：

rules:
  - DOMAIN-SUFFIX,cursor.com,AI
  - DOMAIN-SUFFIX,cursor.sh,AI

其中 AI 是你自建的手动选择策略组，建议固定一个支持地区的稳定节点，不要让它自动测速切换。

验证代理是否生效

1. 内置网络诊断：新版本在 Cursor 设置的网络相关页面中提供诊断功能，可一键检查各项连接（名称以当前版本为准）；
2. 连接日志：在代理客户端的连接或日志页面，发送一条聊天消息，观察是否出现 Cursor 相关域名，以及走的是哪个节点；
3. 集成终端测试：在 Cursor 内置终端运行 curl，确认终端环境也能经代理访问外网：

curl -sS -o /dev/null -w "%{http_code}\n" https://www.cursor.com

三项都正常但 AI 功能仍报错，问题可能不在代理层，参考 Cursor 模型不可用排查。系统代理本身不生效的情况，见 系统代理不生效排查。

请在遵守当地法律法规及 Cursor 服务条款的前提下配置网络。