---
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="/zh-Hant/docs/cursor/official/01-agent-workflow/12-plan-mode" />
  <Card title="Worktrees" description="繼續學習用 isolated checkouts 隔離並行任務。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/20-worktrees" />
</Cards>
