Cursor 使用教程：下载安装、登录与代理设置（2026）
Cursor AI 编辑器从零上手教程：官方下载安装、账号登录与导入 VS Code 配置、AI 对话与 Agent 的基本用法，以及代理设置、HTTP/2 兼容问题与连接失败排查。
Cursor 是基于 VS Code 的 AI 编辑器。从官网下载安装并登录账号后，就能用 AI 对话、补全和 Agent 修改代码。国内使用建议开启代理客户端的 TUN 模式；如果网络正常但 Cursor 报错，在设置中把网络兼容模式切换到 HTTP/1.1。
核心结论
- 从官网下载，支持 Windows、macOS、Linux
- 首次打开可一键导入 VS Code 的扩展和设置
- 推荐开启 TUN 模式，让 Cursor 全部请求走代理
- 网络正常但报错时，把 HTTP/2 切换为 HTTP/1.1
Cursor 是什么
Cursor 是一款内置 AI 的代码编辑器，界面和操作与 VS Code 几乎一样。你可以在编辑器里直接和 AI 对话、让它补全代码，或者用 Agent 模式让它跨文件完成整个任务。
下载与安装
- Windows Cursor 下载 x64 与 ARM64
- macOS Cursor 下载 Apple 芯片、Intel 与通用版
- Linux Cursor 下载 .deb、.rpm、AppImage
- 官方文档 Cursor 文档
命令行 · Cursor CLI（macOS / Linux）
curl https://cursor.com/install -fsS | bash 以上均为 Anysphere 官方渠道。不要从网盘、论坛或搜索广告下载“破解版”“加速版”安装包。 官方支持地区列表。
下载后按系统正常安装。首次打开时，Cursor 会询问是否导入 VS Code 的扩展和设置，老用户建议导入。
登录与基本使用
- 开启代理，打开 Cursor，按提示登录或注册账号；
- 打开你的项目文件夹；
- 用侧边的 AI 面板提问，例如“解释一下这个函数”；
- 需要 AI 修改多个文件时，切换到 Agent 模式描述任务，它会给出修改并让你确认。
代理设置（国内使用关键）
推荐：开启 TUN 模式
Cursor 是桌面应用，部分请求不一定走系统代理。开启代理客户端的 TUN 模式最省事，操作见 Clash Verge 新手使用教程。
HTTP/2 兼容问题
节点与线路
- 节点选美国或日本并固定；
- Agent 长任务对断流敏感，建议使用 IEPL / IPLC 专线，见 IEPL 和 IPLC 有什么区别。
常见问题
AI 回复一直转圈或超时
先检查代理是否开启，再尝试切换 HTTP/1.1；仍然不行就换一个节点。
登录页面打不开
登录需要在浏览器中完成，确认浏览器代理正常，并且节点不是香港。
常见问题
Cursor 连接失败但网络正常怎么办？
多数是 HTTP/2 与代理的兼容问题。在 Cursor 设置里搜索 HTTP，把网络兼容模式切换为 HTTP/1.1，或开启代理客户端的 TUN 模式。
Cursor 需要付费吗？
有免费额度可以试用，付费版提供更多高级模型请求次数，具体以官网为准。
Cursor 能用 VS Code 的插件吗？
可以。Cursor 基于 VS Code，首次打开时可以一键导入 VS Code 的扩展、主题和快捷键。