11号登机口GATE 11 · 机场推荐与选购笔记
AI 工具 · Cursor

Cursor 使用教程(2026):国内下载安装、代理设置与模型不可用

Cursor 使用教程:Cursor 怎么用、国内怎么下载安装、代理怎么设置、模型不可用怎么办、怎么设置中文。只从官网 cursor.com/download 下载,讲系统代理与 TUN、Network 页的 HTTP 兼容模式与诊断、节点地区验证,以及模型列表缺模型的原因。

更新于 约 6507 字 · 14 分钟读完11号登机口编辑
快速结论

这篇 Cursor 使用教程先说结论:Cursor 从官网下载页安装,登录时会跳到浏览器完成授权。网络上优先用系统代理,登录或对话连不上就打开 TUN 模式。对话卡住、流式输出异常时,到 Cursor 设置的 Network 页把 HTTP 兼容模式改成 HTTP/1.1,并运行一次诊断。模型列表里少了某些模型,官方的解释是部分模型提供方有地区限制,受限的模型不会报错,而是直接不显示。下文按国内准备、下载、登录、日常用法、代理、模型、节点、报错的顺序讲。

Cursor 国内怎么用:先弄清它卡在哪一层

Cursor 本身是一个编辑器,打开和写代码不需要联网,但登录、AI 对话、代码补全、模型列表都要连 Cursor 的服务器,再由它转到各家模型提供方。国内用户遇到的问题分三层:

层级 典型现象 原因 对应章节
连不上 Cursor 登录一直等待、对话转圈 应用的流量没走代理 下文「代理设置」
能连上但模型少了 列表里没有某些 Claude 或 GPT 模型 出口地区受模型提供方限制 下文「模型不可用」
能用但不稳 回答中断、Agent 任务跑一半停 节点抖动或出口在变 下文「用什么节点」

所以国内用 Cursor 的准备是:代理客户端选一个美国、日本、新加坡等地区的节点并手动固定;先开系统代理,登录不顺就开 TUN;装好后在 Network 页跑一次诊断,再看模型列表是否齐全。账号只要邮箱或第三方账号就能注册,没有手机号验证这一关,比 Claude 简单。

Cursor 下载安装:官网安装包怎么选

官方下载页是 https://cursor.com/download,文档在 https://cursor.com/docs。下载页按系统给出安装包,本文更新时的选项如下:

系统 官方提供的安装包 怎么选
macOS ARM64、x64、Universal Apple 芯片选 ARM64,Intel 芯片选 x64,不确定就选 Universal
Windows x64 与 ARM64,各分 System 和 User 两种安装方式 普通电脑选 x64;User 版装在当前用户目录,不需要管理员权限
Linux deb、RPM、AppImage,各有 x64 与 ARM64 按发行版选择,AppImage 不需要安装

下载页还给出了命令行版本的安装命令:

curl https://cursor.com/install -fsS | bash

三点提醒:

  1. 下载页本身和安装包的下载地址都可能需要代理才能顺利访问。下载到一半失败,多半是节点不稳,换一个节点重试,而不是去找"国内镜像"。
  2. 不要使用第三方的破解版、汉化整合包或所谓"无限试用"补丁。它们会修改程序和设备标识,账号被封只是最轻的后果,更大的风险是你的代码和令牌经过了别人改过的程序。
  3. Cursor 基于 VS Code,原有的扩展和设置大多可以导入,首次启动的向导会询问。

所有工具的入口汇总和辨别仿冒站的方法见 AI 工具官方下载入口。

各平台的差异。 同一个 Cursor,在不同系统上读取代理的方式不完全一样:

平台 安装要点 网络怎么接入 需要留意
macOS 下载后拖进应用程序文件夹 大多跟随系统代理 官网下载的正式版不应出现"已损坏"提示,出现了就重新下载,不要强行放行
Windows User 版不需要管理员权限,System 版给所有用户安装 大多跟随系统代理 安全软件可能拦截代理客户端修改系统代理,被拦时改用 TUN
Linux deb、RPM 按发行版装,AppImage 赋予执行权限后直接运行 是否读取系统代理取决于桌面环境 最省事是开 TUN
命令行版 下载页给出的安装命令 不读系统代理 用环境变量或 TUN,见 终端走代理

