只让 Cursor 走代理：不开全局代理的设置方法

哪些东西只留在 Cursor 里

Cursor 基于 VS Code，http.proxy 是 VS Code 的设置，保存在 Cursor 自己的设置文件里，不会改动操作系统的代理。浏览器、包管理器和其他软件继续走你原来的网络。

Cursor 官方文档没有介绍 http.proxy，VS Code 的页面把它称为旧版设置。所以请把下面的检查当作依据：检查通过才算生效。

• Cursor 代理设置

• 来源：
• VS Code 文档：网络连接

5 步设置

1. 第 1 步

   买一个 HTTP 协议的静态 ISP IP，打开“我的资产”，复制主机、端口、用户名、密码。

   • 静态 ISP 代理

2. 第 2 步

   在 Cursor 里打开命令面板（Ctrl+Shift+P，macOS 是 Cmd+Shift+P），运行 Preferences: Open User Settings (JSON)。

3. 第 3 步

   加上下面例子里的两行。密码里有特殊字符的话，做百分号编码（@ 写成 %40，: 写成 %3A）。

4. 第 4 步

   完全退出 Cursor 再打开。聊天或 agent 卡住的话，打开 Cursor Settings > Network，把 HTTP Compatibility Mode 设为 HTTP/1.1，再重启。

5. 第 5 步

   打开 Cursor Settings > Network，点 Run Diagnostics。

   预期结果 检查完成，没有代理相关错误。

Cursor 用户设置（JSON）

{
  "http.proxy": "http://LOGIN:PASSWORD@HOST:2222",
  "http.proxySupport": "override"
}

仅为示例。LOGIN、PASSWORD、HOST 换成“我的资产”里的值。

证明只有 Cursor 在用代理

运行下面的 curl 检查，它会显示代理的 IP，证明地址和账号可用。然后在平时用的浏览器里打开 https://ipinfo.io/json：显示的应该还是你自己的网络，因为浏览器没有用代理。

Cursor 里的 Run Diagnostics 则告诉你，在新设置下 Cursor 能不能连上它的服务器。

检查代理本身

curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json

仅为示例。应该打印代理的 IP 信息。

IP 是 SOCKS5，或者不想把密码写进文件

VS Code 页面写明 SOCKS5 代理认证尚未实现，所以带登录的 SOCKS5 地址没法直接当 http.proxy 用。可以在自己电脑上跑一个本地转发：它负责登录代理，Cursor 只看到 http://127.0.0.1:8080，不用登录。

这样密码也不会出现在 settings.json 里。代价是用 Cursor 期间要多开一个小程序。

• 用 gost 或 3proxy 做本地转发

• 来源：
• VS Code 文档：网络连接
• gost 文档（go-gost/docs）

转发命令和对应的 Cursor 设置

gost -L http://127.0.0.1:8080 -F socks5://LOGIN:PASSWORD@HOST:3333

# 然后 settings.json 里写：
# "http.proxy": "http://127.0.0.1:8080"

仅为示例。转发只监听 127.0.0.1，HOST、LOGIN、PASSWORD 请替换。

用转发时的 Cursor 用户设置

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

仅为示例。文件里没有账号密码，登录由转发负责。

直接写地址，还是本地转发

依据 VS Code 网络页面和 gost 文档，2026 年 11 月 13 日读取。

• 来源：
• VS Code 文档：网络连接
• gost 文档（go-gost/docs）

代理改变不了什么

Cursor 的地区页面写明：部分模型提供方有地区限制，这些模型不会出现在 Cursor 里；提供方封锁你所在地区时，即使用自己的 key 调用也可能失败。代理改变的是 Cursor 对外连接的地址，改变不了提供方开放什么。请使用你实际所在国家的 IP。

• 来源：
• Cursor 文档：地区

Cursor 不走代理或卡住时

常见问题

延伸阅读

Cursor 怎么设置代理

在 Cursor 中用 http.proxy 设置代理，处理密码里的特殊字符，流式响应卡住时切换到 HTTP/1.1，并用 Run Diagnostics 验证。

本地转发：gost 与 3proxy

在 127.0.0.1 上用一行 gost，只有地址和端口栏的软件也能用带登录的代理（SOCKS5 端口 3333，HTTP 端口 2222）。

代理连接失败怎么排查

Chrome 或 Edge 连不上代理服务器时，会显示 ERR_PROXY_CONNECTION_FAILED，完整提示是「无法连接到代理服务器」。

静态住宅 IP（ISP 代理）

静态 ISP 代理：一条固定的住宅级 IP，整个租期内保持不变。适合社媒账号、店铺和 AI 工具。支持 HTTP / SOCKS5。

查看配置与价格