Cursor 怎么设置代理：http.proxy、HTTP/1.1 与验证

代理不会改变什么

本文讨论网络设置，而非服务可用性。Cursor 文档的「Regions」一节指出，部分模型提供商有位置限制：你所在地区不可用的模型不会出现在 Cursor 中，如果提供商屏蔽了该地区，即使用你自己的密钥，调用也可能失败。Cursor 使用条款（2026 年 9 月 3 日版本，第 17.5 条）要求遵守适用的贸易法律，包括制裁和出口管制。代理无法让 Cursor 在原本不可用的地区变得可用，也不会改变这些条款。

• 来源：
• Cursor 文档：地区
• Cursor 服务条款（2026 年 9 月 3 日更新），第 17.5 条

在哪里设置代理

Cursor 文档中未描述 http.proxy 参数。这是 VS Code 的标准设置，Cursor 代理设置一页用的正是这个设置。由于文档没有描述它，在下面的检查确认之前，请不要认为它已生效。添加方法：打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），选择 Preferences: Open User Settings (JSON)，加入下面的代码块，然后完全关闭 Cursor 并重新打开。

• Cursor 代理设置

在哪里设置代理: 示例

{
  "http.proxy": "http://USERNAME:PASSWORD@HOST:PORT",
  "http.proxySupport": "override"
}

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

地址中的用户名和密码

如果用户名或密码中包含特殊字符，请在地址中进行百分号编码：@ 变为 %40，: 变为 %3A，/ 变为 %2F，# 变为 %23，% 变为 %25。否则地址解析会出错，代理会返回身份验证错误。避免手误最简单的办法，是从「我的资产」（控制台里放着你买到的全部代理）复制，而不是手动输入。

HTTP 还是 SOCKS5

VS Code 文档中提到，带身份验证的代理受支持（Basic、Digest、NTLM 和 Negotiate），而 SOCKS5 的身份验证支持尚未实现。因此，带用户名和密码的代理请选择 HTTP。Cursor 文档中未提及 SOCKS5。

• 来源：
• Visual Studio Code 文档：网络连接

聊天和 Agent 卡住时：使用 HTTP/1.1

Cursor 使用 HTTP/2 进行流式响应，而部分代理不支持 HTTP/2。根据 Cursor 文档，修复方法如下：在 Cursor Settings → Network 中将 HTTP Compatibility Mode 设置为 HTTP/1.1 并重启 Cursor。在网络配置文档部分还提到，当出现流式传输问题时，Cursor 会自动切换到 HTTP/1.1 Server-Sent Events 模式。

• 来源：
• Cursor 文档：网络配置
• Cursor 文档：常见问题排查

如何验证代理是否正常工作

1. 第 1 步

   打开 Cursor Settings → Network 并点击 Run Diagnostics。该工具会检查与 Cursor 服务器的连接，并显示影响 AI 功能的问题。

2. 第 2 步

   在终端中用下面的命令直接检查代理，它会显示网站看到的 IP、国家和网络。ip、country、city 和 org 这几个字段怎么读，见代理 IP 怎么查。

   • 代理 IP 怎么查

3. 第 3 步

   如果你有防火墙，请允许 Cursor 文档中列出的域名：*.cursor.sh、*.cursor-cdn.com 和 *.cursorapi.com。

如何验证代理是否正常工作: 示例

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

常见错误

• 407 Proxy Authentication Required。 代理拒绝了用户名或密码。请重新复制数据，不要手动输入密码，并检查百分号编码。

• 证书错误。 只有代理会替换证书时才会出现。VS Code 文档把「将代理证书添加到操作系统的受信任证书中」列为首选做法，并不建议关闭证书校验：文档称这种做法有危险。

• 超时。 代理未在端口上响应或 IP 租约已到期。请使用上述 curl 命令进行检查。

• 流式响应卡顿。 将 HTTP Compatibility Mode 切换为 HTTP/1.1。

• 来源：
• Visual Studio Code 文档：网络连接

用 Proxy302 怎么做

如果需要一个固定地址，静态住宅 ISP 合适：IP 在租期内只归你使用、不会变化，购买时选择 HTTP 即可。Cursor 代理设置一页有详细说明和现成预设，产品本身见静态住宅（ISP）代理。下表是我们最近一次每小时检测中，通过七个国家的出口访问 Cursor 的结果：包括每个出口的网络和网站响应时间。

• Cursor 代理设置
• 静态住宅（ISP）代理

实测出口：Cursor 从七个国家的连通

Proxy302 探测器每小时检测一次，本次检测时间：2026 年 10 月 22 日 14:18 UTC。每个国家通过一个动态住宅出口、经公开的 Proxy302 入口向 Cursor 发一次请求。IP 只公开前三段。每国一个样本，不是平均值，之后的检测结果会不同。

• 来源：
• Proxy302 每小时连通检测

用 Proxy302 怎么做: 步骤

1. 第 1 步

   打开静态住宅 ISP 页面，选择国家，把「协议」设为 HTTP，再选「租期」和「数量」，然后点击「确认费用并生成」。

2. 第 2 步

   打开「我的资产」并复制 HOST、PORT、USERNAME 和 PASSWORD。「连接工具」页里有填好你自己连接信息的现成示例。HTTP 端口为 2222。

3. 第 3 步

   将数值粘贴到 http.proxy 中（如上所示），然后重启 Cursor。

4. 第 4 步

   使用 curl 请求和 Run Diagnostics 检查出口。

价格与限制

静态住宅 ISP IP 的价格是一天 US$0.50、30 天 US$7.99，约合每天 US$0.27，各国价格一致。各国的库存每天都会变化，以下单页面为准。没有免费试用，最小购买量是 1 个 IP、1 天。

• 来源：
• Proxy302 产品事实与价格表

常见问题

延伸阅读

Cursor 代理

Cursor 代理设置：独享静态 ISP IP，配好 http.proxy 和 HTTP/1.1 兼容模式，出口固定在美国等模型厂商服务的地区——桌面端按这个地区决定你能看到哪些模型。

查看配置与价格

代理 IP 怎么查：出口、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。

为连续工作保留同一个 IP

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

查看配置与价格

Claude Code 怎么设置代理

Claude Code 在 HTTP 代理后的设置：HTTPS_PROXY、NO_PROXY、后台代理用的 settings.json，以及确认生效的检查。