---
title: "Agents Window"
description: "基于 Cursor 官方 Agents Window 文档解释 agent-first 窗口、多工作区、并行 Agent、diff、cloud/local handoff 和 worktrees。"
verifiedAt: "2026-05-09"
---

Agents Window 是 Cursor 的 agent-first interface。官方文档把它定义成一个统一工作区：你可以跨 repo 和环境使用 Agent，包括 local、cloud、remote SSH 等场景；也可以在需要时回到经典编辑器窗口。

> [!NOTE]
> **阅读目标**：读完本章，你应该能判断什么时候用 Agents Window，什么时候回到 Editor，并能为并行 Agent 设置工作区、diff、worktree 和验收边界。

## 1. 它解决什么问题

Agents Window 的核心不是“多开几个聊天框”，而是把多个 Agent 任务从编辑器侧栏提升到一个更适合管理并行工作的界面。

```mermaid
flowchart TD
  Work["多个真实任务"] --> AgentsWindow["Agents Window"]
  AgentsWindow --> Local["Local workspace"]
  AgentsWindow --> Cloud["Cloud agents"]
  AgentsWindow --> SSH["Remote SSH"]
  AgentsWindow --> Diff["Diffs / commits / PRs"]
  AgentsWindow --> Worktrees["Isolated worktrees"]
  Diff --> Review["Review before merge"]
  Worktrees --> Isolation["每个任务独立文件和变更"]
```

如果你主要在 Cursor 里让 Agent 写大部分代码，Agents Window 会让你站在更高一层管理任务：看哪些 Agent 正在跑、哪些变更需要审查、哪些任务应该隔离到 worktree。

## 2. 打开与切回 Editor

官方文档给出两个命令入口。

| 目标 | 操作 |
| --- | --- |
| 打开 Agents Window | 在 editor 中按 `Cmd+Shift+P`，运行 `Open Agents Window` |
| 切回经典编辑器 | 按 `Cmd+Shift+P`，运行 `Open Editor Window` |
| 在 Agents Window 内找文件 | `Cmd+P` 搜索文件 |
| 在 Agents Window 内全局搜索 | `Cmd+Shift+F` 搜索所有文件 |

官方也明确说明：你可以随时切回 editor，或者让两个窗口同时打开。实操上，如果你需要密集看很多文件、拆分屏幕、使用 VS Code extensions，editor 仍然更合适。

## 3. Agents Window 独有能力

官方列出这些只在 Agents Window 中可用的能力。

| 能力 | 官方含义 | 项目里怎么用 |
| --- | --- | --- |
| Multi-workspace | 从一个地方跨项目使用 agents | 同时跟踪多个 repo 的小任务，但不要让同一个 Agent 跨仓库乱改 |
| New diffs view | 在 Cursor 内审查、提交变更并管理 PR | 把 Agent 的自然语言总结降级为参考，最终看 diff |
| Parallel agents | 在 cloud 中运行很多并行 agents，并从 phone、web、Slack、GitHub、Linear 协作 | 适合拆成多个互不冲突的任务 |
| Local/cloud handoff | 在 cloud 和 local 之间移动 agent | 需要本地快速迭代时拉回 local，长任务再交回 cloud |
| Worktrees | 在隔离 Git checkout（git worktree，把同一仓库 checkout 到独立目录）中运行 agents | 每个任务独立文件和变更，减少并行冲突 |

> [!IMPORTANT]
> Parallel agents 不是“让多个 Agent 改同一块代码”。真正安全的并行，是每个任务有独立目标、独立文件范围、独立验证方式，必要时使用 worktrees 隔离。

## 4. 怎么选 Agents Window 或 Editor

官方判断很直接。

| 你正在做什么 | 更适合用什么 |
| --- | --- |
| 管理很多 Agent 并行任务 | Agents Window |
| 让 Agent 在 cloud 中持续工作 | Agents Window |
| 需要 diff、commit、PR 管理不离开 Cursor | Agents Window |
| 主要自己写代码，只偶尔问 Agent | Editor |
| 依赖 VS Code extensions、分屏和传统 IDE 操作 | Editor |
| 需要同时打开很多文件做人工判断 | Editor |

两个界面不是互斥关系。商业项目里更常见的做法是：Agents Window 负责并行编排和交付状态，Editor 负责高密度人工阅读、精修和疑难判断。

## 5. 并行 Agent 管理清单

每开一个 Agent 前，先写清楚五件事：

1. 任务目标：它要完成什么，什么算完成。
2. 文件范围：允许看哪里，允许改哪里。
3. 工具范围：是否能跑命令、开浏览器、发起 web search。
4. 验收证据：测试、lint、build、截图、日志、diff 或 PR。
5. 冲突边界：是否和其他 Agent 改同一目录；如果会冲突，就先拆任务或用 worktree。

<details>
<summary>深读：Agents Window 为什么要和 worktrees 一起理解</summary>

当一个 Agent 只做单线程小改动时，普通 workspace 也能承受。问题出现在并行：两个 Agent 同时改相同文件，会让 diff 审查、测试归因和回退都变复杂。

Cursor 官方把 worktrees 放进 Agents Window 独有能力列表里，原因就在这里：并行任务最好有隔离 checkout。这样每个 Agent 的文件、变更、验证和提交路径都能单独审查。
</details>

## 6. Enterprise rollout 边界

官方文档记录：Agents Window 随 Cursor 3 在 2026-04-02 generally available。发布后的前两周，Enterprise Admins 可以在 Team settings 中控制给全团队或特定用户开放；之后默认所有用户可访问。

这类 rollout 信息有明显时效性。团队上线前仍要检查当前 Cursor Team settings、权限策略和内部使用规范，不要只依赖教程里的历史窗口描述。

## 本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. Agents Window 相比 Editor 的主要优势是什么？
2. 为什么并行 Agent 最好搭配 worktrees 或明确文件边界？
3. 什么时候应该从 Agents Window 切回经典 Editor？

通过标准：你能把一个多任务需求拆成多个互不冲突的 Agent 任务，并说清每个任务的 diff、验证和回退证据。

## 官方来源

- [Cursor Agents Window](https://cursor.com/docs/agent/agents-window.md) —— 官方说明 Agents Window、打开方式、独有能力、Editor 对比和 Enterprise rollout。
- [Cursor Worktrees](https://cursor.com/docs/configuration/worktrees.md) —— 官方说明通过 isolated Git checkouts 运行 agents。

## 接下来去哪

<Cards>
  <Card title="Plan Mode" description="并行前先把复杂任务规划清楚。" href="/docs/cursor/official/01-agent-workflow/12-plan-mode" />
  <Card title="Worktrees" description="继续学习用 isolated checkouts 隔离并行任务。" href="/docs/cursor/official/01-agent-workflow/20-worktrees" />
</Cards>