从 VS Code 迁移时的网络设置。 首次启动导入 VS Code 的设置时,原来填过的 http.proxy 也会被带过来。如果那个地址指向的是旧代理客户端的端口,或者你后来换了客户端、端口变了,Cursor 的部分请求会发往一个不存在的代理,表现为时好时坏、诊断里个别项目失败。导入之后在设置里搜索 proxy,确认地址和端口与当前客户端一致,不用的就清空。导入的扩展也要从扩展市场重新下载,市场本身连不上时,先把网络问题解决再导入。

注册与登录

Cursor 的账号在官网注册,登录方式以页面当时提供的为准,一般包括邮箱和第三方账号。应用内的登录流程是这样的:

  1. 在 Cursor 里点击登录,应用会调起系统默认浏览器。
  2. 在浏览器里完成登录和授权。
  3. 浏览器把结果交回应用,Cursor 显示已登录。

这个流程跨了浏览器和应用两个程序,常见的卡点也在这里:

  • 浏览器能打开登录页,应用却一直显示等待。 浏览器走了代理,Cursor 应用自己的请求没有走。打开 TUN 模式,或者确认系统代理对 Cursor 生效后重试。
  • 浏览器登录页打不开。 官方网络文档列出的登录域名在 cursor.sh 下面,确认分流规则把 cursor.sh 和 cursor.com 都放到了代理一侧。
  • 第三方账号登录卡住。 用 Google 或 GitHub 账号登录时,对应网站也要能正常访问,并且最好和 Cursor 走同一个出口。
  • 浏览器登录完成后没有跳回应用。 浏览器会询问是否打开 Cursor,要选允许;不小心点了取消,回到应用里重新点一次登录。
  • 邮箱验证码收不到。 先翻垃圾箱,企业邮箱可能拦截外部邮件,换个人邮箱试;验证码有有效期,过期就重新获取。
  • 在几台电脑上同时登录。 这是正常用法,但几台电脑最好用同一地区的节点,避免同一账号同时出现在几个国家。

订阅和账单在官网的账号后台管理,支付方式以官方页面为准。不要购买共享账号或低价转售的席位,这类账号的归属不在你手里。

Cursor 代理设置:系统代理、TUN 与 Network 设置

Cursor 有三层和网络有关的设置,按下面的顺序考虑。

第一层:系统代理。 代理客户端打开系统代理后,Cursor 的大部分请求会跟着走。这是最省事的状态,建议作为起点。修改系统代理后要完全退出 Cursor 再打开,只关闭窗口不算。

第二层:TUN 模式。 系统代理管不到所有流量。Cursor 内置终端里运行的命令、扩展自己发起的请求、命令行版本,都可能绕过系统代理。出现"编辑器里的对话正常,终端里 git 或 npm 连不上",或者登录和对话时断时续,就打开代理客户端的 TUN 模式,把整台电脑的流量接管。原理见 规则、全局与 TUN 模式,开不了见 TUN 模式开不了。

第三层:应用内的 Network 设置。 官方排错文档给出的位置是 Cursor Settings 里的 Network 页,其中有两样东西:

  • HTTP Compatibility Mode。 官方说明 Cursor 默认用 HTTP/2 做流式响应,而某些代理会拦截或破坏 HTTP/2。把这一项改成 HTTP/1.1 并重启 Cursor,是官方给出的处理办法。官方网络文档还提到,流式传输失败时 Cursor 会自动回退到基于 HTTP/1.1 的方式,但自动回退不灵时,手动改这一项更直接。
  • Run Diagnostics。 一键检测到各个服务的连通情况,结果里哪一项失败,就对着哪一项排查。

Cursor 沿用了 VS Code 的设置体系,在编辑器设置里搜索 proxy,通常能看到 VS Code 原有的代理地址选项,可以填入代理客户端的本地地址,例如 http://127.0.0.1:7890,端口以客户端显示的为准。但 Cursor 的官方文档没有说明这一项对它自己的 AI 请求是否全部生效,所以把它当作补充手段,主要依靠系统代理或 TUN。

