💻 Cursor 编辑器 AI 编程代理与自定义 API 中转配置教程
Cursor 作为新一代爆火的 AI 驱动代码编辑器，其强大的 Tab 补全与 Composer 自动多文件重构功能深受程序员喜爱。然而，默认的官方 Pro 订阅费用较为昂贵（20美元/月），且在国内直连访问 OpenAI 或 Anthropic 服务器时常遭遇网络连接超时。通过配置网络代理或使用第三方中转 API Key，可以以极低成本实现满血编程体验。本教程为您详解全部步骤。
一、网络代理环境配置（针对官方订阅用户）
如果您已经订阅了 Cursor Pro，但在提问时频繁遇到网络连接错误，需配置全局代理：
由于 Cursor 的内部 Node 进程有时会跳过普通的 HTTP 系统代理，建议在 Clash Verge 中启用「TUN 模式 (Tun Mode)」或使用 NekoBox 的 VPN 转发。这能确保所有 API 请求强制走所选的海外专线节点。
二、使用第三方 API 密钥中转配置（低成本方案）
若您希望按量计费，使用自备的 OpenAI Key 或第三方中转服务，请按以下步骤配置：
点击 Cursor 界面右上角齿轮图标（设置），或使用快捷键 Ctrl + , (Mac 为 Cmd + ,)，进入 Cursor Settings 页面。
在左侧菜单点击 Models。在此处您可以看到当前支持的所有底层大语言模型（如 Claude-3.5-Sonnet、GPT-4o 等）。
展开 OpenAI API Key 选项，填入您的密钥（以 sk- 开头）。若使用的是中转 API 服务，请打开 Override OpenAI Base URL 选项，输入中转站提供的 Base 地址（例如 https://api.your-relay-domain.com/v1），点击 Verify 完成验证。
三、添加顶级模型与高效率编程技巧
在 Models 列表中，确保 claude-3-5-sonnet 处于勾选开启状态。如果在下拉框中没找到，可在输入框手动输入 claude-3-5-sonnet 并点击 Add Model 添加。
在编辑代码时按下 Ctrl + I 唤出 Composer，可以直接用中文输入指令（例如：“帮我重构这个 API 路由文件并增加错误捕获”），AI 将自动在多文件间完成精准编辑。
四、常见报错与排查清单
- 401 Unauthorized 报错：说明填入的 API Key 错误或余额耗尽，请检查中转平台的额度状态。
- 403 IP 区域限制 (Country Unsupported)：说明您的节点被 OpenAI 封禁，请在代理客户端中切换至非香港地区（如美国、日本、新加坡）节点。