Cursor 配置网络代理：3 分钟搞定模型访问

提示：http.proxy 地址请替换为你本地代理软件的地址，如 socks5://127.0.0.1:7890。

3. 保存后，点击首选项进入 Network 页面，将 HTTP 协议强制改为 HTTP/1.1。
4. 重启 Cursor 使配置生效。

方案二：在设置界面填写

如果不习惯改代码，可以直接在 UI 中操作：

1. 按 Cmd + ,（Mac）或 Ctrl + ,（Windows）打开设置。
2. 搜索 proxy。
3. 在 Http: Proxy 栏填入你的代理地址。
4. 如果涉及 HTTPS 校验，按需勾选 Http: Proxy Strict SSL。
5. 同样记得去 Network 设置里把 HTTP 协议改成 HTTP/1.1。

如何验证配置是否成功？

不要完全依赖 Cursor 自带的网络诊断工具，有时候它会误报成功，但实际模型调用依然失败。

最稳妥的方法是直接测试模型对话：

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

原理简析

Cursor 基于 VS Code（Electron）架构，其网络请求控制逻辑与 VS Code 一致。

• Http: Proxy：应用内设置，优先级最高。告诉 Cursor 所有发往网络的请求都经过这个网关。适合解决特定应用的网络问题。
• 环境变量：如 HTTP_PROXY / HTTPS_PROXY。在启动 Cursor 前设置，适合脚本化场景或全局代理环境。
• 系统代理：依赖操作系统 API，有时对部分 Electron 应用不生效，稳定性不如应用内显式配置。

可以把 Cursor 想象成要出门的人，代理就是小区门卫。填好 Http: Proxy 就是明确告诉 Cursor'以后出门先找这个门卫'，比单纯依赖系统规定更稳妥。

关键配置项速记

• Http: Proxy：填一次即可，拉取模型、调 API、检查更新都会走这条通道。
• 本地代理地址：常见为 http://127.0.0.1:端口 或 socks5://127.0.0.1:端口，端口取决于你的代理软件（如 7890、1080）。
• HTTP/1.1：务必开启，避免 HTTP/2 握手失败导致连接超时。

参考文档：Cursor 官方文档