
Cursor Projects 怎么用?协调者 Agent 教程
打开 Cursor 左侧导航,就能找到新上线的 Projects 入口。Cursor 在 2026 年 9 月 10 日发布 Projects 功能,目前以 beta 形式向所有用户逐步推送:你把一项大任务交给项目里的协调者 Agent(coordinator),它负责规划工作、调度子 Agent 并行实现,最后把成果收回来给你检查。本文按实际操作顺序讲清楚怎么用起来,文末附常见卡点速查表。

前置准备:账号、档位、环境三件事
动手前先把这三样确认掉,否则很容易卡在入口那一步:
- 客户端更新到最新版本。Projects 是 2026-09-10 上线的新功能,旧版本里根本没有这个入口。
- 订阅档位至少 Pro。Projects 由 Cloud Agents 驱动,而按官方定价页的权益划分,Cloud agents 是从 Pro($20/月)开始才有的,免费 Hobby 档的权益列表里没有它。
- 准备好可用的网络与支付方式。Cursor 是海外服务,官方也明确订阅只通过 cursor.com 直销,其他渠道属于未授权。
Projects 入口在哪里
官方 changelog 的原话是「Access Projects from the left-hand nav」,也就是从编辑器左侧导航栏进入。具体操作:
- 把 Cursor 更新到最新版本。
- 在左侧导航栏找到 Projects 入口点击进入。
- 如果暂时看不到入口,属于正常现象:功能正在向所有用户滚动推送,等推送到位即可,不需要额外申请。

创建第一个 Project
进入 Projects 后,新建一个项目并描述你要做的工作。官方给这个功能的定位是承载「更大的工作体」,例如一个完整功能、一次代码迁移,甚至一整个应用。建议第一次使用时这样下任务:
- 选一件平时需要拆成十几个小步骤的活,比如「给现有服务加一个导出功能」。
- 在任务描述里写清楚目标和验收标准,协调者会据此拆解任务。
- 提交后观察它的执行过程,先熟悉它的工作节奏,再逐步放开更大的任务。
一份能直接抄的任务描述骨架长这样:
目标:给订单服务增加 CSV 导出接口,覆盖近 90 天数据
范围:只改 order-service 模块,不改数据库表结构
验收标准:
1. 新增接口通过单元测试,覆盖率不低于现有模块平均线
2. 导出文件字段与产品文档一致,金额保留两位小数
3. 本地跑通一次真实导出,产出文件可被 Excel 正常打开
限制:沿用现有的鉴权中间件,不引入新依赖
关键在「验收标准」这一节:协调者回收子 Agent 的成果时,就是按这段文字向你交付的。这段写得越具体,后面返工越少。
给协调者下任务的三个技巧
协调者 Agent 本身不写代码,它的工作是规划、派活、回收成果。想让它的产出可用,下任务时注意三点:
- 任务给「块」不给「行」:把一个 feature、一次迁移这样的完整单元交给它,太小的任务用普通 Agent 模式反而更快。
- 明确验收标准:写清楚什么算做完,协调者回收子 Agent 成果后要按这个标准向你交付。
- 利用共享上下文:每个 Project 会在多台云端和本地机器之间同步一组文件,Agent 们会把调研结论、产出物和学到的经验(比如某个服务怎么测试)沉淀进去,后续所有 Agent 都能直接用。任务描述里可以提醒它参考已有的上下文。
子 Agent 并行时你应该看什么
协调者会按工作需要创建尽可能多的子 Agent 并行执行。运行过程中值得关注的观察点:
- 看任务的拆解是否合理:拆出来的子任务粒度直接决定产出质量,发现拆偏了及时纠正。
- 看并行进度而不是逐行代码:子 Agent 的实现在云端机器上跑,你在界面里看到的是各条线的进展和汇总。
- 看本机联动的时机:当某件事必须在你自己的机器上测试时,协调者会自动启动一个本地 Agent 来执行,这部分动作会发生在你的电脑上,所以那台机器要保持可用。
因为 Project 运行在云端的独立机器上,合上笔记本任务也不会中断,这是它和普通本地 Agent 模式最大的体验差异。
怎么确认这次跑通了
云端任务不像本地跑命令那样有即时反馈,建议按这三个信号判断是否走通:
- 界面里出现按子任务拆分的执行条目,说明协调者已经完成规划并开始派活。
- 产出以可检查的形式回来(diff、文件、测试结果),而不是只有一句「已完成」。
- 拿验收标准逐条对,能对上的才是真的做完;对不上的直接作为下一轮任务描述发回去。
它和 Cloud Agents 的分工也决定了你该看哪里:官方说明 Projects 由 Cloud Agents 驱动,每个 Project 在云端自己的机器上运行,负责重活的子 Agent 全部跑在云上;需要操作你本地环境时(比如跑测试),由协调者临时拉起本地 Agent 补位。纯代码实现的事放心交给云端,涉及本机环境验证的事它会来找你的电脑。