场景 建议
只用编辑器里的对话和补全 系统代理,规则模式
还要在内置终端里拉代码、装依赖 TUN 模式,或给终端单独设置环境变量
对话经常卡在生成中 Network 页改为 HTTP/1.1,再考虑换节点
公司网络加上自己的代理 先弄清是哪一层在拦截,再运行诊断
使用命令行版本 按终端程序处理,见 终端、Git、npm、Docker 走代理

官方文档里还有一个不起眼的提示:Cursor 可能沿用之前某个 VPN 留下的 DNS 设置。切换过代理工具或 VPN 之后出现解析异常,先完全重启 Cursor。DNS 方面的基础知识见 DNS 设置。

Cursor 模型不可用、列表里缺模型怎么查

这是 Cursor 用户问得最多的问题。官方的地区说明页是这样解释的:

  • Cursor 的部分模型提供方有基于地理位置的限制。
  • 在受限地区,这些模型不会出现在 Cursor 里,而不是显示为报错。其他模型仍然可以用。
  • 官方给的替代办法是使用 Auto,由 Cursor 为每次请求挑选可用的模型;或者手动选择仍然可用的模型;或者在支持的情况下填入自己的 API 密钥。
  • 即使用了自己的密钥,如果提供方封锁了你所在的地区,请求仍然可能失败。

对应到排查步骤:

  1. 确认出口地区。 在浏览器里查一下当前出口 IP 的国家或地区。香港节点最容易出现模型缺失,因为几家主要的模型提供方都没有把香港列入支持地区。
  2. 确认 Cursor 走的是这个出口。 浏览器查到的地区不代表 Cursor 应用也是。到代理客户端的连接页面,找到 Cursor 进程的连接,看它走了哪个节点。没开 TUN、系统代理又没生效时,Cursor 其实是直连的。
  3. 换到支持地区并重启。 把 Cursor 相关流量固定到美国、日本、新加坡等地区的节点,完全退出再打开,让模型列表重新获取。
  4. 区分地区问题和套餐问题。 有些模型只对付费套餐开放,或者有单独的用量限制。模型显示为灰色或带有升级提示,是套餐问题,换节点没用。
  5. 区分地区问题和服务故障。 所有人同时用不了某个模型时,是提供方或 Cursor 的故障,等待即可。

各模型提供方自己的支持地区,分别见 Claude 使用教程、ChatGPT 使用教程 和 Gemini 使用教程 里的说明。

节点地区怎么判断合不合适

Cursor 的地区问题不会弹出报错,只会悄悄少几个模型,所以换节点之后要主动验证。按下面的步骤做一次:

  1. 确认 Cursor 的出口。 在代理客户端的连接页面找到 Cursor 进程的连接,看它走的是哪个节点,再用查 IP 的网站确认这个节点的落地地区。
  2. 完全退出再打开。 模型列表在启动时获取,只关窗口不会刷新。
  3. 看模型列表。 你想用的那几个模型是否出现。缺了的话,先对照上一节区分是地区问题还是套餐问题。
  4. 运行一次诊断。 在 Network 页点 Run Diagnostics,每一项都应当通过。
  5. 跑一次对话和一次 Agent 任务。 对话看首字出现快不快,Agent 任务看能不能连续执行完不中断。
  6. 晚高峰复测。 晚上也稳定,才固定下来。
验证结果 判断 处理
连接页面显示 Cursor 走的是直连 系统代理没对 Cursor 生效 开 TUN 后重新验证
落地在香港,模型缺失 地区受提供方限制 换美国、日本、新加坡等地区
模型齐全,诊断有一项失败 某个域名没走代理 对照下文补规则
对话正常,Agent 任务常中断 节点不稳或出口在变 固定节点,换线路对比
各项都正常,晚上也稳定 合适 固定使用,同地区备一个

Cursor 用什么节点:地区、固定与分流规则

地区。 选主要模型提供方都支持的地区,机场里常见的是美国、日本、新加坡、台湾。香港节点延迟低但不适合,背景见 香港节点适合做什么。

固定节点。 Cursor 的对话和 Agent 任务是长时间的流式连接,出口中途变化会让当前请求中断。策略组用手动选择,不要用自动测速。

