Cursor Open Agents Window on Startup 设置不生效:原因与修复

关掉 Open Agents Window on Startup 后 Cursor 仍然弹出 Agents 窗口?本文梳理 v3.11 到 v3.12 的设置变更,给出 macOS 和 Windows 下可复现的修复步骤。

Cursor Open Agents Window on Startup 设置不生效:原因与修复

很多人在 Settings 里把 Open Agents Window on Startup 关掉,重启后 Cursor 照样弹出 Agents 窗口。这不是你操作失误,Cursor 官方已确认这是一个已知行为缺陷,根源在于这个开关的含义和大多数人理解的不一样。

作者CodePass 技术编辑

关掉了为什么还弹

Cursor 官方成员在论坛的回复说得很直白:Off 不代表"永远打开编辑器",它的实际含义是"恢复上次的窗口状态"。如果你退出 Cursor 时最后停留在 Agents 窗口,下次启动就会恢复到 Agents 窗口,不管开关怎么设。

用一句话概括机制:Cursor 的启动窗口由退出时的最后活跃窗口决定,而不是由这个开关单独控制。这在 v3.11 中尤其明显。论坛里从 2026 年 5 月开始就有多个 bug report 描述同一现象,覆盖 macOS 和 Windows 平台(论坛原帖)。

v3.12 起设置改名了

从 v3.12 开始,原来的 Open Agents Window on Startup 开关被替换为一个新的选项,路径变成了 Cursor Settings → General → Startup → Window Restoration。这次改名不只是换了个名字,选项也从开/关变成了三档:

  • Default:跟随产品默认行为,后续版本可能变化
  • Agent Window:启动时固定打开 Agents 窗口
  • Last Used Windows:恢复上次退出时的窗口

如果你想每次都进编辑器,选 Last Used Windows,然后确保退出前的活跃窗口是编辑器。选 Default 存在不确定性,因为 Cursor 团队可能随版本调整默认行为。

找不到这个选项的话,先确认版本号。命令面板(Cmd+Shift+P / Ctrl+Shift+P)输入 About 可查看。低于 3.12 的版本不会出现 Window Restoration,仍然只有旧的 Open Agents Window on Startup 开关。

正确的退出姿势

设好了 Last Used Windows 却还是弹 Agents?问题大概率出在退出方式上。Cursor 在退出时保存"最后活跃窗口"这个状态,保存的前提是走了正确的退出路径。

macOS 用户注意:点击窗口左上角的红色关闭按钮并不会退出 Cursor,应用进程还留在 Dock 里。下次从 Dock 点开时走的是热启动路径,有可能忽略设置。正确操作:

  1. 关掉 Agents 窗口(如果开着的话)
  2. 确保编辑器窗口在最前面
  3. Cmd+Q 完全退出

Windows / Linux:用 Alt+F4 或菜单栏的退出选项关闭编辑器窗口。如果 Agents 窗口仍然开着,先关掉它,再从编辑器窗口退出。

这套操作只需要做一次。只要退出时编辑器是最后的活跃窗口,后续每次启动都会恢复到编辑器,不需要重复操作。

终端启动时走的是另一条路

如果你习惯在终端用 cursor . 打开项目,会发现前面的设置完全不起作用。cursor . 走的是独立的启动路径,不受 Window Restoration 控制。论坛里有用户反馈新目录用 cursor . 打开时总是弹出 Agents 界面。

解决方法是加一个 flag:

cursor . --classic

--classic 会跳过 Agents 窗口,直接打开经典编辑器并加载当前目录。如果你的日常流程依赖终端启动,可以在 shell 配置里加个 alias:

alias c='cursor . --classic'

3.12.26 补丁后的改善

Cursor 官方在 3.12.26 版本发布了针对性修复。在这个补丁之前,即使 Window Restoration 设成了 Last Used Windows,也存在"关掉所有窗口再重新打开"时仍然弹 Agents 的问题。补丁修复后,只要你选了 Last Used Windows 并且上次是从编辑器退出的,无论是 Cmd+Q 退出后重开,还是关掉所有窗口后重开,都会正确恢复到编辑器。

如果你已经在 3.12.26 或更高版本仍然遇到问题,可以试一次完整的重置流程:

  1. 打开编辑器窗口和 Agents 窗口
  2. 先聚焦到 Agents 窗口,按 Cmd+Q 退出
  3. 重新打开 Cursor,如果 Agents 窗口又出现了,关掉它
  4. 聚焦编辑器窗口,再次 Cmd+Q
  5. 再启动,此时应该只出现编辑器

这个序列的目的是把保存的窗口会话里的 Agents 窗口清除掉。

不想切窗口?用编辑器内的 Agent 面板

Agents 窗口和编辑器是两个独立窗口。如果你只是想在写代码时随时调出 Agent 对话,不需要打开单独的 Agents 窗口。在编辑器里按 Ctrl+E(或 Ctrl+L)就能打开侧边 Agent 面板,功能和独立的 Agents 窗口基本一致,不存在启动落点的问题。

对于大多数只在编辑代码过程中偶尔派任务给 Agent 的用户来说,侧边面板比独立窗口更顺手。如果你的需求是启动时直接进入 Agents 工作台,把 Window Restoration 设成 Agent Window 即可,不用依赖 Default 选项。配置遇到其它设置项不生效的情况,可以参考新手常犯的配置错误排查。

参考资料