进阶玩法:订阅信号源自动派活
Projects 支持让协调者订阅外部信号,不需要你手动下指令:可以让它盯着一个 Slack 频道、按时间表定时运行,或者跟进你所有的 PR。官方举的例子是把 Slack 连到一个 bug 反馈频道,之后每来一个 bug 报告,它就自动开始派活处理。这类自动化适合长期维护类的工作,前期把规则写清楚最重要。

费用说明:用的是 Cloud Agents 的额度
官方 changelog 没有单独给 Projects 定价,因为它消耗的是 Cloud Agents 所在的订阅额度。把官方定价页的档位摊开看:
| 档位 | 官方标价 | Agent 额度 |
|---|---|---|
| Hobby | 免费 | 有限请求;权益中未列 Cloud agents |
| Pro | $20/月 | 扩展额度(基准) |
| Pro+ | $60/月 | Pro 的 3 倍 |
| Ultra | $200/月 | Pro 的 20 倍 |
年付可省 20%。官方还写明每档含固定的模型用量,用完后走按需计费(on-demand)、按实际使用后付费结算。

考虑到子 Agent 在云端并行运行,用量消耗会比单人对话模式明显更快,重度使用前建议先在小任务上观察消耗速度。人民币金额以支付渠道实时汇率为准。
常见卡点速查
| 现象 | 原因 | 解法 |
|---|---|---|
| 左侧导航里没有 Projects | beta 正在滚动推送,或客户端不是最新版 | 先升级到最新版,再等推送;不需要单独申请资格 |
| 入口有了但用不起来 | 账号是免费档,而 Cloud agents 是 Pro 起才有的权益 | 升级到 Pro 及以上,或先确认账号界面里显示的权益 |
| 子 Agent 反复改不到点上 | 任务描述里缺验收标准,协调者只能靠猜 | 按上文骨架补「验收标准」和「限制」,重新下发 |
| 用量掉得比预期快 | 并行子 Agent 的消耗远高于单人对话 | 先用小任务测消耗;超出包含额度后是按需计费结算 |
| 需要本机验证的环节没动静 | 本地 Agent 需要你的机器可用 | 保持那台电脑上的 Cursor 处于可被拉起的状态 |
| 团队账号看不到功能 | 组织层面的安全与隐私策略可能限制云端执行 | 找管理员确认 Privacy mode 与云端执行相关设置 |
常见问题
左侧导航里看不到 Projects 入口怎么办?
答:Projects 是 2026 年 9 月 10 日开始向所有用户滚动推送的 beta 功能,先更新 Cursor 到最新版本,再等推送到位,不需要单独申请资格;同时确认账号档位,Cloud Agents 相关能力从 Pro 档起才在权益列表里。
合上电脑任务会停吗?
答:不会。Project 运行在云端的独立机器上,官方明确说明合上笔记本不影响执行,只有需要在你的机器上做测试时才会临时启动本地 Agent,届时那台机器需要可用。
协调者 Agent 和普通 Agent 模式有什么区别?
答:协调者不直接写代码,它负责规划、创建和管理大量子 Agent,并把完成的成果交回给你;普通 Agent 模式是一个 Agent 面向你直接干活。大块工作交给 Projects,小修改留在普通模式。
Projects 要单独付费吗?
答:官方 changelog 未给 Projects 单独定价,它消耗的是 Cloud Agents 所在的订阅额度。官方定价页写明各档含固定模型用量,超出部分走按需计费、后付费结算,所以实际花费取决于子 Agent 的并行量。
什么样的任务适合交给 Projects?
答:官方定位是一个功能、一次迁移或一整个应用这类大块工作。临时改几行代码、问一个小问题,用普通 Agent 模式更省用量也更快。
共享上下文会不会把我的代码和资料传到别处?
答:共享上下文是随 Project 在多台云端和本地机器之间同步的一组文件,作用范围是这个 Project 自己的 Agent。如果代码本身不允许进入云执行环境,建议先和团队确认合规口径,官方在 Security 页对数据使用有说明。

京ICP备2024094994号-29