IP 类型。 共享的机房 IP 更容易遇到限流。标注原生 IP 或家宽 IP 的节点一般更稳,但倍率更高,这些都是机场的官方标注,本站未验证。概念见 机房 IP 与 AI 风控。

延迟。 代码补全对延迟敏感,对话则更看重稳定。两者不能兼得时优先稳定,延迟和丢包怎么看见 延迟、丢包与速度。

官方网络文档列出的域名集中在下面几个后缀。订阅没有专门策略组的话,可以加几条规则指向一个手动选择的组,节点名换成订阅里真实存在的名称:

proxy-groups:
  - name: AI
    type: select
    proxies: [美国节点甲, 日本节点乙]
rules:
  - DOMAIN-SUFFIX,cursor.sh,AI
  - DOMAIN-SUFFIX,cursor.com,AI
  - DOMAIN-SUFFIX,cursorapi.com,AI
  - DOMAIN-SUFFIX,cursor-cdn.com,AI

规则通过客户端的规则编辑或扩展配置功能叠加,不要直接改订阅文件,入口见 Clash Verge Rev 使用教程。

Cursor 怎么用:补全、对话与 Agent 的基本操作

网络和登录都没问题之后,Cursor 的日常用法可以分成四块。快捷键在设置的键盘快捷方式里能查到和修改,下面写的是常见默认值,不同版本和系统略有差异:

  • Tab 补全。 正常写代码,Cursor 会预测接下来的修改,灰色提示出现时按 Tab 接受。它不只补全当前行,还会建议附近相关位置的改动。
  • 行内编辑。 选中一段代码,按 Ctrl+K(macOS 上是 Cmd+K),用一句话说明要怎么改,确认预览后写入。
  • 侧边对话。 按 Ctrl+L(macOS 上是 Cmd+L)打开对话面板,可以引用文件、文件夹或选中的代码提问。
  • Agent 模式。 在对话面板里切换到 Agent,它会自己搜索项目、修改多个文件、运行终端命令。每一步改了什么都会列出来,可以逐个接受或撤销。

几条上手建议:给项目写一份规则文件,说明技术栈、代码风格和禁止改动的目录,Cursor 会在每次对话时参考;Agent 跑命令前先看清楚命令内容;重要项目先提交一次再让它大改。

Cursor 怎么设置中文:界面语言与回答语言

这是两件不同的事:

  1. 界面显示中文。 Cursor 沿用 VS Code 的语言机制。打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),搜索 Configure Display Language,选择中文;列表里没有中文时,到扩展市场安装中文(简体)语言包,再重新选择并重启。扩展市场打不开,是市场域名没走代理,先按上文把网络配好。
  2. 让 AI 用中文回答。 在 Cursor 设置的规则(Rules)里写一句「始终使用简体中文回答」,之后的对话会默认用中文。设置项的名称和位置不同版本略有差异,在设置里搜索 rules 即可找到。

界面语言和回答语言互不影响,只想要中文回答的话,界面保持英文也可以。

常见报错与处理

现象 多半的原因 处理
登录后应用一直等待 应用没有走代理 开 TUN,完全重启 Cursor
模型列表缺少某些模型 出口地区受模型提供方限制 换到支持地区的节点并重启,或先用 Auto
对话长时间停在生成中 HTTP/2 流被中间环节干扰,或节点不稳 Network 页改 HTTP/1.1;换节点
回答输出到一半断开 出口 IP 变化或节点抖动 固定节点,不用自动切换的策略组
补全很慢或时有时无 节点延迟高、丢包 换物理距离更近的支持地区节点
诊断里个别项目失败 对应域名没有走代理,或被规则分到了直连 对照域名补规则,或临时切全局验证
扩展市场打不开,扩展装不上 市场域名没有走代理 切全局验证后补规则,或开 TUN
内置终端里 git、npm 超时 终端命令不读系统代理 开 TUN,或设置代理环境变量
时好时坏,诊断个别项目失败 设置里残留了旧的代理地址或端口 搜索 proxy,改成当前客户端的端口或清空
Linux 上双击 AppImage 没有反应 文件没有执行权限 赋予执行权限后再运行
提示用量已达上限 套餐额度问题 与网络无关,按官方页面处理

