Cursor 配置网络代理的方法与验证

6. 重启 Cursor 使代理设置生效。

方法二：在 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 使代理生效。
6. 点击首选项，选择 Cursor 首选项配置，进入 network（网络管理）页面，将 HTTP 协议改成 HTTP1.1。

验证配置

不要使用 Cursor 的网络诊断工具，因为可能会出现未配置成功但显示成功的误报情况。

最好的验证方式是直接和 Agent 聊天，手动切换到需要代理才能使用的模型（如 Claude 系列、GPT 系列、Gemini 系列）。

1. 关闭自动选择模型功能。
2. 选择 claude 系列（opus、sonnet、haiku）、gpt 系列、谷歌系列（Gemini 3 Pro）等。
3. 和他们对话，任何话题都可以，只要正常响应就是成功了。

原理说明

Cursor 基于 VS Code（Electron），和 VS Code 一样，通过 Http: Proxy 控制发往网络的请求走哪条通道。你在设置里填的 http://... 或 socks5://... 会被用于拉模型、调 API、检查更新等，所以填对一次即可全局生效。

环境变量 HTTP_PROXY / HTTPS_PROXY 是很多命令行和 Electron 应用的通用约定，在「先设变量再启动」的场景下同样有效。系统代理则依赖系统 API，有时只对部分请求生效。

遇到问题时，优先用 Cursor 自带代理设置更稳。可以把 Cursor 想象成「要出门的人」、代理是「小区门卫」：你填的 Http: Proxy 就是告诉 Cursor「以后出门都先经过这个门卫」，门卫再帮你转发到外网；环境变量则是你在「出门前」先跟整台电脑说好「所有从这台机器出去的请求都走门卫」，Cursor 启动时就会继承这句话；系统代理则是「小区统一规定」，有的程序听、有的不听，不如自己当面说清楚稳当。

注意事项

• Http: Proxy：在 Cursor 设置里填一次，所有拉模型、调 API、更新都走这条通道。
• 环境变量 HTTP_PROXY / HTTPS_PROXY：在启动 Cursor 前设好，适合脚本或全局走代理。
• 系统代理：依赖系统 API，只对部分请求生效，不稳时优先用设置内显式填写。
• 本地代理地址：常见为 http://127.0.0.1:端口 或 socks5://127.0.0.1:端口，端口以你本地代理软件为准（如 7890、1080）。