AI 编辑器 Cursor 的第一个小时：模型选择、四个核心快捷键、项目规则，以及如何与 Claude Code 结合使用。

Cursor 是深度集成 AI 的 VS Code 分支 — 目前通往「在编辑器中将 AI 融入日常工具」最快的路径。它与 Claude Code 有重叠但互为补充：Cursor 是编辑器内的结对程序员，Claude Code 是终端侧的代理。重点不在于二选一，而在于在两者之间合理分工。

我觉得 .cursorrules 是被低估的杠杆点。以前每次对话都要重述上下文；如今通过规则文件，那些重复的上下文变成了系统的一部分，因为规则文件就是你与 Cursor 的持久共识。

本指南与操作系统无关（macOS/Linux/Windows）：安装 → 核心使用 → .cursorrules → MCP → 与 Claude Code 分工。

TL;DR

安装：cursor.com → 自动导入 VS Code 扩展/快捷键/设置
模型：Claude Sonnet/Opus · GPT-4.1 · Cursor Composer。默认推荐：Claude Sonnet
四个快捷键：Tab 自动补全 · ⌘K 内联编辑 · ⌘L 侧边聊天 · ⌘I Composer
.cursorrules：项目规则文件，每次调用时作为 system prompt 注入
与 Claude Code 分工：Cursor = 编辑 + 即时反馈；Claude Code = 多文件 + 自主执行 + CLI

前提条件

macOS 12+ / Windows 10+ / Linux（Ubuntu 22.04+）
网络 + 账户（Cursor 或 GitHub OAuth）
VS Code 用户：导入是自动的

1. 安装

macOS

brew install --cask cursor

Windows

winget install -e --id Anysphere.Cursor

Linux

前往 cursor.com/downloads 获取 AppImage 或 .deb。

首次运行时，Cursor 会一键导入 VS Code 扩展、快捷键和主题。新用户直接接受默认值即可。

2. 选择模型

Cursor → Settings → Models。推荐：

Claude Sonnet 4 — 日常编辑和重构。速度快。
Claude Opus 4 — 困难调试和架构设计。较慢/较贵，更准确。
Composer（Cursor 自有） — 多文件、代理式。测试阶段。
GPT-4.1 / o1 — 用于备选 / 对比。

Cursor Pro 对每个模型有请求配额。Sonnet 配额充裕且响应快 — 设为默认；遇到复杂问题时再切换 Opus。

3. 四个必学快捷键

快捷键	工具	时机
`Tab`	自动补全	每一行 — 只在置信度高时接受
`⌘K`（Mac）/ `Ctrl+K`	内联编辑	对选区直接下指令（「重构这段」）
`⌘L` / `Ctrl+L`	侧边聊天	带自动附加上下文询问代码
`⌘I` / `Ctrl+I`	Composer	多文件变更（大任务）

Tab 自动补全

填充签名、重复模式、自动导入
不要盲目接受 — 幻觉 API 调用很常见。随时按 Esc 拒绝。
设置：Features → Cursor Tab → 「Disable preview」可减少干扰。

⌘K 内联编辑

// 选区：整个函数
// ⌘K："add error handling and zod input validation"

只修改选区。不适合大任务。是最快的「意图 → 结果」循环。

⌘L 侧边聊天

@filename 附加特定文件
@Codebase 在整个 repo 中搜索（基于嵌入，测试质量）
@Web 获取最新信息（Cursor 执行搜索）

⌘I Composer

多文件工作（如「重构整个认证流程」）。代理模式下直接编辑文件。不要一次性接受全部结果 — 逐个审查 diff。

4. `.cursorrules` — 项目规则

repo 根目录的 .cursorrules 文件会作为 system prompt 自动注入到每次聊天、编辑或 Composer 调用中。将代码风格、技术栈和禁止事项写入一次，此后无需每次重复输入。

4.1 模板

适用于 Next.js + TypeScript 项目：

.cursorrules

# Mac/Linux
curl -fsSL https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -o .cursorrules
shasum -a 256 .cursorrules
# 期望值：7f1ef76397375cae008ece09b46ddf91aa098dff5edaacebcd7e7e4dec92a21d

# Windows
Invoke-WebRequest -Uri https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -OutFile .cursorrules

4.2 模板中的关键部分

