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 文档：网络连接

用 MCP 给 Cursor 加一个代理工具

MCP 可以给 Cursor 增加工具。装上 proxy302-mcp 后，Cursor 的 agent 能获取 Proxy302 代理，并通过它打开网页。把下面这段加进 ~/.cursor/mcp.json，所有项目都能用；加进某个项目里的 .cursor/mcp.json，则只对该项目生效。

proxy302-mcp 是 Proxy302 官方的 MCP 服务，在 GitHub 开源，由 Proxy302 团队维护。Proxy302 也在 https://proxy302.com/v1/mcp 托管了一份：Claude Code、Cursor、VS Code 这类能带 Authorization 请求头的客户端，填 API 密钥就能连，不用安装。

这和本页讲的代理是两套互不相干的设置。Cursor 网络设置里的代理决定 Cursor 自己怎么联网；MCP 服务器提供的工具另有各自的设置，装上它并不会改变 Cursor 自己的连接方式。工具清单、其他客户端和使用限制见 Proxy302 MCP 服务器指南。

• Proxy302 MCP 服务器指南

• 来源：
• Cursor docs: Model Context Protocol
• proxy302-mcp 的 README（Proxy302 官方 MCP 服务）

用 MCP 给 Cursor 加一个代理工具: mcp.json

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}

文件 ~/.cursor/mcp.json（或项目里的 .cursor/mcp.json）。把 <key id>:<secret> 换成你的 Proxy302 API 密钥。

• 来源：
• Cursor docs: Model Context Protocol

用 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 产品事实与价格表

Proxy302 一览

价格按 PTC 从钱包扣，1 PTC = 1 美元。没有免费试用：最小一单是 1 GB 动态住宅流量，或一个 IP 用 1 天。核对于 2026-11-04。

• 来源：
• Proxy302 产品事实与价格表
• Proxy302 ISP for AI subscriptions: public catalog

常见问题

延伸阅读

Cursor 代理

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

查看配置与价格

代理 IP 怎么查：IP 地址、国家、运营商

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

静态住宅 IP（ISP 代理）

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

查看配置与价格

Claude Code 怎么设置代理

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

代理 MCP 服务器

讲清楚代理 MCP 服务器是什么、本地和远程 MCP 服务器有什么区别、怎么装进 Claude Code、Codex CLI 和 Cursor，以及 MCP 服务器自己的网络请求怎么走代理。