晚上明显更卡,是线路高峰期的问题而不是 Cursor 的问题,见 晚上卡怎么办。

账号安全与代码隐私

  • 只用官方安装包和官方登录流程。 重置试用、修改机器码一类的工具,不在讨论范围内,也不建议使用。
  • 不共享账号。 多人多地共用一个账号,除了风控风险,你的对话记录和代码片段也对其他使用者可见。
  • 了解隐私设置。 Cursor 的设置里有与数据使用相关的选项,处理公司代码之前,先按官方文档弄清每个选项的含义,并确认公司是否允许使用这类工具。
  • 密钥别进仓库。 自带的 API 密钥只填在应用设置里,不要写进项目文件。
  • 固定地区使用。 和其他 AI 工具一样,避免同一账号在多个国家之间频繁切换。

和其他 AI 编程工具怎么选:已经在用 VS Code 或 JetBrains、只想加一个补全助手,看 GitHub Copilot 使用教程;习惯在终端里让 AI 完成整个任务,看 Claude Code 使用教程。

不同国家和地区的规定不同,请遵守当地法律和服务条款。整体的配置思路见 AI 工具的网络环境怎么配,选机场的考虑见 AI 用机场怎么选。

Cursor 使用教程:常用快捷键一览

结论:日常用得最多的就是下表这几组,记住它们基本够用。下面是 Windows 和 Linux 的常见默认值,macOS 把 Ctrl 换成 Cmd;不同版本可能调整,以设置里的键盘快捷方式页面为准,也可以在那里改成自己习惯的组合。

