Cursor 入门教程 - 从零安装到精通，Claude 模型配合实战
Cursor 入门教程从零开始，覆盖安装、5 个关键设置、8 个核心动作（Tab、Cmd-K、Chat、Composer、Agent），并附 Claude Sonnet 4.6 配合实战。
Cursor 入门 是 2024 到 2026 年这一波 AI 编程工具浪潮里出现频率最高的搜索词之一。很多人是在 CSDN、知乎、B 站看到一句”Cursor 比 Copilot 好用十倍”就来了，但装好之后对着空界面发愣——Cursor 怎么用、Cursor 的使用方法到底跟普通 VS Code 差在哪、那些花里胡哨的 Composer / Agent 又是干什么的。这篇按”是什么 → 怎么装 → 怎么用 → 怎么深入”的顺序，把 Cursor 介绍 + Cursor 的用法一次讲透，最后顺手讲一下为什么大多数老用户最终都把默认模型切到 Claude。
Cursor 是什么
Cursor 是一款基于 VS Code 二次开发的 AI 原生编辑器，由 Anysphere 公司出品，2023 年开始爆火，到 2026 年已经是付费 AI 编辑器里用户基数最大的产品。和把 AI 作为”插件”贴在编辑器外面的 GitHub Copilot 不同，Cursor 是把 AI 作为第一公民塞进编辑器内核：
- 补全不是单行而是多行甚至跨文件
- 内联编辑、Chat、多文件 Composer、Agent 全在同一个工作流里
- 上下文管理（@-提及）做得比插件式工具深得多
Cursor 默认接的就是 Anthropic 的 Claude Sonnet 模型——这是 Cursor 用户社区长期投票得出的”最好用编程模型”的事实结论，也是 Cursor 官方在过去两年里反复强调的默认选择。所以学 Cursor，其实就是在学怎么用 Claude 写代码。
Cursor 跟 VS Code 的关系
| 维度 | VS Code | Cursor |
|---|---|---|
| 内核 | 微软 | VS Code Fork |
| 插件生态 | Marketplace | 兼容大部分 VS Code 插件 |
| 主题 / 快捷键 | 自定义 | 直接继承（导入即可） |
| AI 集成 | Copilot 等插件 | 内核级原生集成 |
| 配置文件 | settings.json | 同款 settings.json + Cursor 专属字段 |
| 命令面板 | Cmd-Shift-P / Ctrl-Shift-P | 完全相同 |
可以把 Cursor 理解为”VS Code + 一套 AI 内核”。原本在 VS Code 用得很顺的快捷键、主题、Vim 插件，迁过来基本零成本。
价格档（以官方为准）
| 档位 | 价格区间 | 适合 |
|---|---|---|
| Free / Hobby | 0 | 试用、轻度使用 |
| Pro | 月度个位数到二十几美元 | 个人开发者主力 |
| Business | 数十美元 | 团队 + SSO + 隐私模式强化 |
Free 档可以体验全部核心交互，但快速请求额度很少，连续用半天就会被限流。真要把 Cursor 当主力，至少 Pro 起步。
安装 Cursor
下载入口在 cursor.com，三大平台都有独立安装包。
macOS
- 下载
.dmg包 - 双击挂载，把 Cursor 拖到 Applications
- 第一次启动时如果提示”未签名开发者”，到
系统设置 → 隐私与安全性点”仍要打开” - 把 Dock 图标固定一下
Windows
- 下载
.exe安装包 - 默认安装到
%LOCALAPPDATA%\Programs\Cursor，不需要管理员权限 - 首次启动会创建桌面快捷方式
Linux
- 下载
.AppImage chmod +x Cursor-*.AppImage- 直接运行，或用
AppImageLauncher集成到桌面
Linux 用户也可以走 deb / rpm 仓库，看 cursor.com/downloads 当前提供的格式。
第一次启动：5 个关键设置
Cursor 首次启动会有一个 onboarding 向导，但很多人闭眼点过去之后再回头看会觉得”怎么补全这么差 / 怎么聊天没记忆”。下面 5 个设置一定要先确认：
1. 登录账号
Cursor → Sign In 或左下角头像图标。没账号就在 cursor.com 注册一个。免费档也要登录，不然连基础 AI 都用不了。
2. Codebase Index
Settings → Features → Codebase Indexing。这是 Cursor 把你的整个项目向量化索引、让 AI 能跨文件理解代码的核心机制。第一次进项目会有几分钟的 indexing 过程，这个开关默认开但要确认 indexing 跑完了，状态栏右下角会显示进度。
3. AI 模型选择
Settings → Models。默认勾上的通常是：
claude-sonnet-4-6（推荐主力）gpt-x系列cursor-small（Cursor 自家轻模型，用于补全）
强烈建议把 Default Model 设为 Claude Sonnet 4.6，理由后面会讲。
4. 隐私模式
Settings → General → Privacy Mode。开启后你的代码不会被用于训练。敏感项目必开。Business 档默认强制开启。
5. 快捷键
Cmd-K Cmd-S (Mac) / Ctrl-K Ctrl-S (Windows/Linux) 打开快捷键面板。如果你是 VS Code 老用户，所有原 VS Code 快捷键继续生效。Cursor 自己加了几组重要快捷键，下文专门讲。
Cursor 入门的 8 个核心动作
学 Cursor 不是学 100 个功能，是学 8 个核心交互，剩下都是衍生。
1. Tab 自动补全
按 Tab 接受 Cursor 给你的下一段建议。这是 Cursor 入门遇到的第一个动作，也是最容易低估的一个。
Cursor Tab 跟传统 IDE 自动补全（按字母弹出方法名那种）完全不是一回事：
- 它能多行补全（一次写 20 行业务逻辑）
- 它能跨光标补全（建议把光标跳到下一个该改的位置）
- 它能根据你刚改了什么预测下一步（典型场景：你改了一个字段名，它会预测你下一处也要改）
| 操作 | Mac | Windows/Linux |
|---|---|---|
| 接受补全 | Tab | Tab |
| 拒绝补全 | Esc | Esc |
| 部分接受（按词） | Cmd-→ | Ctrl-→ |
第一次见到 Cursor Tab 自动把光标跳到下一处的人都会愣一下，这就对了。
2. Cmd-K / Ctrl-K 内联编辑
选中一段代码，按 Cmd-K (Mac) / Ctrl-K (Windows/Linux)，在弹出的输入框里用自然语言说要怎么改——比如”把这个函数改成 async”、“加上中文注释”、“提取成单独的 helper”。
Cursor 会在原位生成 diff，按 Enter 接受 / Cmd-Y 接受 / Esc 取消。
也可以不选中直接按 Cmd-K，相当于在当前光标位置生成新代码。这种模式特别适合”先写注释，再 Cmd-K 让它把代码补出来”的工作流。
3. Cmd-L / Ctrl-L 聊天侧栏
Cmd-L (Mac) / Ctrl-L (Windows/Linux) 打开右侧 Chat 面板。这是最像”和 AI 对话”的入口：
- 多轮聊天有记忆
- 可以贴代码片段问解释
- 可以让 AI 给方案但不直接改文件
- 配合 @-提及做精准上下文（下面专门讲）
聊天侧栏底部的模型选择器可以单独切模型，跟全局默认互不影响。
4. Cmd-I / Ctrl-I 调出 Composer
Cmd-I (Mac) / Ctrl-I (Windows/Linux) 打开 Composer。Composer 是 Cursor 的”多文件编辑”模式：
- 你描述需求（“给这个项目加一个用户登录页面，路由、组件、API 全套”）
- Composer 自动跨文件改动
- 每个文件单独显示 diff，可以一个一个 Apply / Reject
Composer 的存在是 Cursor 跟传统 Copilot 类工具最大的代差。做大改动一定走 Composer，不要在单文件里硬撸 Cmd-K。
5. @-提及上下文
在 Chat 或 Composer 输入框里打 @，会弹出选择器：
| 类型 | 用法 |
|---|---|
@文件名 | 把指定文件塞进上下文 |
@文件夹 | 整个文件夹的所有文件 |
@Codebase | 全仓向量检索，让 AI 自己选相关文件 |
@Docs | Cursor 内置的官方文档库（React / Next.js / Tailwind 等） |
@Web | 让 AI 上网查 |
@Git | 当前 diff、最近 commit |
@Lint | Lint 错误 |
@-提及是 Cursor 用法的灵魂。同一个问题，加不加 @-提及，答案质量差三个档次。
6. Agent / YOLO 模式
Composer 里有一个 Agent 开关（不同版本叫法可能是 “Auto-Run” 或 “YOLO”）。开启后：
- AI 自己决定要读哪些文件、要不要跑命令
- 跑测试、跑 lint、跑 build 都可以自己来
- 出错了自己再 debug 再改
Agent 模式适合：明确的小型任务、写测试、重构、批量替换。 Agent 模式不适合：你自己都不知道要干啥的探索性任务，会跑飞。
第一次开 Agent 建议关掉自动执行命令（Allow Auto-Run = false），先看它想做什么。
7. Rules 自动注入项目规则
项目根 → .cursor/rules/ 目录下的 .mdc 文件就是 Rules。Cursor 在每次跟你交互时会自动把这些规则塞进系统提示：
.cursor/rules/general.mdc
.cursor/rules/api-style.mdc
.cursor/rules/no-emoji.mdc
每个 .mdc 文件头部可以指定它作用于哪些文件（globs），然后正文写 markdown 描述规则。团队协作必开，比如统一把”不要用 any、注释用中文、API 路径用 kebab-case”写进 Rules，AI 就不会反复跑偏。
8. Codebase Index 全仓搜索
前面说过 indexing 要开。开了之后效果体现在两个地方：
@Codebase提及时检索准- AI 自己在 Composer / Agent 里”找相关代码”的能力强
如果你发现 AI 老说”我看不到你说的那个函数”，第一反应应该是去 Settings 检查 indexing 状态。索引过期的话点 “Resync Index”。
推荐用 Claude Sonnet 4.6 / Opus 4.6 的场景
学完 8 个核心动作后，剩下的真正影响日常体验的，就是选模型。
Cursor 在 2025-2026 这一波模型大战里的默认选择是 Claude。理由很务实：
| 场景 | 推荐模型 |
|---|---|
| 日常 Tab 补全 | cursor-small（够快，免费） |
| Chat 解释代码 | Claude Sonnet 4.6 |
| Cmd-K 修改单段代码 | Claude Sonnet 4.6 |
| Composer 跨文件改动 | Claude Sonnet 4.6 |
| Agent 长任务 / 重构 | Claude Opus 4.6 |
| 偶尔的”我就想看不同视角” | GPT 系列 / Gemini |
Claude Sonnet 4.6 在 Cursor 内部的体感优势：
- 改代码时不会乱删周边代码
- 拒绝幻觉式 API（不会编造不存在的库方法）
- 长上下文里仍然能精准定位
- 中文注释和提示词的理解比 GPT 好
Opus 4.6 适合一次性吃掉整个模块重构这种任务。模型本身慢、贵，但稳定性是另一个档次。详细模型对比可以看 Claude Opus 4.6 深度解析。
如果你已经在用 Claude Code，可以参考 Claude Code 模型选择策略 把同一套思路搬过来——两边的选择逻辑几乎一致。
Cursor 入门之后该学什么
按”装好 → 跑通 → 精通”的路径，Cursor 怎么用这件事其实可以分成三个阶段：
阶段一（第一周）：把 8 个核心动作的快捷键肌肉记忆建立起来。Tab、Cmd-K、Cmd-L、Cmd-I 四个键不查文档能直接按出来就算合格。
阶段二（第二到第四周）：把 @-提及、Rules、Codebase Index 的进阶玩法跑顺。这个阶段你会发现 AI 给的答案质量明显提升。
阶段三（一个月以后）：开始用 Composer Agent 做规模化任务，开始关心模型选择和成本，开始有自己的 Rules 模板。
每个阶段对应的延伸阅读：
- 想详细配 Claude → Cursor 配置 Claude 完整指南
- 想深入 Cursor 各交互细节 → Cursor 使用方法完整教程
- 国内访问 Cursor + Claude 的网络 / 支付 → Cursor 国内使用 Claude 完整教程
- Cursor / Claude Code / Claude 三者关系 → Claude Code vs Claude vs Cursor
- 想顺手用 Claude Code 在 Cursor 终端里 → Claude Code 国内安装
- 想知道 Claude Code 到底是什么 → Claude Code 是什么
Cursor 入门 FAQ
Cursor 跟 Copilot 谁更值得装
如果你已经付了 Copilot，Cursor 仍然值得试一个月——补全质量和多文件 Composer 是 Copilot 完全没法对位的。两个工具不冲突，可以同时装在一台机器上。
Cursor 必须订阅吗
Free 档可以跑通所有交互，但请求额度小。如果你一周用 Cursor 超过 10 小时，Pro 基本是回本的。
装了 Cursor 还要装 VS Code 吗
不用。Cursor 把 VS Code 完整 fork 了过来，你能在 VS Code 做的事在 Cursor 都能做。除非你的工作流强依赖 VS Code 的远程开发某些扩展。
Cursor 默认模型是 Claude 吗
是。当前版本 Default Model 默认就是 Claude Sonnet 系列。这是 Cursor 多年用户数据投票的结果。可以在 Settings → Models → Default Model 改成别的，但老用户改回来的概率比第一次改出去的概率高。
Cursor 怎么使用 Claude Opus
Settings → Models 里把 Opus 开关打开，然后在 Chat 或 Composer 底部模型选择器手动切到 Opus。Pro 订阅对 Opus 有单独的快速请求额度，注意看用量。
我看 CSDN 上有人说 Cursor 不好用
CSDN 上的 Cursor 教程时间跨度从 2023 到现在都有，早期的文章很多功能名字、UI 路径已经过时。看教程时务必看发布日期，2025 年之前的 Cursor 文章里”Cmd-K 是怎么用的”那一段，UI 和现在差异巨大。本文写于 2026 年 5 月，所有快捷键和路径以当前版本为准。
Cursor 在国内怎么用
参考 Cursor 国内使用 Claude 完整教程。简要回答：账号、支付、网络三件事各自找方案。