Cursor 已经打开了代码项目，输入框也在眼前，但第一次把任务交给 Agent 时，最容易卡住的不是“该用哪个模型”，而是任务范围不清：让它“优化项目”太宽，改了哪些文件又没有逐一检查。稳妥的入门目标只有一个：交给 Agent 一项小而明确的改动，看懂它调用了什么工具，审查结果，再决定继续、排队补充还是恢复检查点。

这套流程适用于 Windows、macOS 和 Linux 桌面版。开始前确认 Cursor 已登录并打开一个真实项目文件夹；重要代码应先提交到 Git 或另做备份。Agent 的检查点适合撤销一次会话里的改动，但 Cursor 官方明确说明它独立于 Git，不能代替长期版本控制。

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

1. 入口位置：在 Cursor 编辑器中打开命令面板，macOS 按 Cmd+Shift+P，Windows 或 Linux 按 Ctrl+Shift+P。主要动作：输入 agents，选择 View: New Agents Window。官方文档也提供侧边栏快捷入口：macOS 可按 Cmd+I 打开 Agent，Windows 或 Linux 对应使用 Ctrl+I。成功标志：出现带会话列表和底部输入框的 Agents 工作区，输入框附近能看到 Agent 模式和模型选择器。失败处理：命令列表里找不到该项时，先更新 Cursor 并重启；暂时无法使用独立窗口时，直接从编辑器侧边栏打开 Agent，也能完成后续基础操作。

把第一个请求缩到一个可验收结果

1. 入口位置：Agents 窗口底部的聊天输入框。主要动作：确认模式选择器为 Agent，写清对象、动作、边界和验收方式。第一次不要直接要求跨项目重构，可以从文案、单个组件或一条明确报错开始。例如：

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

   成功标志：Agent 开始搜索或读取相关文件，随后给出改动说明、测试结果或需要你确认的问题。失败处理：如果它在不相关目录里搜索，立即停止并补充文件路径；已知目标文件时可在输入框键入 @ 附加文件或文件夹。任务牵涉多个系统、存在多种方案时，按 Shift+Tab 切到 Plan 模式，先审查方案再开始实现。

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

1. 入口位置：Agent 会话中的工具调用记录，以及 Settings > Agents > Approvals & Execution。主要动作：观察它读取了哪些文件、准备执行什么终端命令；遇到批准提示时，先看命令、工作目录和影响范围。Cursor 当前文档把 Auto-review 作为多数人的安全实用选择：已知安全的调用可直接执行，其余调用会尽可能进入沙箱或接受进一步评审。成功标志：每个工具调用都有完成状态或可读输出，终端命令只作用于预期项目。失败处理：长时间没有进展时，先检查是否有未处理的批准提示；命令输出被截断或格式错乱时，换用更简单的 shell 提示符。不要为了省一次确认就切到 Run Everything，它会让所有工具调用自动运行且不使用沙箱。

批准窗口不是形式步骤。安装依赖、删除文件、写入项目外目录、访问网络或使用 MCP 工具，都应先确认是否真的属于当前任务。看不懂的命令可以拒绝，并要求 Agent 解释目的或换一种做法。

先审查改动，再决定是否继续

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 快速开始