操作 常见默认快捷键 用途
接受补全 Tab 接受灰色的补全或修改建议
忽略补全 Esc 不要当前建议
行内编辑 Ctrl+K 对选中的代码用一句话描述修改
打开对话面板 Ctrl+L 侧边对话,选中代码后按会把代码带进对话
命令面板 Ctrl+Shift+P 搜索任何设置和命令,例如切换显示语言
快速打开文件 Ctrl+P 按文件名跳转
打开内置终端 Ctrl+` 在编辑器里运行命令
引用上下文 在对话输入框里输入 @ 引用文件、文件夹、文档等作为上下文

和 VS Code 的快捷键大部分一致,从 VS Code 迁移过来的人主要记住 Ctrl+K 和 Ctrl+L 这两组即可。如果导入的 VS Code 扩展占用了同样的组合,在键盘快捷方式页面搜索冲突的按键,删掉其中一个绑定。

用 Rules 定制 Cursor 的项目规则

结论:规则文件相当于给 Cursor 的长期交代,写一次,之后每次对话和 Agent 任务都会参考,能明显减少「改了不该改的地方」「风格对不上」这类返工。

规则分两级。用户级规则写在 Cursor 的设置里,对所有项目生效,适合写回答语言、回答风格这类个人偏好。项目级规则放在项目目录里,官方文档给出的位置是项目根目录下的 .cursor/rules 文件夹,可以按用途拆成多个文件,并设置在什么情况下生效;文件格式和字段以官方 Rules 文档为准。

规则内容 写成什么样
技术栈 「前端用某框架,状态管理用某库,不要引入新的 UI 组件库」
目录约定 「接口代码放在某目录,自动生成的目录不要修改」
风格 「函数名用英文驼峰,注释用中文,每个函数写简短说明」
验证方式 「改完运行某条测试命令,测试不通过不要结束任务」
环境说明 「本机网络由 TUN 接管,命令里不要另加代理参数」

项目级规则会跟着仓库提交,团队成员共享同一套约定。不要在规则里写密钥、内网地址或客户信息。

Cursor 接入 MCP 时的网络与安全问题

结论:MCP 让 Cursor 的 Agent 调用外部工具,例如读数据库、查文档、操作浏览器;接入之后多了一批需要联网的进程,网络和权限都要单独检查。

MCP 服务器的配置写在 Cursor 的配置文件里,可以是项目级,也可以是全局,具体文件位置和字段以官方 MCP 文档为准。和网络有关的有三点:

  1. 本地启动的 MCP 服务器是命令行进程。 它们通常通过 npx、uvx 一类命令启动,首次运行要下载依赖,这些命令不读系统代理。表现为 MCP 一直显示未连接,原因是依赖没下载下来。开 TUN 最省事,或者在配置里给它设置代理环境变量。
  2. 远程 MCP 服务器要能直接访问。 它们的域名也要放进分流规则,走哪个策略组取决于服务在哪里,不一定要放进 AI 组。
  3. 只装你信任的 MCP 服务器。 它们能以你的身份读写文件、访问账号,来源不明的服务器等于把权限交给陌生人。需要填密钥的,用环境变量提供,不要写进会提交的配置文件。

Cursor 新手常踩的坑

结论:多数问题不是 Cursor 本身的问题,而是网络、套餐和使用习惯三类原因混在一起。下面按出现频率列出:

坑 表现 怎么避免
用自动测速组 对话和 Agent 任务时不时中断 AI 流量放进手动选择的策略组,固定节点
把缺模型当成网络故障 换了很多机场仍然缺模型 先看出口地区是否受提供方限制,再看套餐是否包含该模型
让 Agent 直接大改 一次改了几十个文件,难以回退 先提交一次,大任务拆成几步
不写规则 风格对不上,反复返工 先写项目规则,见上一节
用破解版或重置试用工具 账号被封、代码经过别人改过的程序 只用官网安装包
内置终端不通 模型正常,安装依赖失败 开 TUN,或给终端设代理环境变量

常见问题

Cursor 在哪里下载?

只从官网的下载页 cursor.com/download 下载,按系统和处理器架构选择安装包。不要用第三方下载站和破解版。

Cursor 模型列表里没有 Claude 或 GPT,怎么回事?

官方说明部分模型提供方有地区限制,受限地区里这些模型不会显示。确认 Cursor 的出口 IP 在支持地区,换节点后完全重启应用。暂时解决不了时可以先用 Auto。

Cursor 需要开 TUN 模式吗?

只用编辑器内的对话和补全时,系统代理通常够用。登录卡住、内置终端里的命令连不上,或者时断时续时,打开 TUN 更省事。

Cursor 一直停在生成中,怎么办?

先到 Cursor 设置的 Network 页,把 HTTP 兼容模式改为 HTTP/1.1 并重启,再运行诊断。仍然如此就换一个更稳定的节点,并确认策略组没有在自动切换。

Cursor 免费吗,收费怎么算?

Cursor 有免费档,额度有限;付费套餐提高额度、开放更多模型和功能,部分高级模型按用量另计。各档的价格和额度调整比较频繁,以 Cursor 官网定价页的当前说明为准。订阅只在官网账号后台办理,不要买共享账号。

用香港节点可以用 Cursor 吗?

Cursor 本身能打开,但主要的模型提供方大多不支持香港,模型列表可能会缺。建议把 Cursor 的流量固定到美国、日本、新加坡等地区的节点。

用自己的 API 密钥能绕开地区限制吗?

不能指望。官方说明里写了,提供方封锁了你所在的地区时,即使使用自己的密钥,请求仍可能失败。根本办法还是让出口落在支持地区。

从 VS Code 导入设置后 Cursor 连不上,怎么办?

多半是旧的代理地址被一起导入了。在 Cursor 的设置里搜索 proxy,看填的地址和端口是不是当前代理客户端的;不是就改正或清空,然后完全退出 Cursor 再打开,并在 Network 页运行一次诊断。

Cursor 的 Ctrl+K 和 Ctrl+L 有什么区别?

Ctrl+K 是行内编辑,针对选中的那段代码直接给出修改;Ctrl+L 打开侧边对话,适合提问、讨论方案或引用多个文件。macOS 上对应 Cmd+K 和 Cmd+L,快捷键以设置里的键盘快捷方式为准。

Cursor 的项目规则文件放在哪里?

官方文档给出的位置是项目根目录下的 .cursor/rules 文件夹,个人偏好则写在 Cursor 设置里的用户规则中。文件格式和生效方式以官方 Rules 文档为准。

Cursor 和 VS Code 可以同时装吗?

可以,两者是独立的程序,设置和扩展各存一份。注意 Cursor 首次启动导入 VS Code 设置时,代理地址也会被带过来,导入后检查一遍 proxy 相关设置。