Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Agent view（使用 claude agents 開啟）是所有背景工作階段的一個螢幕：什麼正在執行、什麼需要您的輸入，以及什麼已完成。分派新工作階段，一目瞭然地查看它們的狀態，而不是滾動瀏覽記錄，並且只在需要時才介入。每個背景工作階段都是一個完整的 Claude Code 對話，在沒有終端連接的情況下持續執行，因此您可以隨時開啟、回覆和離開。
當您有多個獨立任務 Claude 可以在不需要您監看每一步的情況下執行時，請使用 agent view。分派一個錯誤修復、一個拉取請求審查和一個不穩定測試調查作為三行，在另一個視窗中繼續工作，並在某一行顯示需要您或有結果時檢查。
當您想在任何代理的工作階段中更直接地工作時，附加到該行以進入完整對話。
若要比較 agent view 與 subagents、agent teams 和 worktrees，請參閱 平行執行代理。
Agent view 是研究預覽版本，需要 Claude Code v2.1.139 或更新版本。使用 claude --version 檢查您的版本。隨著功能的發展，介面和快捷鍵可能會改變。
快速開始
本逐步解說涵蓋核心 agent view 迴圈：分派工作、觀看其列更新（Claude 正在工作）、查看以檢查並回覆，以及附加到完整對話。您分派的工作階段在關閉 agent view 後會繼續執行，因此您可以離開並稍後返回。
開啟 agent view
從您的 shell，執行：Agent view 開啟，底部有輸入框，隨著工作階段啟動，表格會填入。隨時按 Esc 返回您的 shell。您的工作階段在您離開時繼續執行，下次開啟 agent view 時會重新出現。 分派工作階段
輸入描述工作的提示並按 Enter。新的背景工作階段在該工作上啟動並顯示為一列，顯示它是否正在工作、等待您或已完成。新工作階段使用 agent view 標題中顯示的模型和在該目錄中執行 claude 時會獲得的相同權限模式。您在此輸入的每個提示都會啟動自己的新工作階段。輸入另一個提示並按 Enter 會在第一個工作階段旁邊啟動第二個工作階段，而不是向其發送後續訊息。您可以以這種方式並行執行多個工作階段。每個工作階段獨立使用您的訂閱配額，因此在一次分派許多工作階段之前，請參閱限制。 查看和回覆
使用箭頭鍵選擇一列，然後按 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。您在其他終端中開啟的互動工作階段在您 背景化它們 之前不會出現。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 工作階段在迭代之間休眠。該行顯示其執行計數和倒計時 |
claude respawn --all 重新啟動它們。
行摘要
每行中的單行摘要由 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，預先選擇該工作階段，因此您可以在不離開終端的情況下切換工作階段。您可以在 /config 中關閉此快捷鍵。
組織列表
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 中移除工作階段並清理其 worktree，包括其中的任何未提交的更改，因此在刪除前推送或提交您想保留的工作。對話記錄保留在磁碟上，並通過 claude --resume 保持可用。
較舊的已完成工作階段摺疊為 … 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 | 在您的 $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 | 分派並立即附加到新工作階段 |
@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 和背景命令，這些命令在稍後分離和重新附加時保持執行。
從 shell
傳遞 --bg 啟動直接進入背景的工作階段：
claude --bg "investigate the flaky SettingsChangeDetector test"
--bg 與 --agent 結合：
claude --agent code-reviewer --bg "address review comments on PR 1234"
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/worktrees/ 下、工作目錄不是 git 存儲庫或寫入工作目錄外時，Claude 會跳過此操作。
在 git 存儲庫外，工作階段直接寫入工作目錄，彼此之間不隔離，因此避免分派編輯相同檔案的並行工作階段。
當您刪除工作階段時，worktree 被移除，因此在刪除前合併或推送您想保留的更改。要找到工作階段的 worktree 路徑，查看工作階段或附加並檢查其工作目錄。
要使 subagent 始終在其自己的 worktree 中執行，無論如何啟動，請在其 frontmatter 中設定 isolation: worktree。
設定模型
agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型，這與 /model 在任何工作階段中控制的設定相同。要為整個 agent view 工作階段覆蓋它，請在開啟 agent view 時傳遞 --model。請參閱權限模式、模型和努力。
每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它：
- 從 shell，使用
claude --bg 傳遞 --model。
- 附加到執行中的工作階段並在那裡執行
/model。如果工作階段被重新生成，更改會持續。
- 分派一個 subagent，其 frontmatter 設定
model 欄位。
權限模式、模型和努力
分派的工作階段從它執行的目錄讀取其 settings 和 permission mode，就像您在那裡啟動了 claude 一樣。
要為您從 agent view 分派的每個工作階段設定預設值，請在開啟它時傳遞 --permission-mode、--model 或 --effort 中的任何一個：
claude agents --permission-mode plan --model opus --effort high
defaultMode 或分派的 subagent 的 frontmatter 中的 permissionMode，以及 agent view 標題中顯示的模型。
使用 bypassPermissions 或 auto 被拒絕，直到您通過以互動方式運行 claude 接受該模式，因為這些模式讓您未監視的工作階段無需批准即可行動。無論您是將模式傳遞給 claude agents 還是 claude --bg --permission-mode，同樣的規則也適用。
Settings、plugins 和 MCP servers
Agent view 接受與 claude 相同的配置標誌，用於載入 settings、plugins、MCP servers 和額外目錄。每個標誌適用於 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 attach <id> | 在此終端中附加到工作階段 |
claude logs <id> | 列印工作階段的最近輸出 |
claude stop <id> | 停止工作階段。也接受 claude kill |
claude respawn <id> | 重新啟動已停止的工作階段，保持其對話完整 |
claude respawn --all | 重新啟動每個已停止的工作階段 |
claude rm <id> | 從列表中移除工作階段。如果沒有未提交的變更，會清理其 worktree |
背景工作階段如何被託管
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 中顯示的每個工作階段狀態 |
關閉 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。
機器喚醒後工作階段顯示為已停止
背景工作階段不能在睡眠或關閉後存活。附加、查看或回覆任何已停止的工作階段，它會從中斷的地方重新啟動。要一次重新啟動所有工作階段，執行 claude respawn --all。
附加後工作階段響應緩慢
一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。附加啟動從中斷的地方開始的新程序，這需要一些時間。正在工作或等待您的工作階段永遠不會以這種方式停止。
.claude/worktrees/ 正在填滿
當您刪除建立 worktrees 的工作階段時，worktrees 會被移除。如果工作階段在沒有清理的情況下結束，在專案目錄中使用 git worktree list 列出剩餘條目，並使用 git worktree remove <path> 移除每個。請參閱清理 worktrees。
Agent view 是研究預覽版本，具有以下限制：
- 速率限制適用：背景工作階段與互動工作階段一樣消耗您的訂閱使用量，因此並行執行十個代理的使用配額速度快十倍。
- 工作階段是本地的：背景工作階段在您的機器上執行，如果它進入睡眠或關閉則停止。
- Worktrees 隨工作階段刪除：在刪除在其自己的 worktree 中編輯檔案的工作階段之前，合併或推送更改。
相關資源
如需了解在平行中執行 Claude 的其他方式，請參閱：
