Cursor Agent 模式基础使用教程
来源：互联网
时间：2026-07-20 21:14:18
说实话，很多人第一次用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会开始搜索或读取相关文件，然后给出修改说明、测试结果，或者问你一些需要确认的问题。怎么判断它开始了？
，比如在无关目录里搜，就立刻叫停，补充文件路径。如果你知道目标文件在哪，就在输入框里敲如果它跑偏了
@，然后选上它。如果任务涉及多个系统，有多种方案，别急着开干，按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里都能找到；如果标签稍有变化，可以用命令面板，按核心英文词搜索。
官方资料入口：
