3 分钟学会给 Cursor 配置代理

注意：请将 http.proxy 中的地址替换为你本地代理软件的监听地址，端口通常为 7890 或 1080。

4. 保存文件后，重启 Cursor 使设置生效。

方法二：通过界面设置

如果你更习惯图形化操作，可以直接在设置中填写。

1. 打开 Cursor，按 Cmd + ,（Mac）或 Ctrl + ,（Windows）进入设置。
2. 在搜索框输入 proxy。
3. 在 Http: Proxy 字段填入你的代理地址，例如 http://127.0.0.1:7890 或 socks5://127.0.0.1:7890。
4. 如果代理需要校验 HTTPS，可勾选 Http: Proxy Strict SSL，否则保持默认。
5. 点击下图中的首选项，选择 Cursor 首选项配置，进入 network（网络管理）页面。
6. 关键步骤：将 HTTP 协议改为 HTTP/1.1。这一步非常重要，很多连接问题都是因为 HTTP/2 握手失败导致的。

如何验证配置成功？

不要完全依赖 Cursor 内置的网络诊断工具，它有时会出现误报（显示成功但实际无法调用特定模型）。

最稳妥的验证方式是直接进行对话测试：

1. 关闭 Auto 模式，手动切换到需要代理才能使用的模型（如 Claude 系列、GPT 系列、Gemini 系列）。
2. 发送任意消息，如果能正常响应，说明代理配置生效。

原理与注意事项

理解底层机制有助于排查问题。

• 应用内代理设置：这是最优先的方式。你在 Cursor 设置里填的 http://... 会控制所有发往网络的请求，包括拉取模型、调用 API 和检查更新。填对一次即可全局生效。
• 环境变量：HTTP_PROXY / HTTPS_PROXY 是 Electron 应用的通用约定。如果你在启动 Cursor 前设置了这些环境变量，Cursor 也会继承。这适合脚本化启动场景。
• 系统代理：部分请求可能跟随系统代理，但这取决于操作系统 API 的支持情况，稳定性不如应用内显式配置。

可以把 Cursor 想象成「要出门的人」，代理是「小区门卫」。你填的 Http: Proxy 就是告诉 Cursor「以后出门都先经过这个门卫」；环境变量则是你在「出门前」跟整台电脑说好「所有从这台机器出去的请求都走门卫」；系统代理则是「小区统一规定」，有的程序听、有的不听，不如自己当面说清楚稳当。

常用配置参考

• Http: Proxy：在 Cursor 设置里填一次，所有拉模型、调 API、更新都走这条通道。
• 环境变量 HTTP_PROXY / HTTPS_PROXY：在启动 Cursor 前设好，适合脚本或全局走代理。
• 本地代理地址：常见为 http://127.0.0.1:端口 或 socks5://127.0.0.1:端口，端口以你本地代理软件为准（如 7890、1080）。

Cursor 官方文档