Cursor 配置网络代理设置教程

在检索框里搜索'User'，并打开搜索结果中的'Open User Settings (JSON)'进行修改。

方法二：在 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（网络管理）页面。
7. 将 HTTP 协议改成 HTTP1.1。

验证配置是否成功

不建议直接使用 Cursor 的网络诊断工具，因为可能出现误报。最好的验证方式是直接和 Agent 聊天，手动切换到需要代理才能使用的模型（如 Sonnet 系列）。

1. 选择 claude 系列（opus、sonnet、haiku）、gpt 系列（GPT-5.3 Codex）、谷歌系列（Gemini 3 Pro），这些都是需要代理才能使用的模型。
2. 和他们对话，任何话题都可以，只要正常响应就是成功了。

关闭 auto 后弹出选择模型的列表。

原理讲解

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）。

参考资料

Cursor 官方文档