3 分钟学会给 Cursor 配置代理

注意：http.proxy 中的地址需替换为你本地代理软件的监听地址，端口通常是 7890 或 1080。cursor.general.disableHttp2 设为 true 很重要，部分代理对 HTTP/2 支持不佳，强制降级为 HTTP/1.1 能避免很多连接超时问题。

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. 同样需要进入 Network 管理页面，将 HTTP 协议版本改为 HTTP/1.1。

如何验证配置是否成功？

这里有个坑：不要依赖 Cursor 自带的网络诊断工具。有时候它显示成功，但实际走的还是直连，导致某些模型（如 Sonnet、GPT 系列）依然无法使用。

最靠谱的验证方式是手动切换模型测试：

1. 关闭 Auto 模式，弹出模型选择列表。
2. 选择 claude 系列（opus、sonnet）、gpt 系列或 Gemini 等需要外网连接的模型。
3. 随便聊两句，如果能正常响应，说明代理配置生效了。

原理简析

Cursor 底层基于 Electron，和 VS Code 一样，主要通过 Http: Proxy 控制发往网络的请求通道。

• 设置内填 Http Proxy：最直接，只影响 Cursor 进程，全局生效拉模型、调 API、检查更新等操作。
• 环境变量 HTTP_PROXY / HTTPS_PROXY：适合脚本启动或全局走代理的场景，Cursor 启动时会继承这些变量。
• 系统代理：依赖系统 API，有时只对部分请求生效，稳定性不如显式配置。

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

只要把 Http: Proxy 填对一次，后续基本不用操心。遇到网络问题时，优先排查这里，通常比改系统环境更省心。