0820 我用 Claude Code 把 13 个 endpoint 改造成 YAML 配置——但写完第二天，团队里三个同事把 VS Code 卸了换 Cursor。

原因：Claude Code 适合"AI 主动找事做"，Cursor 适合"AI 帮你写但你主导"。工程师一天 90% 时间在写代码（不是发 issue），所以 Cursor 命中率更高。

这一篇把一周实测的 6 个真实踩坑 + 4 个进阶用法贴出来。核心反常识：网上 90% Cursor 教程还在讲 .cursorrules（2024 旧格式），2026 真正可用的规则文件是 .cursor/rules/*.mdc + YAML frontmatter。

---

二、为什么是 Cursor 而不是 Claude Code

0820① 我用 Claude Code 给 HKOpenDataClientAsync 加了 YAML 配置——4 分钟搞定，零错误。但团队不愿意全员用：

场景	Claude Code	Cursor
改一行的 bug	需要切到终端	Cmd+K 内联修改 5 秒
看旧代码逻辑	复制粘贴到终端	Cmd+L 全文上下文提问
写新功能	Composer 1 一次性生成	同样支持，但 Composer 跑完还要肉眼 review
写测试	跑 claude -p "..."	Tab 自动补全到下一行

（上图：Cursor 在 90% 工程师日常场景胜出（改 bug / 看代码 / 写新功能）；Claude Code 在批处理场景胜出（批量重构 / 跨文件改））

结论：Claude Code 适合"AI 主动找事做"（重构、批量改），Cursor 适合"工程师主导 + AI 加速"（90% 时间在写新代码）。

---

三、5 个 2026 Cursor 必开设置

// settings.json（Cmd+, 打开图形界面，下面是 JSON 编辑模式）
{
  "cursor.aiModel": "claude-4.5-sonnet",        // 复杂任务选这个
  "cursor.tabAutocomplete": true,                // Tab 自动补全（CURSOR 灵魂）
  "cursor.contextWindow": 200000,                // 拉到 200K 让它看见整个项目
  "cursor.enableNaturalLanguageSearch": true,    // 用自然语言搜代码
  "cursor.tabMultiLineCompletions": true         // 多行补全（不是单行）
}

收藏提示①：5 个设置里 tabAutocomplete 是 Cursor 的灵魂。Copilot 是一次补一行，Cursor 是 next edit prediction——预测"你接下来要改哪里"，不是"接下来要写什么"。

---

四、.cursor/rules/*.mdc 才是 2026 必备

90% 教程还在教 .cursorrules（项目根一个文件）。2026 新格式是结构化规则——支持按文件类型生效、可以版本控制、能和团队共享。

# .cursor/rules/python.mdc
---
description: Python 项目规范
globs: ["**/*.py", "**/*.ipynb"]
alwaysApply: false
---
# Python 代码规则
- 优先用 type hints（def func(x: int) -> str:）
- 第三方库显式 import（不要 import *）
- 错误处理用 logger.exception() 而非 print
- 函数超过 50 行必须拆

# .cursor/rules/security.mdc
---
description: 安全审计规则
globs: ["**/api/**", "**/auth/**"]
alwaysApply: true
---
# 安全规则
- 数据库查询必须参数化（禁止 f-string 拼接）
- 用户输入必须经过 Pydantic 校验
- 密码字段用 SecretStr 类型
- 任何 md5/sha1 提示要重新评估

globs 决定规则作用文件范围——security.mdc 只对 api/ 和 auth/ 生效，不污染其他文件。

收藏提示②：.cursorrules（旧）和 .cursor/rules/*.mdc（新）现在都支持。但新格式能按文件类型生效——这是 2026 必用升级。

---

五、4 个 Composer 进阶用法

5.1 真实任务：迁移 dataclass → Pydantic

@Composer (Cmd+I)
把 src/models/ 下所有用 @dataclass 的类迁移到 Pydantic BaseModel：
- 保留字段名和类型
- Optional[X] → X | None = None
- 用 ConfigDict 替代 @dataclass(frozen=True)
- 任何非类型字段要标记为 Pydantic Field

Composer 1.2 跑了 47 秒，改了 8 个文件 23 处——其中 21 处正确，1 处漏了类型导入，1 处误把 Optional[list] 改成了 list | None = None（语义对但行为微差）。

5.2 @-mentions 控制上下文

@Codebase @api/users.py 把这个端点的鉴权从 session 改成 JWT

@Codebase 让 Cursor 索引整个项目（首次 30 秒，之后秒级）。@file 指定单文件，节省 token。

5.3 Composer vs Agent 模式

模式	适用	实测
Composer	已知 3-5 个文件要改	47 秒搞定 8 文件
Agent	新功能、范围未知	"构建用户注册页"跑 4 分钟自动决定文件结构
Background Agent	GitHub Issue → PR 草稿	后台跑，醒来已有 PR

0822 这一篇我自己用的就是 Composer——“把这一篇 markdown 改成 Claude 风格” 跑完 28 秒。

5.4 Background Agent：关电脑也能写代码

# GitHub Issue 写完后加标签 "cursor"
# Cursor 自动开云端沙箱 → 分析代码 → 提 PR
# 醒来看 GitHub 通知，diff 已经准备好

（上图：Tab 自动补全（毫秒级，AI 主导后台）→ Composer（已知范围 47 秒/任务）→ Agent（未知范围自主决策 4 分钟）→ Background Agent（云端 Docker 沙箱，关电脑也能跑）——工程师 90% 时间在编辑器里，剩下 10% 让 AI 后台跑）

收藏提示③：Background Agent 是 2026 Cursor 才有的功能。免费版不能用，Pro $20/月 每月 50 次。慎用——AI 写 50 个文件你 review 不过来。

---

六、6 个真实踩坑

坑 1：Composer 改了 30 个文件你只想要 5 个

Composer 1.x 默认"能动就动"——经常改一堆无关文件。在 Composer 里点 diff 逐个取消勾选，别一键 Accept All。

坑 2：Tab 补全建议错得离谱

Tab 补全是"你接下来要改什么"的预测，不是补全。如果光标位置不对，建议会完全错。正确做法：先移动光标到目标位置，再按 Tab。

坑 3：Composer 改完老代码不写测试

Composer 主动改实现但不会主动加测试。我在 prompt 里加 “顺手加 3 个 pytest 单元测试” 才能保证 70% 任务有测试。

坑 4：.cursorrules 文件不生效

最常见原因：文件编码不是 UTF-8，或者位置不对（必须在项目根）。Cursor 启动日志会显示是否成功加载——Cmd+Shift+P 搜 “Show Cursor Logs”。

坑 5：免费版 50 slow 请求 1 周用完

我第一周 3 天用完 50。pro 版 $20/月有 500 fast——fast 是 Claude 4.5 Sonnet，slow 是降级模型。密集开发日 1 天能用 100+。

坑 6：Composer 改完不跑测试

Composer 经常"改得动但跑不通"。必须在 Composer 完成后手动跑测试——Cmd+Shift+P → “Run Test Suite”。

收藏提示④：6 个坑的本质——AI 写的代码"看起来对"不等于"运行对"。review diff 永远比 Accept All 重要。

---

七、模型选择：什么时候用哪个

任务	模型	理由
复杂架构决策	Claude 4.5 Sonnet	推理最好
UI 改文案 / 简单 bug	GPT-5 mini	便宜 + 够用
大量重复代码	Composer-1	Cursor 自研，2x 速度
敏感代码（医疗/金融）	Claude Opus 4.5	隐私 + 严守规则
离线需求	Ollama + Llama 4	数据不出本机

Cursor 支持的模型每月都在加——Cmd+Shift+P 搜 “Switch Model” 随时切换。

---

八、写在最后

0820 我用 Claude Code 重构 13 个 endpoint，0821 三模型对比 asyncio，0822 第1篇 logging 解决了"线上排查慢"，0822 第2篇 Cursor 解决"工程师怎么让 AI 写 40% 代码还不出错"。

工具	核心场景	适合谁
Claude Code	AI 主动重构	写库 / 框架
Cursor	工程师主导	业务代码 90% 时间
GitHub Copilot	单行补全	VS Code 重度用户
Aider	原子 Git 提交	命令行极客

个人结论：2026 做业务代码，Cursor 是 ROI 最高的 AI 编程工具。一个月 $20，换每天 1-2 小时。

收藏提示⑤：把 .cursor/rules/python.mdc 拷到你项目根，明天就生效。AI 立刻学会你团队的代码规范——这是比任何 prompt 调优都更值的事。

---

环境信息

项	版本
Cursor	1.4.2 (Pro)
主模型	Claude 4.5 Sonnet
备用	GPT-5 mini / Composer-1 / Claude Opus 4.5
平台	macOS 15 / Windows 11 / Linux Ubuntu 22.04
离线模型	Ollama + Llama 4 70B
价格	Free $0 / Pro $20/月 / Pro+ $60/月 / Ultra $200/月
笔记	个人选择，不代表官方建议；价格以 cursor.com 为准