Cursor Agent 模式基础使用教程

说实话，很多人第一次用Cursor的Agent时，卡住的不是选哪个模型，而是任务边界没划清楚。你可能会想：“让Agent帮我优化一下项目。” 但这话太宽了，改完你都不知道它动了哪些文件。所以，最稳妥的入门方法只有一个：交给它一个特别小、特别明确的改动，然后看着它用工具，审它改的结果，再决定下一步是继续、补充还是撤回。

这套流程，Windows、macOS、Linux桌面版都能用。开始之前，确认三件事：Cursor已经登录，项目文件夹已经打开，重要代码要么提交到Git，要么单独备份了。Agent自带的检查点只适用于撤回当前会话里的改动，这和Git是两码事，别指望它做长期版本管理。

先打开Agents窗口，看清任务全貌

1. 怎么进？
   在Cursor里敲命令面板，macOS是 Cmd+Shift+P，Windows和Linux是 Ctrl+Shift+P。然后，输入 agents，选 View: New Agents Window。对了，侧边栏也有快捷入口：macOS按 Cmd+I，Windows和Linux按 Ctrl+I，也能直接打开Agent。

   成功了没？
   看到左侧有会话列表，底部有输入框，输入框旁边有Agent模式和模型选择器，就算成了。

   要是找不到呢？
   先更新Cursor并重启。如果实在打不开独立窗口，用编辑器侧边栏的Agent也能完成下面的操作。

第一个请求，一定要小到能验收结果

1. 在哪输入？
   Agents窗口底部的聊天框。写之前，确认模式切换到了 Agent。然后，把请求写清楚：对象是谁，要做什么，不做什么，最后怎么验收。第一次别让人家去重构整个项目，改个文案、调个组件、修个报错就行。比如：

   检查登录表单组件，只修复密码输入框缺少可访问标签的问题。不要改接口和页面布局。完成后列出修改文件，并运行与该组件相关的测试。

   怎么判断它开始了？
   Agent会开始搜索或读取相关文件，然后给出修改说明、测试结果，或者问你一些需要确认的问题。

   如果它跑偏了
   ，比如在无关目录里搜，就立刻叫停，补充文件路径。如果你知道目标文件在哪，就在输入框里敲 @，然后选上它。如果任务涉及多个系统，有多种方案，别急着开干，按 Shift+Tab 切到Plan模式，先把方案看清楚再说。

执行过程中，只批准你理解的操作

1. 在哪看？
   Agent会话里的工具调用记录，还有 Settings > Agents > Approvals & Execution 这个设置项。

   怎么做？
   盯着它读了哪些文件，准备执行什么终端命令。遇到批准提示，先看清命令、工作目录和影响范围。Cursor现在的做法是把 Auto-review 作为默认选项，这在多数情况下既安全又实用：已知安全的调用直接执行，其他的会进入沙箱或需要你过目。

   成功了没？
   每个工具调用都有完成状态或可读的输出，终端命令也只作用于你期望的项目。

   卡住了？
   先检查有没有未处理的批准提示。如果命令输出被截断或格式乱了，换个更简单的shell提示符。别图省事就切到 Run Everything，那会让所有工具调用自动运行，而且不用沙箱。

那个批准窗口不是摆设。安装依赖、删除文件、写入项目外的目录、访问网络、用MCP工具，都得先想想这活儿是不是真的属于当前任务。看不懂的命令，直接拒绝，让它解释清楚，或者换个做法。

先审查改动，再决定要不要继续

1. 在哪看？
   Agent完成消息下方的文件数量，或者 Review 按钮。

   怎么看？
   逐个打开改动过的文件，确认新增和删除的内容都是原始请求要的。同时检查测试是不是真的跑了，失败的项有没有说清楚原因。

   怎么看结果？
   修改的文件、行为的变化、测试的结果，得能一一对上。没出现无关的格式化、依赖升级或者大范围重写。

   发现越界了？
   先别提交，直接指出具体文件和要撤销的部分，或者恢复到任务开始前的检查点。

2. 要看所有文件？
   在Agents窗口的操作面板或命令面板里，搜索 Open Editor Window。有些地方也叫 Open IDE，作用一样，都是把工作区切回经典编辑器。

   成功了？
   当前仓库在编辑器里打开，可以用文件搜索、Source Control和扩展继续检查。

   找不到命令？
   只搜 Open 和 Editor 这两个词。不离开Agents窗口，也能用 Cmd/Ctrl+P 找文件，或者用 Cmd/Ctrl+Shift+F 搜索整个项目。

追加要求时，分清是要排队还是立刻插队

1. 在哪输入？
   Agent正在工作时，底部的聊天框。

   怎么操作？
   直接按 Enter，指令就进队列了。如果情况紧急，需要立刻纠正方向，macOS按 Cmd+Enter，Windows或Linux按 Ctrl+Enter，就能跳过队列，直接发出去。

   怎么看状态？
   排队后，当前任务下面会出现 in queue 和等待执行的指令。当前任务一结束，队列里的指令会按顺序开始处理。

   没排上队？
   如果后续指令立刻执行了，没进队列，那通常是当前任务已经完成，或者你按错了快捷键。紧急纠正时别只排队，该立刻发送就立刻发送，必要时先按Stop把当前运行停了。

任务偏了，用检查点退回去，别反复打补丁

1. 在哪找？
   Agent会话时间线里的检查点，或者之前某个请求上的 Restore Checkpoint。

   怎么用？
   先预览检查点对应的文件状态，确认范围后，再执行恢复。

   成功了？
   本次会话改过的文件，会回到那个检查点记录的状态。然后，你可以用更精确的请求重新开始。

   没检查点？
   或者需要跨会话追溯，或者要保留长期历史，那就得用Git来看差异和恢复提交了。别把本地检查点当成提交记录用。

第一次Agent任务结束时，核对这些信号

• Cursor已经打开了正确的项目文件夹，重要改动有Git提交或其他备份。
• 输入框处于Agent模式，第一个请求包含了对象、边界和可检查的结果。
• 工具调用、终端命令和批准范围，你都能解释清楚，没有放行自己不理解的高风险操作。
• 完成消息里有修改摘要、文件列表和测试结果，而且你逐个审查过差异。
• 普通的补充指令进了队列，紧急纠正用的立即发送或Stop，没把两种行为搞混。
• 知道检查点只处理当前Agent会话里的代码快照，长期版本管理还得靠Git。
• 教程里的四个界面入口，你在当前Cursor里都能找到；如果标签稍有变化，可以用命令面板，按核心英文词搜索。

官方资料入口：

• Cursor Agent 概览
• Agents 窗口
• 为 Agent 编写提示
• Plan 模式
• 运行模式与批准设置
• Cursor 快速开始