国内用 Cursor，卡住的地方几乎从来不是安装本身。真正让人反复折腾的是登录之后那一步：编辑器正常打开，侧边栏正常展开，一发请求就弹报错。这篇把 Cursor 国内使用会遇到的问题按发生顺序拆开，从下载、注册登录一直讲到模型请求真正跑通，每一层各自该改什么、改完怎么验证，都写清楚。
三层问题必须分开看
分层是省时间的前提。同样是「用不了」，背后可能是三个毫不相干的原因，表现却很像。
- 下载层：官网打不开、安装包拉到一半超时、自动更新失败。这一层只跟普通 HTTPS 出口有关，最容易解决。
- 登录层：注册、邮箱验证码、OAuth 回调跳转。这一层走的是系统默认浏览器，和编辑器进程的网络设置是两套东西。
- 模型层：编辑器进程直接向 Cursor 后端发请求。这一层既受代理配置影响，也受出口 IP 归属地影响，是真正的门槛。
网上大多数教程只覆盖前两层，所以照着做完仍然用不了模型。看到报错先判断它属于哪一层，再决定动哪个开关。
安装：只用官网渠道
安装包请从 cursor.com 下载。国内有不少「加速版」「汉化版」的二次打包，这类包会改动 Electron 的启动参数甚至内置证书，一旦出问题你根本无法判断故障来自网络还是来自包本身。Cursor 自带的自动更新也会在二次打包上失效。
Windows 用户装完建议不要放在带中文或空格的路径下。macOS 首次启动如果被 Gatekeeper 拦下，正常走系统设置里的允许即可。装完先别急着登录，先把网络那一层处理好，否则登录态可能在半路握手失败，留下一个看起来已登录、实际不可用的状态。
登录：验证码收不到多半不是网络问题
Cursor 支持邮箱验证码和第三方账号登录。国内常见的问题是验证码迟迟不到，很多人第一反应是换代理，其实更常见的原因是邮箱服务商把发信方判成了营销邮件。优先用 Gmail 或 Outlook 这类对英文服务商发信宽容的邮箱，收件箱没有就翻垃圾箱。
如果用 GitHub 账号登录，注意回调会拉起系统默认浏览器。浏览器的代理状态和 Cursor 的代理状态不一致时，会出现浏览器授权成功、编辑器一直转圈的情况。把两边放在同一条链路上再试。
模型层：Cursor 不会自动跟随系统代理
这是 Cursor 国内使用最核心的一条。Cursor 基于 Electron，它不会自动读取系统代理设置。你在系统里挂了代理、浏览器能正常访问 Google，并不代表 Cursor 的请求走了同一条路。很多人卡在这里，反复换机场却一直没有效果，因为流量压根没进代理。
第一步：代理软件开 TUN 或全局模式
最省事的做法是让代理软件接管整机流量。Clash 系客户端打开 TUN 模式，或者直接切到全局模式；其他客户端找对应的虚拟网卡或全局选项。规则模式下的分流表通常不包含 Cursor 的后端域名，走不进代理是常态。
第二步：在 settings.json 里显式指定
如果你不想开 TUN，就得在 Cursor 里手动指定代理。打开设置的 JSON 编辑视图，加入这三项：
{
"http.proxy": "http://127.0.0.1:7890",
"http.proxySupport": "override",
"cursor.general.disableHttp2": true
}三项缺一不可。http.proxy 指定出口，http.proxySupport 设为 override 才能让扩展宿主进程也走同一条路，cursor.general.disableHttp2 则用来规避部分代理实现对 HTTP/2 的兼容问题。改完必须完全退出并重启 Cursor，只关窗口不算。
端口填你实际在用的那一个，常见默认值如下。
| 代理客户端 | 默认本地端口 | 备注 |
|---|---|---|
| Clash | 7890 | 混合端口，HTTP 与 SOCKS 共用 |
| V2RayN | 10809 | HTTP 端口，SOCKS 通常为 10808 |
| Surge | 6152 | macOS 下常见默认值 |
| Shadowrocket | 1087 | 桌面联动时使用 |
第三步：节点别选香港
Cursor 按 IP 做区域限制。如果出口被识别为中国大陆或香港，即使你已经付费订阅，模型请求依然会被拒，弹出的提示是 This model is not available in your region。换句话说，付费解决不了归属地问题。把节点切到日本、新加坡、美国这类常规落地，绝大多数情况就通了。这个报错的完整排查流程我们单独写过一篇，见模型地区限制的解决方法。
一份可复现的排查顺序
按这个顺序走，基本不会漏项，也不会在错误的地方浪费时间。
- 代理客户端开 TUN 或全局，确认节点不是香港、不是大陆中转。
- 浏览器访问一个境外站点，确认链路本身是通的。
- 写入上面三项 settings.json 配置，端口对齐实际值。
- 完全退出 Cursor 再启动，不要只关窗口。
- 新建一个空文件，用 Tab 补全试一下。补全能出说明基础链路通了。
- 再开 Agent 发一条简单指令，观察是区域报错还是超时。区域报错换节点，超时查代理。
如果第五步就失败，问题一定在网络层，别去怀疑账号。如果第五步正常、第六步报区域限制，那就是节点归属地的问题。两者的处理方式完全不同。
订阅层面国内能用到什么
网络通了之后，能用到多少取决于你的订阅等级。Cursor 目前的付费档位是 Pro 每月 20 美元、Pro+ 每月 60 美元、Ultra 每月 200 美元，Teams 按人头每月 40 美元。免费的 Hobby 档没有 Other Models 额度，Agent 相关能力也非常有限。
需要注意的是 Cursor 把模型分成两个池子：Cursor Models（包含 Cursor Grok 4.6、Grok 4.5 和 Composer 2.5）和 Other Models（第三方模型，按各家 API 价格计费）。付费档位里附带的美元额度对应的是 Other Models 池，Pro 附带 20 美元、Pro+ 附带 70 美元、Ultra 附带 400 美元。Cursor Models 池的用量随档位提升，但官方没有公布确切倍数。各档位的取舍我们在订阅价格全解析里算过账。
另外三个付费档都包含不限量的 Tab 补全、Bugbot、Cloud Agents、MCP、skills 和 hooks，这部分不随价格变化，所以升级买的主要是 Agent 用量而不是功能。
网络都调好了还是用不了，怎么办
还有一类情况和网络无关：账号本身状态异常，或者你在国内很难完成订阅付款。国内信用卡在 Cursor 的收银台失败率不低，这一块的原因和绕法我们整理在付款方式那篇里。
如果你只是想先把环境跑起来，看看 Agent 在自己项目上到底能干多少活，再决定要不要长期投入，可以考虑用已激活的账号先试一个月。我们提供 Cursor Pro 1 个月个人账号激活，省掉收银台那一步。需要说明的是，这属于独立的第三方激活服务，Cursor 官方订阅只在 cursor.com 出售，官方也不授权任何经销商，具体风险请自行权衡，我们在账号安全那篇里讲得很直白。
常见问题
为什么浏览器能上网，Cursor 却连不上？
因为 Cursor 基于 Electron，默认不跟随系统代理设置。浏览器走的是系统代理或自身配置，Cursor 的主进程和扩展宿主进程则需要单独指定。解决办法是代理客户端开 TUN 模式接管整机流量，或者在 settings.json 里写入 http.proxy 与 http.proxySupport 两项，然后完全重启编辑器。
香港节点为什么不行？
Cursor 的区域限制把香港和中国大陆归在同一类处理，出口 IP 落在香港时模型请求会被拒绝，提示 This model is not available in your region。这跟你是否付费无关。换成日本、新加坡、美国等常规落地节点即可，切换后记得完全重启 Cursor 让连接重建。
改了 settings.json 没有效果是什么原因？
最常见的是三项没配齐，只写了 http.proxy 而漏掉 http.proxySupport，扩展宿主进程仍然直连。其次是端口填错，Clash 默认 7890、V2RayN 默认 10809，两者不能互换。最后是没有真正重启，关闭窗口不等于退出进程，Windows 下需要确认托盘和任务管理器里没有残留。
免费版在国内值得先用吗？
值得用来验证网络链路是否通畅，不值得用来评估 Cursor 的真实能力。Hobby 档没有 Other Models 额度，Agent 能力也非常受限，你看到的只是补全部分。想判断 Agent 是否适合自己的项目，至少要在 Pro 档上跑几天真实任务才有参考价值。
需要每次写代码都开着全局代理吗？
是的，只要你在用模型能力就需要保持链路可用。Tab 补全、Agent、Bugbot 都是实时请求后端的。如果嫌全局模式影响国内站点访问速度，可以用 TUN 配合分流规则，把 Cursor 的后端域名单独加进代理规则，其余流量直连。
