🚀

Cursor IDE 代理配置完整指南

让 Cursor 在保持 HTTP/2 高速传输的同时，通过本地代理访问 Gemini 等模型

📋 目录

  1. 问题背景
  2. 解决方案概述
  3. 准备工作
  4. 配置步骤
  5. 验证与测试
  6. 故障排查
  7. 进阶技巧

🔍 问题背景

常见症状

  • 即使开启代理，Cursor 仍频繁提示：
    • "Model not available"
    • "We're having trouble connecting to the model provider"
  • 响应速度极慢，像"老牛拉破车"

问题根源

  • 旧方案缺陷：关闭 HTTP/2 并在 Cursor 内直接配置代理
    • ❌ HTTP/1.1 回退导致失去流式响应优势
    • ❌ 速度大幅下降
    • ❌ 配置冲突

新解决方案

✅ 使用 Proxifier 系统级代理，同时保持 HTTP/2 开启

💡 解决方案概述

graph LR
    A[Cursor IDE] -->|HTTP/2| B[Proxifier]
    B -->|转发| C[本地代理]
    C -->|SOCKS5/HTTP| D[Clash/V2Ray/Surge]
    D -->|科学上网| E[Gemini API]

核心思路：让 Proxifier 接管 Cursor 的所有网络流量，保持 HTTP/2 传输优势

🛠️ 准备工作

必需软件

软件
版本要求
下载地址
说明
Cursor IDE
≥ 0.48.x
cursor.com
确保是最新版本
Proxifier
Windows: 4.x / macOS: 3.x
proxifier.com
系统级代理工具
本地代理
任意版本
-
Clash/V2Ray/Surge等

⚠️ 重要提醒

如果你之前已经：

  • 在 Cursor 内配置了 Network Proxy
  • 关闭了 HTTP/2
  • 在 VS Code 设置中填写了 http.proxy

请先清除这些设置，否则会造成配置冲突！

📝 配置步骤

步骤 1️⃣：恢复 Cursor 默认设置

  1. 打开设置
    • Windows/Linux: Ctrl + ,
    • macOS: ⌘ + ,
  2. 启用 HTTP/2
    • 搜索：http2
    • 确保 "Disable HTTP/2" 处于未勾选状态 ✅
  3. 清除代理设置
    • 搜索：proxy
    • 清空 Network Proxy 字段
    • 保存设置

步骤 2️⃣：配置 Proxifier

A. 添加本地代理服务器

  1. 打开 Proxifier
  2. 菜单：Profile → Proxy Servers → Add
  3. 填写配置：
    4. 地址：127.0.0.1
端口：10809（根据你的代理软件调整）
协议：SOCKS v5
  4. 点击 Check 测试连接
    • ✅ 显示 "Successfully connected" 即可继续

B. 创建 Cursor 专属规则

  1. 菜单：Profile → Proxification Rules → Add
  2. 配置规则：
    3. 字段
    设置值
    Name
    Cursor IDE
    Applications
    Windows: Cursor.exe; cursor.exe / macOS: Cursor.app
    Target Hosts
    Any
    Target Ports
    Any
    Action
    选择刚添加的代理 SOCKS5 127.0.0.1:10809
  3. 重要：将此规则拖动到规则列表的最上方

步骤 3️⃣：启动顺序

1. 启动本地代理软件（Clash/V2Ray/Surge）
   ↓
2. 启动 Proxifier（确认状态栏显示 Ready）
   ↓
3. 启动 Cursor IDE

✅ 验证与测试

方法一：功能测试

  1. 在 Cursor 中打开任意代码文件
  2. 选中一段代码，按 Ctrl/⌘ + K
  3. 观察响应速度：
    • ✅ 快速显示 "Generating..." 并返回结果
    • ❌ 长时间无响应或报错

方法二：流量监控

在 Proxifier 主界面查看 Connections 标签：

  • 应该看到类似记录：
    • api2.cursor.sh:443 → 127.0.0.1:10809 SOCKS5

🔧 故障排查

常见问题速查表

问题现象
可能原因
解决方案
仍然提示"Model not available"
代理端口错误
检查代理软件实际端口 `netstat -ano
TAB 补全卡住
HTTP/2 被阻断
1. 确认 HTTP/2 已启用 2. 尝试切换网络环境
Proxifier 无流量记录
规则未生效
1. 确认规则已勾选 Enabled 2. 检查应用程序路径是否正确
macOS 无法捕获流量
权限问题
系统设置 → 网络 → 代理，允许 Proxifier 系统扩展

诊断命令

# Windows - 检查端口占用
netstat -ano | findstr :10809

# macOS/Linux - 检查端口占用
lsof -i :10809

# 测试代理连通性
curl -x socks5://127.0.0.1:10809 https://api.cursor.sh

🎯 进阶技巧

1. 自动分流规则（Clash 示例）

rules:
  - DOMAIN-SUFFIX,cursor.sh,Proxy
  - DOMAIN-SUFFIX,anthropic.com,Proxy
  - DOMAIN-SUFFIX,openai.com,Proxy

2. 平台特定方案

Windows 替代方案

  • 使用 v2rayN 的 Tun Mode
  • 在 Routing 设置中排除 clash*.exe

macOS 替代方案

  • 使用 Surge 的 Process Proxy 功能
  • 直接指定 Cursor.app

3. 性能监控

Proxifier 提供详细的流量统计：

  • Statistics 页面可导出 CSV
  • 可配合 Grafana 制作可视化图表
  • 监控不同节点的速度差异