说实话,很多开发者在初次使用 Cursor 的 Agent 功能时,遇到的最大障碍并非模型选择,而是任务边界没有划分清楚。你可能会想:“让 Agent 帮我优化一下项目。”但这种表述过于宽泛,改动完成后你甚至不清楚它修改了哪些文件。因此,最稳妥的入门方式只有一种:交给它一个极其具体、范围明确的改动任务,然后观察它如何使用工具,仔细审查修改结果,再决定下一步是继续推进、补充细节还是直接撤回。
这套操作流程在 Windows、macOS 和 Linux 桌面版上均可使用。开始之前,请确认三件事:Cursor 已成功登录,项目文件夹已正确打开,重要代码要么已提交到 Git 仓库,要么已单独备份。Agent 自带的检查点仅适用于撤回当前会话中的改动,这与 Git 的版本管理机制完全不同,不要将其作为长期版本管理工具来依赖。
先打开 Agents 窗口,清晰了解任务全貌
如何进入? 在 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 也能完成后续操作。

第一个请求,务必小到能够验收结果
在哪里输入? Agents 窗口底部的聊天框。输入前,请确认模式已切换为
Agent。然后,将请求写清楚:明确对象是谁,要做什么,不做什么,以及最终的验收方式。第一次使用时,不要让它重构整个项目,修改文案、调整组件或修复报错就足够了。例如:检查登录表单组件,仅修复密码输入框缺少可访问标签的问题。不要改动接口和页面布局。完成后列出所有修改过的文件,并运行与该组件相关的测试用例。
如何判断 Agent 已开始工作? Agent 会开始搜索或读取相关文件,然后给出修改说明、测试结果,或向你询问需要确认的问题。如果它偏离了方向,比如在无关目录中搜索,请立即叫停,并补充文件路径。如果你知道目标文件的具体位置,可以在输入框中输入
@,然后选择该文件。如果任务涉及多个系统并且有多种方案,不要急于执行,按Shift+Tab切换到 Plan 模式,先把方案看清楚再行动。

执行过程中,只批准你理解的操作
在哪里查看? Agent 会话中的工具调用记录,以及
Settings > Agents > Approvals & Execution这个设置项。具体怎么做? 密切关注它读取了哪些文件,准备执行什么终端命令。遇到批准提示时,先仔细查看命令、工作目录和影响范围。Cursor 目前将Auto-review作为默认选项,这在大多数情况下既安全又高效:已知安全的调用会直接执行,其他调用则会进入沙箱或需要你手动审核。如何确认操作成功? 每个工具调用都有完成状态或可读的输出,终端命令也只作用于你期望的项目目录。如果卡住了怎么办? 先检查是否有未处理的批准提示。如果命令输出被截断或格式混乱,可以尝试更换一个更简单的 shell 提示符。不要为了省事而切换到Run Everything,这会导致所有工具调用自动运行且不使用沙箱。
那个批准窗口并非摆设。安装依赖、删除文件、写入项目外的目录、访问网络、使用 MCP 工具时,都需要仔细思考该操作是否真正属于当前任务。对于看不懂的命令,直接拒绝,要求它解释清楚,或者换一种实现方式。
先审查改动,再决定是否继续
在哪里查看? Agent 完成消息下方的文件数量,或者
Review按钮。如何进行审查? 逐个打开改动过的文件,确认新增和删除的内容都是原始请求所要求的。同时检查测试是否真的运行了,失败的项是否清楚说明了原因。如何判断审查结果? 修改的文件、行为的变化、测试的结果,必须能够一一对应。没有出现无关的格式化、依赖升级或大范围重写。发现越界了怎么办? 先不要提交,直接指出具体文件和需要撤销的部分,或者恢复到任务开始前的检查点。需要查看所有文件? 在 Agents 窗口的操作面板或命令面板中,搜索
Open Editor Window。有些地方也叫Open IDE,作用相同,都是将工作区切换回经典编辑器。如何确认成功? 当前仓库会在编辑器中打开,你可以使用文件搜索、Source Control 和扩展继续检查。找不到命令怎么办? 只搜索Open和Editor这两个关键词。即使不离开 Agents 窗口,也可以使用Cmd/Ctrl+P查找文件,或者使用Cmd/Ctrl+Shift+F搜索整个项目。

追加要求时,分清是要排队还是立刻插队
在哪里输入? Agent 正在工作时,底部的聊天框。如何操作? 直接按
Enter,指令会进入队列。如果情况紧急,需要立刻纠正方向,macOS 按Cmd+Enter,Windows 或 Linux 按Ctrl+Enter,即可跳过队列,直接发送。如何查看状态? 排队后,当前任务下方会出现in queue和等待执行的指令。当前任务一结束,队列中的指令会按顺序开始处理。没有成功排队怎么办? 如果后续指令立刻执行了而没有进入队列,通常是因为当前任务已经完成,或者你按错了快捷键。紧急纠正时不要只排队,该立刻发送就立刻发送,必要时先按 Stop 将当前运行停止。

任务偏了,用检查点退回去,别反复打补丁
在哪里找到? Agent 会话时间线中的检查点,或者之前某个请求上的
Restore Checkpoint。如何使用? 先预览检查点对应的文件状态,确认范围后,再执行恢复操作。如何确认成功? 本次会话修改过的文件,会回到那个检查点记录的状态。然后,你可以用更精确的请求重新开始。没有检查点怎么办? 如果需要跨会话追溯,或者要保留长期历史,就得使用 Git 来查看差异和恢复提交。不要把本地检查点当成提交记录来使用。
第一次 Agent 任务结束时,核对这些信号
- Cursor 已经打开了正确的项目文件夹,重要改动有 Git 提交或其他备份。
- 输入框处于 Agent 模式,第一个请求包含了对象、边界和可检查的结果。
- 工具调用、终端命令和批准范围,你都能解释清楚,没有放行自己不理解的高风险操作。
- 完成消息里有修改摘要、文件列表和测试结果,而且你逐个审查过差异。
- 普通的补充指令进了队列,紧急纠正用的立即发送或 Stop,没有把两种行为搞混。
- 知道检查点只处理当前 Agent 会话里的代码快照,长期版本管理还得靠 Git。
- 教程里的四个界面入口,你在当前 Cursor 里都能找到;如果标签稍有变化,可以用命令面板,按核心英文词搜索。
官方资料入口:
