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. 进入 Network（网络管理）页面，将 HTTP 协议改成 HTTP1.1。

验证配置是否成功

不要仅依赖 Cursor 的网络诊断工具，因为它可能显示成功但实际未走代理。最好的验证方式是直接和 Agent 聊天，手动切换到需要代理才能使用的模型（如 Claude 系列、GPT 系列、Gemini 系列）。如果正常响应，则配置成功。

原理说明

Cursor 基于 VS Code（Electron），通过 Http: Proxy 控制发往网络的请求通道。你在设置里填的地址会被用于拉取模型、调用 API、检查更新等。

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

参考资料

Cursor 官方文档