3 分钟学会给 Cursor 配置代理
Cursor 作为基于 VS Code 的 AI 编辑器，在连接模型服务时经常遇到网络限制。如果你发现无法调用 API 或者模型加载失败，大概率是网络通道的问题。下面分享两种最稳妥的配置方案，以及验证是否生效的方法。
方案一：直接覆盖配置文件（推荐）
这是最快且最彻底的方式，适合熟悉设置文件的开发者。
- 打开 Cursor，按
Cmd + Shift + P（Mac）或Ctrl + Shift + P（Windows）打开命令面板。 - 搜索并选择 Preferences: Open User Settings (JSON)。
- 备份原有内容后，将以下内容全部覆盖进去：
{
"http.proxy": "http://127.0.0.1:7890",
"http.proxySupport": "override",
"http.proxyStrictSSL": false,
"http.noProxy": [],
"git.enableSmartCommit": true,
"explorer.confirmDelete": false,
"cursor.composer.shouldChimeAfterChatFinishes": true,
"workbench.colorTheme": "Solarized Light",
"cursor.general.disableHttp2": true
}
注意：
http.proxy中的地址需替换为你本地代理软件的监听地址，端口通常是 7890 或 1080。cursor.general.disableHttp2设为true很重要，部分代理对 HTTP/2 支持不佳，强制降级为 HTTP/1.1 能避免很多连接超时问题。
- 保存文件，重启 Cursor 使配置生效。
方案二：通过界面填写代理
如果你不想动代码，可以直接在图形界面操作。
- 打开 Cursor 设置，快捷键
Cmd + ,（Mac）或Ctrl + ,（Windows）。 - 在搜索框输入 proxy。
- 找到 Http: Proxy 项，填入你的代理地址，例如
http://127.0.0.1:7890或socks5://127.0.0.1:7890。- 确保你的代理软件允许局域网连接。
- 如果涉及 HTTPS 校验，可根据实际情况勾选 Http: Proxy Strict SSL。
- 同样需要进入 Network 管理页面，将 HTTP 协议版本改为 HTTP/1.1。
如何验证配置是否成功？
这里有个坑：不要依赖 Cursor 自带的网络诊断工具。有时候它显示成功，但实际走的还是直连，导致某些模型（如 Sonnet、GPT 系列）依然无法使用。
最靠谱的验证方式是手动切换模型测试：
- 关闭 Auto 模式，弹出模型选择列表。
- 选择 claude 系列（opus、sonnet）、gpt 系列或 Gemini 等需要外网连接的模型。
- 随便聊两句，如果能正常响应，说明代理配置生效了。
原理简析
Cursor 底层基于 Electron，和 VS Code 一样，主要通过 Http: Proxy 控制发往网络的请求通道。
- 设置内填 Http Proxy：最直接，只影响 Cursor 进程，全局生效拉模型、调 API、检查更新等操作。
- 环境变量 HTTP_PROXY / HTTPS_PROXY：适合脚本启动或全局走代理的场景，Cursor 启动时会继承这些变量。
- 系统代理：依赖系统 API，有时只对部分请求生效，稳定性不如显式配置。
可以把 Cursor 想象成'要出门的人'，代理就是'小区门卫'。你在设置里填的地址，相当于告诉 Cursor'以后出门都先经过这个门卫'；环境变量则是你出门前跟整台电脑说好'所有从这台机器出去的请求都走门卫'；而系统代理更像是'小区统一规定'，有的程序听、有的不听，不如自己当面说清楚稳当。
| 配置方式 | 作用范围 | 稳定性 |
|---|---|---|
| Cursor 设置 Http Proxy | 仅 Cursor 应用 | ⭐⭐⭐⭐⭐ |
| 环境变量 | 全局进程 | ⭐⭐⭐⭐ |
| 系统代理 | 依赖系统支持 | ⭐⭐⭐ |
只要把 Http: Proxy 填对一次，后续基本不用操心。遇到网络问题时，优先排查这里，通常比改系统环境更省心。
