Cursor 是基于 VS Code 的 AI 编程工具，内置 Agent 可以读取代码库、执行终端命令、自主完成编码任务。本文是官方 Quickstart 的中文改写版：安装 Cursor 并登录、用 Agent 理解陌生代码库、让 AI 建议小改动并生成 diff、用 Plan Mode 处理多文件复杂任务——帮你快速完成从零到第一次真实代码改动。

Cursor 快速入门：从安装到第一次改代码

Cursor 是一款基于 VS Code 的 AI 编程工具，内置的 Agent 能读取你的整个项目、运行终端命令、多文件协同编辑，完成真正的端到端编码任务。本指南帮你在 10 分钟内完成安装并跑通第一次 AI 辅助改动。

---

第一步：安装 Cursor

macOS

访问 cursor.com/downloads 下载 .dmg 文件，双击安装。支持 Apple Silicon（M 系列）和 Intel。

系统要求：macOS 12（Monterey）及以上。

Windows

下载 .exe 安装包，双击运行。系统要求：Windows 10 及以上。

国内用户提示：如果下载慢，可以开代理或通过镜像站下载。Cursor 本体不需要代理，但 AI 功能（调用 Anthropic/OpenAI API）需要能访问外网。

Linux

Debian/Ubuntu（推荐）

用官方 apt 源安装，支持自动更新：

# 添加 Cursor GPG 密钥
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null

# 添加仓库
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null

# 安装
sudo apt update
sudo apt install cursor

RHEL/Fedora

sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF
sudo dnf install cursor

AppImage（便携版）

从 cursor.com/downloads 下载 .AppImage：

chmod +x Cursor-*.AppImage
./Cursor-*.AppImage

建议优先用 apt/yum，有桌面图标和自动更新。AppImage 适合没有 root 权限的场景。

---

第二步：登录并打开项目

安装完成后启动 Cursor，登录账号（支持 Google/GitHub 一键登录）。

打开你的项目文件夹，就可以开始用 AI 了。

---

第三步：让 Agent 解释你的代码库

打开 Agent 面板（Cmd+I / Ctrl+I），输入：

解释这个代码库的结构。告诉我主要入口点、核心模块，以及在改动之前我应该先读哪些文件。

Cursor 会搜索你的仓库，读取关键文件，汇总整个项目的结构。这是快速理解陌生代码库最有效的方式之一。

---

第四步：让 Agent 做一个小改动

理解项目后，先让 Cursor 推荐几个安全的改进点：

给这个代码库建议三个小的、安全的改进方案，说明各自的权衡，等我选一个。

选定后，Agent 会自动生成代码变更。左侧会出现 diff 视图显示具体改了什么。

改动完成后，让 Agent 运行你的项目已有的检查工具：

运行项目的测试/类型检查/lint，看看改动有没有问题

---

第五步：复杂任务用 Plan Mode

对于跨多个文件的复杂需求，不要直接让 Agent 动手——先用 Plan Mode 生成计划：

1. 在 Agent 输入框按 Shift+Tab 切换到 Plan Mode
2. Agent 会先搜索代码库、问清楚你的需求，生成详细实施方案
3. 你可以在聊天里编辑这个方案
4. 确认后才开始写代码

和 Claude Code 的 Plan Mode 类似：都是"先规划，后执行"——帮你在 AI 开始大规模改代码之前先确认方向。

---

接下来

• Cursor Agent 功能详解 — 了解 Agent 的全部工具和能力
• .cursorrules 配置指南 — 给项目添加持久指令
• Plan Mode 深度使用 — 复杂功能的完整开发流程

---

常见问题

Q: Cursor 和 VS Code 有什么关系？

Cursor 是基于 VS Code 的 fork，界面和快捷键基本相同，VS Code 的大部分扩展都可以直接安装使用。区别在于 Cursor 深度集成了 AI Agent，能完成多文件自主编辑任务，而不只是代码补全。

Q: Cursor 国内能正常用吗？

安装和打开项目不需要代理。但 AI 功能需要调用境外 API（Anthropic 或 OpenAI），国内需要代理或使用支持的国内云服务。详见 国内使用配置。

Q: Cursor 免费用吗？

有免费套餐，提供有限次 Agent 使用。付费计划（Pro/Business）提供更多请求量和高级模型。详见 Cursor 定价。