使用 Agent view 管理多個代理
從一個螢幕分派和管理許多 Claude Code 工作階段。Agent view 顯示每個工作階段正在做什麼，以及哪些需要您的輸入。
Agent view（使用 claude agents 開啟）是所有背景工作階段的一個螢幕：什麼正在執行、什麼需要您的輸入，以及什麼已完成。分派新工作階段，一目瞭然地查看它們的狀態，而不是滾動瀏覽記錄，並且只在需要時才介入。每個背景工作階段都是一個完整的 Claude Code 對話，在沒有終端連接的情況下持續執行，因此您可以隨時開啟、回覆和離開。
當您有多個獨立任務 Claude 可以在不需要您監看每一步的情況下執行時，請使用 agent view。分派一個錯誤修復、一個拉取請求審查和一個不穩定測試調查作為三行，在另一個視窗中繼續工作，並在某一行顯示需要您或有結果時檢查。
當您想在任何代理的工作階段中更直接地工作時，附加到該行以進入完整對話。
若要比較 agent view 與 subagents、agent teams 和 worktrees，請參閱 平行執行代理。
本頁涵蓋：
- 快速開始：給 Claude 一個在背景中執行的任務，檢查它，並在需要時介入
- 使用 agent view 監控工作階段，包括狀態圖示、查看和回覆、附加、組織和快捷鍵
- 分派新代理，從 agent view、從工作階段內部或從 shell
- 從 shell 管理工作階段
- 背景工作階段如何被託管，由監督程序
快速開始
本逐步解說涵蓋核心 agent view 迴圈：分派工作、觀看其列更新（Claude 正在工作）、查看以檢查並回覆，以及附加到完整對話。您分派的工作階段在關閉 agent view 後會繼續執行，因此您可以離開並稍後返回。
開啟 agent view
從您的 shell，執行：
claude agents
Agent view 開啟，底部有輸入框，隨著工作階段啟動，表格會填入。隨時按 Esc 返回您的 shell。您的工作階段在您離開時繼續執行，下次開啟 agent view 時會重新出現。
查看和回覆
使用箭頭鍵選擇一列，然後按 Space 開啟查看面板。它顯示工作階段的最新輸出或它正在等待的問題，而不是完整的文字記錄。輸入回覆並按 Enter 發送，無需離開 agent view。
附加和分離
在一列上按 Enter 或 → 以在需要完整對話時附加。工作階段接管終端，就像您執行了 claude 一樣。在空提示上按 ← 分離並返回表格。
帶入現有工作階段
要將您已開啟的工作階段移入 agent view，在其中執行 /bg，或在空提示上按 ← 以在一個步驟中背景化工作階段並開啟 agent view。工作階段繼續執行並顯示為一列，與您分派的工作階段並排。
您可以使用 claude agents 作為主要進入點而不是 claude：從 agent view 分派每個工作，在需要完整對話時附加，然後按 ← 返回表格。
使用 agent view 監控工作階段
執行 claude agents 開啟 agent view。它接管整個終端並列出按狀態分組的每個工作階段，固定的工作階段和需要您的工作階段在頂部。每行顯示工作階段的名稱、當前活動和上次更改的時間。
根據預設，該列表顯示您啟動的每個背景工作階段，跨越所有您的專案。在一個儲存庫中工作的工作階段和在不同 worktree 中工作的另一個工作階段都會出現在這裡，無論您從哪個目錄開啟 agent view。要將檢視範圍限制在一個專案，請傳遞 --cwd（需要 Claude Code v2.1.141 或更新版本）：
claude agents --cwd ~/projects/my-app
這只會顯示在該目錄下啟動的工作階段。已 移入 worktree 在 ~/projects/my-app/.claude/worktrees/ 下的工作階段仍然算作屬於 ~/projects/my-app。
您在其他終端中開啟的互動工作階段在您 背景化它們 之前不會出現。Subagents 和 teammates 工作階段產生的不會列為單獨的行。
Pinned
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
Ready for review
∙ jump physics github.com/example/game/pull/2048 ● 2h
Needs input
✻ power-up design needs input: double jump or wall climb? 1m
Working
✽ collision detection Edit src/physics/CollisionSystem.ts 2m
✢ playtest level 3 run 12 · all checkpoints cleared in 4m
Completed
✻ title screen result: menu, options, and credits done 9m
∙ sound effects result: 14 SFX exported to assets/audio 4h
… 6 more
讀取工作階段狀態
每行開始的圖示，其顏色和動畫顯示工作階段的狀態：
| 狀態 | 圖示顯示為 | 含義 |
|---|---|---|
| 工作中 | 動畫 | Claude 正在主動執行工具或生成回應 |
| 需要輸入 | 黃色 | Claude 正在等待您的特定問題或權限決定 |
| 閒置 | 淡化 | 工作階段沒有事情要做，準備好接收您的下一個提示 |
| 已完成 | 綠色 | 任務成功完成 |
| 失敗 | 紅色 | 任務以錯誤結束 |
| 已停止 | 灰色 | 工作階段已使用 Ctrl+X 或 claude stop 停止 |
另外，圖示的形狀顯示底層程序是否正在執行：
| 形狀 | 含義 |
|---|---|
✻ 或動畫 ✽ |
工作階段程序處於活動狀態並立即回覆 |
∙ |
程序已退出。您仍然可以查看、回覆或附加，Claude 從中斷的地方重新啟動 |
✢ |
一個 /loop 工作階段在迭代之間休眠。該行顯示其執行計數和倒計時 |
出現在行右邊緣的 ● 是 拉取請求狀態 指示器，不是狀態圖示的一部分。它前面的數字是工作階段開啟的拉取請求計數。
背景工作階段不需要任何開啟的終端即可繼續工作。單獨的 監督程序 執行它們，因此您可以關閉 agent view、關閉 shell 或啟動新的互動工作階段，您分派的工作會繼續進行。
工作階段狀態通過自動更新和監督程序重新啟動在磁碟上持久化。工作階段也會在您的機器進入睡眠時保留。它們的程序在喚醒時恢復，監督程序會重新連接到它們，而不是將時間間隔視為閒置。關閉仍會停止執行中的工作階段；請參閱 工作階段在關閉後顯示為失敗 以了解如何恢復它們。
行摘要
每行中的單行摘要由 Haiku-class 模型 生成，因此該行可以告訴您工作階段正在做什麼、需要什麼或生成了什麼，無需開啟記錄。當工作階段主動工作時，摘要最多每 15 秒刷新一次，加上每個回合結束時刷新一次。
每次刷新都是通過您的正常提供者的一個簡短 Haiku-class 請求，按照與工作階段本身相同的 資料使用條款 計費和處理。
拉取請求狀態
當工作階段開啟拉取請求時，狀態點會出現在該行的右邊緣，在支援超連結的終端中連結到拉取請求。當工作階段開啟了多個拉取請求時，計數會出現在點之前，顏色反映最需要關注的那個。
| 點的顏色 | 拉取請求狀態 |
|---|---|
| 黃色 | 等待檢查或審查，或檢查失敗 |
| 綠色 | 檢查通過且沒有審查阻止 |
| 紫色 | 已合併 |
| 灰色 | 草稿或已關閉 |
對於大多數任務，此行是您收集結果的地方：當點變綠時審查並合併拉取請求。
查看和回覆
在選定的行上按 Space 開啟查看面板。它顯示工作階段需要您提供什麼、其最近的輸出以及它開啟的任何拉取請求。大多數時候這就足夠了，您永遠不需要開啟完整記錄。
在查看面板中輸入回覆並按 Enter 將其發送到該工作階段。當工作階段詢問多選問題時，查看面板顯示選項，您可以按數字鍵選擇一個。對於其他被阻止的工作階段，按 Tab 用建議的回覆填充輸入，您可以在發送前編輯。使用 ! 前綴回覆以發送 Bash 命令。
使用 ↑ 和 ↓ 查看相鄰工作階段而無需關閉面板，或按 → 附加。
附加到工作階段
在選定的行上按 Enter 或 → 附加。Agent view 被完整的互動工作階段替換，就像您在該目錄中執行了 claude 一樣。附加時，Claude 發佈您離開時發生的簡短回顧。
附加時，工作階段的行為與任何其他 Claude Code 工作階段相同：每個 命令、快捷鍵和功能都有效。
在空提示上按 ← 分離並返回 agent view。如果對話框有焦點且不響應 ←，按 Ctrl+Z 立即分離。
分離永遠不會停止背景工作階段：←、Ctrl+C、Ctrl+D、Ctrl+Z 和 /exit 都會讓它繼續執行。要從內部結束工作階段，執行 /stop。
在您分派或背景化工作階段後，在空提示上按 ← 可從任何 Claude Code 工作階段工作，而不僅僅是您從 agent view 附加的工作階段。它背景化當前工作階段並開啟 agent view，預先選擇該工作階段，因此您可以在不離開終端的情況下切換工作階段。該行會被建立，即使是從沒有對話歷史的全新工作階段，所以 → 會返回到它。當該行是唯一的行時，agent view 會在其下方顯示一個入門提示。您可以在 /config 中關閉此快捷鍵（leftArrowOpensAgents 設定）。
組織列表
Agent view 按狀態分組工作階段，需要輸入的工作階段在頂部，Ready for review 和 Needs input 在 Working 和 Completed 上方。這些組名稱不與上面的 狀態 一一對應：當工作階段有開啟的拉取請求時，它會移動到 Ready for review，Completed 收集已完成、失敗和已停止的工作階段。按 Ctrl+S 改為按目錄分組。您的選擇在執行中保存。
在組內：
- 按
Ctrl+T將工作階段固定到頂部 - 按
Shift+↑或Shift+↓重新排序工作階段 - 按
Ctrl+R重命名工作階段 - 在組標題上按
Enter摺疊它
要移除工作階段，按 Ctrl+X 停止它，然後在兩秒內再次按 Ctrl+X 刪除它。在組標題上按 Ctrl+X 會在確認後刪除該組中的每個工作階段。
刪除會從 agent view 中移除工作階段並移除其對話記錄。如果 Claude 為工作階段建立了 worktree，刪除會移除該 worktree，包括其中的任何未提交的更改，因此在刪除前推送或提交您想保留的工作。您自己建立的 worktree 並在其中啟動工作階段的會保留在原地。
較舊的已完成工作階段摺疊為 … N more 行以保持列表簡短。失敗和具有開啟拉取請求的工作階段始終保持可見。
篩選工作階段
在分派輸入中輸入以篩選而不是分派：
| 篩選 | 顯示 |
|---|---|
a:<name> |
執行命名代理的工作階段 |
s:<state> |
給定狀態中的工作階段，例如 s:working。也接受 s:blocked 表示等待您的所有工作階段 |
#<number> 或 PR URL |
在該拉取請求上工作的工作階段 |
快捷鍵
在 agent view 中按 ? 查看每個快捷鍵。下表總結了它們。
| 快捷鍵 | 動作 |
|---|---|
↑ / ↓ |
在行之間移動 |
Enter |
附加到選定的工作階段，或如果輸入中有文字則分派 |
Space |
開啟或關閉選定工作階段的查看面板 |
Shift+Enter |
分派並立即附加 |
→ |
附加到選定的工作階段 |
Alt+1..Alt+9 |
附加到焦點工作階段目錄中的工作階段 1–9 |
Tab |
在空輸入上，瀏覽所有 subagents。否則應用突出顯示的建議 |
Ctrl+S |
在狀態和目錄之間切換分組 |
Ctrl+T |
固定或取消固定選定的工作階段 |
Ctrl+R |
重命名選定的工作階段 |
Ctrl+G |
在您的 $VISUAL 或 $EDITOR 中開啟分派提示 |
Ctrl+X |
停止工作階段；在兩秒內再次按以刪除它 |
Shift+↑ / Shift+↓ |
重新排序選定的工作階段 |
Esc |
關閉查看面板、清除輸入或退出 |
Ctrl+C |
清除輸入；按兩次退出 |
? |
顯示所有快捷鍵 |
分派新代理
您可以從 agent view 分派新的背景工作階段、將現有互動工作階段發送到背景，或直接從 shell 啟動一個。
從 agent view
在 agent view 底部的輸入框中輸入提示，然後按 Enter 啟動新的背景工作階段。工作階段從提示自動命名；稍後可以使用 Ctrl+R 重命名它。
將圖像粘貼到提示中以包含螢幕截圖或圖表與任務。
前綴或提及提示的部分以控制工作階段如何啟動：
| 輸入 | 效果 |
|---|---|
<agent-name> <prompt> |
如果第一個單詞與自訂 subagent 名稱匹配，該 subagent 以工作階段的主代理身份執行，其 frontmatter 中的配置 |
@<agent-name> |
在提示中的任何地方提及自訂 subagent 以將其作為主代理執行 |
@<repo> |
提及您開啟 agent view 的目錄下的存儲庫以在那裡執行工作階段 |
/<skill> |
建議 skills 作為提示分派 |
#<number> 或拉取請求 URL |
如果工作階段已在該 PR 上工作，選擇它而不是分派 |
Shift+Enter |
分派並立即附加到新工作階段 |
將重複任務打包為 skill 可讓您從 agent view 多次啟動相同的工作流程，無需重新輸入提示。
當相同的 @name 同時與 subagent 和同級存儲庫匹配時，subagent 優先。不帶 @ 的第一個單詞形式也適用，因此以與您的 subagent 名稱之一匹配的單詞開頭的提示會分派該 subagent 而不是將該單詞視為純文本。當您想要明確時，請使用 @ 形式，或以不同的單詞開頭提示以避免匹配。
分派到特定目錄
新工作階段在您開啟 agent view 的目錄中執行。要針對不同的目錄：
- 在該目錄中開啟
claude agents。 - 在包含多個存儲庫的父目錄中開啟
claude agents，並在提示中使用@<repo>提及一個以在那裡執行工作階段。 - 從 shell，
cd進入目錄並執行claude --bg "<prompt>"。
當 agent view 按目錄分組時，突出顯示的行的目錄成為分派目標，因此您可以滾動到組並在其中分派，無需重新輸入路徑。
從工作階段內部
執行 /background 或其別名 /bg 將當前對話移動到背景工作階段。傳遞提示，例如 /bg run the test suite and fix any failures，以在分派前發送一個額外的指令。
從互動工作階段背景化會啟動一個新的進程，該進程從保存的對話恢復，因此執行 subagents、monitors 和背景命令不會轉移到它。當任何正在執行時，Claude 會要求您在背景化前確認。進入背景後，工作階段可以啟動新的 subagents、monitors 和背景命令，這些命令在稍後分離和重新附加時保持執行。
來自原始啟動的配置標誌會傳遞到背景化工作階段，因此其 MCP servers、settings 和備用模型保持有效：
--mcp-config和--strict-mcp-config--settings--add-dir--plugin-dir--fallback-model--allow-dangerously-skip-permissions
傳遞 --allow-dangerously-skip-permissions 會在背景化工作階段中保持 bypassPermissions 可達，但它不會授予任何新的權限。該模式仍然需要在任何工作階段使用它之前進行相同的一次性互動接受，如 Permission mode, model, and effort 中所述。
從您的 shell
傳遞 --bg 啟動直接進入背景的工作階段：
claude --bg "investigate the flaky SettingsChangeDetector test"
要執行特定 subagent 作為工作階段的主代理，將 --bg 與 --agent 結合：
claude --agent code-reviewer --bg "address review comments on PR 1234"
傳遞 --name 以在 agent view 中設定工作階段的顯示名稱，而不是自動生成的名稱：
claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"
背景化後，Claude 列印工作階段的短 ID 和管理它的命令：
backgrounded · 7c5dcf5d
claude agents list sessions
claude attach 7c5dcf5d open in this terminal
claude logs 7c5dcf5d show recent output
claude stop 7c5dcf5d stop this session
檔案編輯如何隔離
每個背景工作階段，無論是從 agent view、/bg 或 claude --bg 啟動，都在您的工作目錄中啟動。編輯檔案前，Claude 將工作階段移動到 .claude/worktrees/ 下的隔離 git worktree 中，因此並行工作階段可以讀取相同的檢出，但每個都寫入自己的。
Claude 在以下情況下跳過 worktree：
- 工作階段已在連結的 git worktree 內，無論 Claude 是在
.claude/worktrees/下建立它，還是您使用git worktree add在其他地方建立它 - 工作目錄不是 git 存儲庫
- 寫入在工作目錄外
要為 git worktrees 不實用的存儲庫關閉 worktree 隔離，請將 worktree.bgIsolation 設定為 "none"。背景工作階段隨後直接編輯您的工作副本，無需先移動到 worktree。將設定新增到專案的 .claude/settings.json：
{
"worktree": {
"bgIsolation": "none"
}
}
在 git 存儲庫外，工作階段直接寫入工作目錄，彼此之間不隔離，因此避免分派編輯相同檔案的並行工作階段。
在 agent view 中刪除工作階段（Ctrl+X 兩次）會移除 Claude 為其建立的 worktree，包括任何未提交的更改，因此在刪除前合併或推送您想保留的更改。從 shell 使用 claude rm 刪除會保留具有未提交更改的 worktree 並列印其路徑，以便您可以自己清理它。您自己建立並在其中啟動工作階段的 worktree 無論如何都會保留在原位。
要找到工作階段的 worktree 路徑，查看工作階段或附加並檢查其工作目錄。
要使 subagent 始終在其自己的 worktree 中執行，無論如何啟動，請在其 frontmatter 中設定 isolation: worktree。
設定模型
agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型，這與 /model 在任何工作階段中控制的設定相同。要為整個 agent view 工作階段覆蓋它，請在開啟 agent view 時傳遞 --model。請參閱 Permission mode, model, and effort。
每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它：
- 從 shell，使用
claude --bg傳遞--model。 - 附加到執行中的工作階段並在那裡執行
/model。如果工作階段被重新生成，更改會持續。 - 分派一個 subagent，其 frontmatter 設定
model欄位。
Permission mode, model, and effort
背景工作階段從它執行的目錄讀取其 settings，就像您在那裡啟動了 claude 一樣。
permission mode 取決於您如何啟動工作階段。使用 /bg 或 ← 背景化現有工作階段會保持當前權限模式，因此您切換到 acceptEdits 或 auto 的工作階段在分離後仍保持該模式。從 agent view 輸入分派或從 shell 執行 claude --bg 使用該目錄設定中的 defaultMode，或分派的 subagent 的 frontmatter 中的 permissionMode。
您啟動背景工作階段時的權限模式在監督者稍後 stops and restarts 工作階段的進程時持續。您使用 claude --bg --dangerously-skip-permissions 或 claude --bg --permission-mode bypassPermissions 啟動的工作階段在該重新啟動後保持 bypassPermissions，而不是回退到目錄的 defaultMode。
要為您從 agent view 分派的每個工作階段設定預設值，請在開啟它時傳遞 --permission-mode、--model 或 --effort 中的任何一個：
claude agents --permission-mode plan --model opus --effort high
claude agents 也接受 --dangerously-skip-permissions 作為 --permission-mode bypassPermissions 的簡寫，以及 --allow-dangerously-skip-permissions 以在每個分派工作階段的 Shift+Tab 循環中提供 bypassPermissions，而不是以該模式啟動。兩者都與 top-level CLI flags 相符。
活動預設值出現在分派輸入下方的頁腳中。
沒有這些標誌，工作階段使用該目錄設定中的 defaultMode 或分派的 subagent 的 frontmatter 中的 permissionMode，以及 agent view 標題中顯示的模型。
使用 bypassPermissions 或 auto 被拒絕，直到您通過以互動方式運行 claude 接受該模式，因為這些模式讓您未監視的工作階段無需批准即可行動。無論您是將模式傳遞給 claude agents 還是 claude --bg --permission-mode，同樣的規則也適用。
Settings, plugins, and MCP servers
Agent view 接受與 claude 相同的配置標誌，用於載入 settings、plugins、MCP servers 和額外目錄。這些標誌需要 Claude Code v2.1.142 或更新版本。每個標誌適用於 agent view 本身，並傳遞給您從它分派的每個工作階段，因此以這種方式載入的 plugin 或 MCP server 在這些工作階段中也可用。
| 標誌 | 效果 |
|---|---|
--settings <file-or-json> |
覆蓋 agent view 和分派工作階段的 settings |
--add-dir <path> |
授予對額外目錄的檔案存取權限 |
--plugin-dir <path> |
從本地目錄載入 plugin |
--mcp-config <file-or-json> |
從配置檔案或 JSON 字符串載入 MCP servers |
--strict-mcp-config |
僅使用來自 --mcp-config 的 MCP servers，忽略其他 MCP 配置 |
每個值重複 --add-dir、--plugin-dir 或 --mcp-config 一次。空格分隔的形式，例如 --add-dir a b c，不支援與 claude agents 一起使用。
以下示例使用 settings 覆蓋和一個額外目錄開啟 agent view：
claude agents --settings ./ci-settings.json --add-dir ../shared-lib
從 shell 管理工作階段
每個背景工作階段都有一個短 ID，您可以從 shell 使用。當您使用 claude --bg 啟動工作階段時會列印該 ID，每個工作階段的 ID 是其在 ~/.claude/jobs/ 下的目錄名稱。這些命令對於指令碼編寫或當您不想開啟 agent view 時很有用。
| 命令 | 目的 |
|---|---|
claude agents |
開啟 agent view |
claude agents --cwd <path> |
開啟 agent view，範圍限定於在 <path> 下啟動的工作階段 |
claude attach <id> |
在此終端中附加到工作階段 |
claude logs <id> |
列印工作階段的最近輸出 |
claude stop <id> |
停止工作階段。也接受 claude kill |
claude respawn <id> |
重新啟動工作階段（執行中或已停止），保持其對話完整，例如用於採用更新的 Claude Code 二進位檔案 |
claude respawn --all |
重新啟動每個執行中的工作階段，例如一次將所有工作階段移至更新的 Claude Code 二進位檔案 |
claude rm <id> |
移除工作階段及其文字記錄。如果沒有未提交的變更，會移除 Claude 為工作階段建立的 worktree；否則會列印 worktree 路徑以便您清理。保留您自己建立的 worktree |
claude daemon status |
列印 supervisor 的狀態、版本、socket 目錄和 worker 計數 |
背景工作階段如何被託管
agent view 中列出的每個工作階段都被視為背景工作階段，無論您目前是否連接到它。相比之下，直接執行 claude 啟動的工作階段與該終端相關聯，並在終端關閉時結束，除非您將其發送到背景。
監督程序
背景工作階段由每個使用者的監督程序託管，與您的終端和 agent view 分開。監督程序在您第一次背景化工作階段或開啟 agent view 時自動啟動，您不直接管理它。
監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證，並且除了模型 API 外不進行額外的網路連接。
每個背景工作階段都是其自己的 Claude Code 程序，由監督程序管理而不是與您的終端相關聯。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。
一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。記錄和狀態保留在磁碟上，下次您附加、查看或回覆時，監督程序從中斷的地方啟動新程序。當每個工作階段都完成且沒有終端連接時，監督程序本身退出，並在下次您需要它時再次啟動。
監督程序監視磁碟上已安裝的 Claude Code 二進位檔案，並在常規自動更新程序替換它後重新啟動到新版本。這是本地檔案監視，不是網路檢查。背景工作階段是分離的程序，因此它們在重新啟動期間繼續執行，新監督程序重新連接到它們。
狀態存儲位置
工作階段狀態存儲在您的 Claude Code 配置目錄下。如果您設定 CLAUDE_CONFIG_DIR，監督程序改用該目錄而不是 ~/.claude，並作為具有其自己工作階段的單獨實例執行。
| 路徑 | 內容 |
|---|---|
~/.claude/daemon.log |
監督程序日誌 |
~/.claude/daemon/roster.json |
執行中的背景工作階段列表，用於在重新啟動後重新連接 |
~/.claude/jobs/<id>/state.json |
在 agent view 中顯示的每個工作階段狀態 |
要在不直接讀取檔案的情況下檢查此狀態，請執行 claude daemon status。它報告監督程序是否可達、其程序 ID 和版本、socket 目錄，以及有多少背景工作階段處於活動狀態。/doctor 包含相同檢查的摘要。在 Windows 上，當 daemon 的 pipe-key 檔案被鎖定或無法讀取時，claude daemon status 會顯示基礎檔案錯誤，而不是報告通用連接失敗。
關閉 agent view
要完全關閉背景代理和 agent view，將 disableAgentView 設定設為 true 或設定 CLAUDE_CODE_DISABLE_AGENT_VIEW 環境變數。管理員可以通過受管設定強制執行此操作。
故障排除
claude agents 列出子代理而不是開啟代理檢視
如果 claude agents 列印計數後跟著您設定的子代理，然後退出，代理檢視在您的環境中不可用。較早的版本不會在每個環境中開啟代理檢視，包括透過 Bedrock、Vertex AI 或 Foundry 連接時。執行 claude update 以安裝最新版本。
如果更新後代理檢視仍未開啟，請檢查它是否已被設定或環境變數關閉。
Agent view 開啟時沒有工作階段
在您分派第一個工作階段之前，agent view 會顯示簡短的入門提示，並在工作階段清單的位置顯示範例提示。在底部的輸入框中輸入提示並按 Enter 以分派您的第一個工作階段。
無法開啟代理，因為背景工作正在執行
如果按 ← 將目前工作階段放在背景中顯示 Cannot open agents — N background task(s) running，工作階段有進行中的工作，例如子代理、工作流程或背景 shell 命令，快捷鍵不會無聲地放棄它。執行 /tasks 以查看正在執行的內容，然後執行 /bg 以確認放棄它們。請參閱從工作階段內部以了解背景化時哪些會轉移，哪些不會。
提示被拒絕為過短
分派輸入期望任務描述，而不是對話開場白。短於四個字元的提示會被拒絕並顯示 Too short 提示，以便隨意按鍵不會啟動工作階段。描述您希望工作階段執行的操作，例如 investigate the flaky checkout test。
工作階段在關閉後顯示為失敗
關閉或重新啟動您的機器會停止執行中的背景工作階段，因此當您下次開啟 agent view 時，它們會顯示為失敗。附加、查看或回覆任何工作階段，工作階段會從中斷的地方重新啟動。
睡眠單獨不會導致這種情況。工作階段在睡眠期間會被保留，監督程序在喚醒時會重新連接到它們。
附加後工作階段響應緩慢
一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序會停止其程序以釋放資源。附加會啟動從中斷的地方開始的新程序，這需要一些時間。正在工作或等待您的工作階段永遠不會以這種方式停止。
.claude/worktrees/ 正在填滿
在 agent view 中刪除工作階段會移除 Claude 為其建立的 worktree。claude rm 會保留具有未提交變更的 worktree 並列印其路徑。在專案目錄中使用 git worktree list 列出剩餘條目，並使用 git worktree remove <path> 移除每個。請參閱清理 worktrees。
限制
Agent view 是研究預覽版本，具有以下限制：
- 速率限制適用：背景工作階段與互動工作階段一樣消耗您的訂閱使用量，因此並行執行十個代理的使用配額速度快十倍。
- 工作階段是本地的：背景工作階段在您的機器上執行。它們在睡眠時保留，但如果機器關閉則停止。
- Claude 建立的 worktrees 在 agent view 中隨工作階段刪除：在刪除在其自己的 worktree 中編輯檔案的工作階段之前，合併或推送更改。
claude rm保留具有未提交更改的 worktree；您自己建立的 worktree 會保留在原位。
相關資源
如需了解在平行中執行 Claude 的其他方式，請參閱：
- 在平行中執行代理：比較 agent view 與 subagents、agent teams 和 worktrees
- Agent teams：協調相互傳遞訊息的多個工作階段
- Claude Code on the web：在受管雲環境中執行工作階段，而不是本地執行