项目上下文 — 技术栈 · 包管理器 · 语言版本
代码风格 — strict TS · 文件名约定 · 路径别名
路由/数据 — App Router 模式 · ISR · 环境隔离
安全 — 无密钥 · 输入验证 · SQL 绑定
范围 — 不重构请求范围之外的内容
输出格式 — diff 风格 · 附带权衡的一个替代方案

4.3 效果对比

有无 .cursorrules 的差异：

无规则：「给我做一个 React 组件」→ 类组件、JS、随机额外依赖有规则：「给我做一个 React 组件」→ strict TS Server Component、@/* 路径别名、Tailwind

一份质量好的规则文件，可以省去每个 prompt 中 3–4 行的上下文设置。

5. `.cursorignore`

语法同 .gitignore。标记 AI 不应拉入上下文的文件。

# 依赖 / 构建产物
node_modules
.next
dist

# 大型 fixtures
fixtures/large/

# 生成代码
src/generated/

跳过此步会导致 @Codebase 搜索将构建产物拉入结果 — 输出质量下降。

6. MCP（Model Context Protocol）

Cursor 0.42+ 支持 MCP。与 Claude Code 采用相同标准，MCP server 配置可在两者之间复用。

Settings → Features → MCP → Add Server：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

7. 隐私模式

Settings → General → Privacy Mode：

关闭（默认） — Cursor 可能使用日志/请求用于模型改进
开启 — 不用于训练。公司代码必须开启。

隐私模式开启后，部分功能（如代码库索引）仅在本地运行，性能影响较小。

8. 与 Claude Code 分工

最优配置：两者同时使用，明确分工：

领域	Cursor（编辑器内）	Claude Code（终端）
上下文	当前文件 + 选区	自由漫游整个目录
延迟	亚秒级（内联）	秒级到十秒级（代理式）
多文件	Composer（测试版）	标准功能
CLI 任务（构建/测试）	单独终端	集成
自主度	有限	强
Git/PR 自动化	不支持	通过 `gh` 支持
费用	Pro 固定费	按 token 计费

实践模式

1. 小改动 → Cursor ⌘K — 改动在单个函数内完成，立即接受。

2. 多文件 → Claude Code — 如「为四个路由添加 ISR」，从 CLI 执行变更和构建验证。

3. 调试 → 两者结合 — Cursor 用于快速假设验证；Claude Code 用于需要更深上下文和自主执行的场景。

4. 创建 PR → Claude Code — 通过 gh pr create 自动化完成。

5. 代码审查 → Cursor ⌘L — 内联阅读 diff 并逐行提问。

验证

在空的 index.tsx 上打开 Cursor，让 Tab 提议一个 React 组件骨架
选择一个函数 → ⌘K「add error handling」→ 看到 try/catch 被添加
⌘L 侧边聊天附加 @package.json → 询问依赖问题
在 repo 根目录放置 .cursorrules → 新建聊天 → 行为随规则改变
Settings → Privacy → 开启 → 确认正常运行

故障排查

Tab 自动补全过于嘈杂

Settings → Features → Cursor Tab → "Trigger more accurately"，或临时禁用。如果经常拒绝，直接关掉。

`@Codebase` 结果偏差

将构建产物和生成代码加入 .cursorignore。触发 codebase 重新索引（Settings → Indexing）。

Cursor 自有模型经常幻觉

将 Claude Sonnet 设为默认。Settings → Models → Default Model = Claude Sonnet。

`.cursorrules` 似乎被忽略

文件名精确：.cursorrules，有前导点，无扩展名
必须在 repo 根目录（不是子文件夹）
在新聊天中验证（现有聊天累积了上下文可能掩盖变化）

Pro 配额消耗过快

过度使用 Composer。小改动用 ⌘K；真正的多文件工作才用 Composer。

与 Claude Code 的快捷键冲突

Cursor 在 IDE 中，Claude Code 在终端里 — 物理冲突很少见，但两者在某些设置下都用 ⌘L。重映射其中一方。

参考资料

Claude Code 配置 — 终端代理配置，与 Cursor 配合良好
多代理工作流 — 多工具结合
Cursor 文档
Cursor MCP 指南

更新日志

2026-05-12 — 初始英文翻译（devAlice M2 i18n 种子）

Cursor 配置 — 安装、.cursorrules、MCP 以及如何与 Claude Code 分工