连接超时 (Timeout)
尝试连接 Cursor 服务器时长超过 30 秒无响应,多见于代理配置不当或防火墙拦截。
SSL 证书错误
提示 "Self-signed certificate" 或证书验证失败,通常由安全软件劫持流量引起。
模型加载失败
侧边栏显示 "Error loading models",可能是因为 DNS 解析无法命中 Cursor 的后端 API。
Step 01
全局代理配置
Cursor 基于 VS Code 内核,但其 AI 服务请求路径较为特殊。如果您使用代理软件,请务必开启全局模式,或在配置文件中加入以下域名规则:
DOMAIN-SUFFIX,cursor.sh,proxy
DOMAIN-SUFFIX,cursor.com,proxy
DOMAIN-SUFFIX,anthropic.com,proxy
DOMAIN-SUFFIX,cursor.com,proxy
DOMAIN-SUFFIX,anthropic.com,proxy
确保您的系统代理设置已正确映射至 Cursor 的网络偏好。在 Cursor 设置中搜索 "Proxy" 并填入您的本地监听端口(如 127.0.0.1:7890)。
[ 代理设置界面示意图 ]
Step 02
清除证书缓存
如果更换过网络环境后无法联网,尝试清理 Cursor 的本地网络缓存。这可以解决大部分由于旧连接状态残留导致的 403 错误。
对于 Windows 用户:
%AppData%\Cursor\Code\CachedData
删除此文件夹下的内容并重启 Cursor。对于 Mac 用户,路径位于 ~/Library/Application Support/Cursor/。
[ 缓存目录路径参考图 ]
Step 03
DNS 优化与 Host 绑定
有时 DNS 污染会导致无法连接。建议将系统 DNS 修改为 Google DNS (8.8.8.8) 或 Cloudflare DNS (1.1.1.1)。
若依然无效,可尝试在 hosts 文件中手动指定 Cursor API 的 IP 地址。请注意,API 地址可能会随官方维护而变动,请优先使用前两种方案。
[ DNS 设置优化指南图 ]