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 Code 工作階段一樣。在空提示上按 ← 分離並返回表格。
帶入現有工作階段
要將您已開啟的工作階段移入 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
~/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 Opened PR with collision fix PR #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 工作階段在迭代之間休眠。該行顯示其執行計數和倒計時 |
PR #N 標籤是 工作階段開啟的拉取請求，不是狀態圖示的一部分。當工作階段開啟了多個拉取請求時，標籤會顯示計數，例如 3 PRs。
終端標籤標題在 agent view 開啟時顯示等待輸入計數：當工作階段需要輸入時為 2 awaiting input · claude agents，或當沒有工作階段需要輸入時為 claude agents。
背景工作階段不需要任何開啟的終端即可繼續工作。單獨的 監督程序 執行它們，因此您可以關閉 agent view、關閉 shell 或啟動新的互動工作階段，您分派的工作會繼續進行。
工作階段狀態通過自動更新和監督程序重新啟動在磁碟上持久化。工作階段也會在您的機器進入睡眠時保留。它們的程序在喚醒時恢復，監督程序會重新連接到它們，而不是將時間間隔視為閒置。關閉仍會停止執行中的工作階段；請參閱 工作階段在關閉後顯示為失敗 以了解如何恢復它們。
行摘要
每行中的單行摘要由 Haiku-class 模型 生成，因此該行可以告訴您工作階段正在做什麼、需要什麼或生成了什麼，無需開啟記錄。當工作階段主動工作時，摘要最多每 15 秒刷新一次，加上每個回合結束時刷新一次。
從 v2.1.161 開始，當工作階段執行兩個或更多平行工作項目時，例如 subagents、背景 shell 命令或監視器，done/total 計數（例如 2/5）會出現在摘要文字之前。
每次刷新都是通過您的正常提供者的一個簡短 Haiku-class 請求，按照與工作階段本身相同的 資料使用條款 計費和處理。在第三方提供者（例如 Bedrock、Vertex AI、Microsoft Foundry 和自訂閘道）上，當未配置 Haiku 模型時，請求會回退到工作階段的主要模型。設定 ANTHROPIC_DEFAULT_HAIKU_MODEL 以在這些提供者上為這些摘要選擇模型。
拉取請求狀態
當工作階段開啟拉取請求時，PR #1234 標籤會出現在該行的右邊緣，在支援超連結的終端中連結到拉取請求。當您向工作階段發送後續訊息時標籤會保留，因此拉取請求在該行恢復為即時進度時保持可見。
當工作階段開啟了多個拉取請求時，標籤會顯示計數，例如 3 PRs，按最需要關注的開啟拉取請求著色。開啟 查看面板 以查看它們全部。
拉取請求編號按其狀態著色：
| 顏色 | 拉取請求狀態 |
|---|
| 黃色 | 等待檢查或審查，或檢查失敗 |
| 綠色 | 檢查通過且沒有審查阻止 |
| 紫色 | 已合併 |
| 灰色 | 草稿或已關閉 |
查看和回覆
在選定的行上按 Space 開啟查看面板。它顯示工作階段需要您提供什麼、其最近的輸出以及它開啟的任何拉取請求。大多數時候這就足夠了，您永遠不需要開啟完整記錄。
從 v2.1.161 開始，當工作階段執行平行工作項目時，面板也會命名執行時間最長的項目及其執行時間，因此您可以看到工作階段在等待什麼，而無需附加。
在查看面板中輸入回覆並按 Enter 將其發送到該工作階段。當工作階段詢問多選問題時，查看面板顯示選項，您可以按數字鍵選擇一個。對於其他被阻止的工作階段，按 Tab 用建議的回覆填充輸入，您可以在發送前編輯。使用 ! 前綴回覆以發送 Bash 命令。
啟用 語音聽寫 後，在回覆輸入有焦點時按住或點擊您的推送通話鍵以聽寫回覆，而不是輸入。同樣的方式也適用於 agent view 底部的分派輸入。
使用 ↑ 和 ↓ 查看相鄰工作階段而無需關閉面板，或按 → 附加。
附加到工作階段
在選定的行上按 Enter 或 → 附加。Agent view 被完整的互動工作階段替換。附加時，Claude 發佈您離開時發生的簡短回顧。
附加時，工作階段的行為與任何其他 Claude Code 工作階段相同：每個 命令、快捷鍵和功能都有效。
附加的工作階段始終以 全螢幕模式 呈現，無論您的 tui 設定如何，因為背景工作階段沒有終端滾動回溯可附加。使用 PgUp、PgDn 或滑鼠滾輪滾動，並按 Ctrl+O 進入記錄模式。您終端的原生滾動和 tmux 複製模式只顯示當前視口，與執行任何全螢幕應用程式時相同。
在空提示上按 ← 分離並返回 agent view。如果對話框有焦點且不響應 ←，按 Ctrl+Z 立即分離。
Ctrl+C 在附加時保持其標準中斷行為：它取消執行中的回應或 ! shell 命令，而不是分離。在空提示上按 Ctrl+C 兩次會分離，與任何工作階段中相同。
分離永遠不會停止背景工作階段：←、Ctrl+Z、/exit 和雙 Ctrl+C 或雙 Ctrl+D 都會讓它繼續執行。要從內部結束工作階段，執行 /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 並在其中啟動工作階段的會保留在原地。對話記錄會保留在您的本機上，並且仍然可以通過 claude --resume 存取。
較舊的已完成工作階段摺疊為 … N more 行以保持列表簡短。失敗和具有開啟拉取請求的工作階段始終保持可見。
篩選工作階段
在分派輸入中輸入以篩選而不是分派：
| 篩選 | 顯示 |
|---|
a:<name> | 執行命名代理的工作階段 |
s:<state> | 給定狀態中的工作階段，例如 s:working。也接受 s:blocked 表示等待您的所有工作階段 |
#<number> 或 PR URL | 在該拉取請求上工作的工作階段 |
| 任何其他 URL | 其第一個提示包含該 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 的目錄下的存儲庫以在那裡執行工作階段 |
/<command> | 建議 skills 和 commands 作為提示分派 |
! <command> | 執行 shell 命令作為背景工作而不是啟動 Claude 工作階段。該工作顯示為一行，您可以附加到、監視和分離 |
#<number> 或拉取請求 URL | 如果工作階段已在該 PR 上工作，選擇它而不是分派 |
Shift+Enter | 分派並立即附加到新工作階段 |
/exit 和 /quit 關閉 agent view，/logout 將您登出。所有其他命令和 skill 都作為新背景工作階段的第一個提示發送。
將重複任務打包為 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，以在分派前發送一個額外的指令。如果 Claude 在您執行 /bg 時正在回應，回應會在背景工作階段中繼續。
從互動工作階段背景化會啟動一個新的進程，該進程從保存的對話恢復，因此執行 subagents、monitors 和背景命令不會轉移到它。當任何正在執行時，Claude 會要求您在背景化前確認。進入背景後，工作階段可以啟動新的 subagents、monitors 和背景命令，這些命令在稍後分離和重新附加時保持執行。
來自原始啟動的配置標誌會傳遞到背景化工作階段，因此其 MCP servers、settings 和備用模型保持有效：
--mcp-config 和 --strict-mcp-config--settings--add-dir--plugin-dir--fallback-model--allow-dangerously-skip-permissions
您在工作階段期間使用 /add-dir 新增的目錄也會傳遞。
傳遞 --allow-dangerously-skip-permissions 會在背景化工作階段中保持 bypassPermissions 可達，但它不會授予任何新的權限。該模式仍然需要在任何工作階段使用它之前進行相同的一次性互動接受，如 Permission mode, model, and effort 中所述。
從您的 shell
傳遞 --bg 啟動直接進入背景的工作階段：
claude --bg "investigate the flaky SettingsChangeDetector test"
--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"
--name 時，名稱會出現在短 ID 之後：
backgrounded · 7c5dcf5d · flaky-test-fix
claude agents list sessions
claude attach 7c5dcf5d open in this terminal
claude logs 7c5dcf5d show recent output
claude stop 7c5dcf5d stop this session
執行 shell 命令
要執行 shell 命令作為背景工作而不是 Claude 工作階段，請在 agent view 分派輸入的第一個字符中輸入 !。! 顯示為前綴，您在其後輸入的所有內容都是命令。以下示例從 agent view 輸入框分派 pytest -x：
按 Enter 啟動工作。相同的工作也可以直接從您的 shell 使用 --exec 啟動：
claude --bg --exec 'pytest -x'
Space 以在不附加的情況下查看，或從您的 shell 執行 claude logs <id>。捕獲的輸出保留在記憶體中，不寫入磁碟。該行及其輸出在命令退出後約五分鐘自動清理，因此如果您需要結果，請在那之前讀取它。
檔案編輯如何隔離
每個背景工作階段，無論是從 agent view、/bg 或 claude --bg 啟動，都在您的工作目錄中啟動。編輯檔案前，Claude 將工作階段移動到 .claude/worktrees/ 下的隔離 git worktrees 中，因此並行工作階段可以讀取相同的檢出，但每個都寫入自己的。
Claude 在以下情況下跳過 worktree：
- 工作階段已在連結的 git worktree 內，無論 Claude 是在
.claude/worktrees/ 下建立它，還是您使用 git worktree add 在其他地方建立它
- 工作目錄不是 git 存儲庫且沒有配置
WorktreeCreate hook
- 寫入在工作目錄外
要為 git worktrees 不實用的存儲庫關閉 worktree 隔離，請將 worktree.bgIsolation 設定為 "none"。背景工作階段隨後直接編輯您的工作副本，無需先移動到 worktree。將設定新增到專案的 .claude/settings.json：
{
"worktree": {
"bgIsolation": "none"
}
}
worktree.bgIsolation 設定需要 Claude Code v2.1.143 或更新版本。
WorktreeCreate hook，Claude 會以與 git 相同的方式隔離編輯。
在 agent view 中刪除工作階段（Ctrl+X 兩次）會移除 Claude 為其建立的 worktree，包括任何未提交的更改，因此在刪除前合併或推送您想保留的更改。從 shell 使用 claude rm 刪除會保留具有未提交更改的 worktree 並列印其路徑，以便您可以自己清理它。您自己建立並在其中啟動工作階段的 worktree 無論如何都會保留在原位。
要找到工作階段的 worktree 路徑，查看工作階段或附加並檢查其工作目錄。
subagent 背景工作階段生成的會繼承工作階段的工作目錄，因此其檔案編輯會進入工作階段的 worktree 而不是您的工作副本。要給 subagent 其自己的單獨 worktree，請在其 frontmatter 中設定 isolation: worktree 或在生成它時傳遞 isolation: "worktree"。
設定模型
agent view 標題中顯示的模型名稱是分派預設值。您從輸入啟動的新工作階段使用此模型，這來自您使用者設定中的 model setting。通過在 /model picker 中選擇模型來設定它，或直接編輯設定。要為整個 agent view 工作階段覆蓋它，請在開啟 agent view 時傳遞 --model。請參閱 Permission mode, model, and effort。
每個背景工作階段可以在不同的模型上執行。要為一個工作階段覆蓋它：
- 從 shell，使用
claude --bg 傳遞 --model。
- 附加到執行中的工作階段，開啟
/model，並在模型上按 s 以僅為該工作階段切換。如果工作階段被重新生成，更改會持續。
- 分派一個 subagent，其 frontmatter 設定
model 欄位。
Permission mode, model, and effort
背景工作階段從它執行的目錄讀取其 settings，就像您在那裡啟動了 claude 一樣。
permission mode 取決於您如何啟動工作階段。使用 /bg 或 ← 背景化現有工作階段會保持當前權限模式，因此您切換到 acceptEdits 或 auto 的工作階段在分離後仍保持該模式。從 agent view 輸入分派或從 shell 執行 claude --bg 使用該目錄設定中的 defaultMode，或分派的 subagent 的 frontmatter 中的 permissionMode。
背景工作階段啟動時的權限模式、模型和努力，以及它攜帶的 configuration flags，在監督者稍後 stops and restarts 其進程時都會持續。您使用 claude --bg --dangerously-skip-permissions 或 claude --bg --permission-mode bypassPermissions 啟動的工作階段在該重新啟動後保持 bypassPermissions，而不是回退到目錄的 defaultMode，並且您使用 /model 或 /effort 在工作階段中途更改的模型或努力會被保留。
要為您從 agent view 分派的每個工作階段設定預設值，請在開啟它時傳遞 --permission-mode、--model、--effort 或 --agent 中的任何一個：
claude agents --permission-mode plan --model opus --effort high
--agent 設定 subagent，當分派提示未使用 @name 或作為第一個單詞命名時使用。如果設定了 agent setting，則預設為該設定，否則為內建的全能 claude 代理。在分派輸入中命名 subagent 會覆蓋兩者。
claude agents 也接受 --dangerously-skip-permissions 作為 --permission-mode bypassPermissions 的簡寫，以及 --allow-dangerously-skip-permissions 以在每個分派工作階段的 Shift+Tab 循環中提供 bypassPermissions，而不是以該模式啟動。兩者都與 top-level CLI flags 相符。
這些標誌在各個版本中新增。較早的版本會以未知選項錯誤拒絕它們。
| 標誌或設定 | 最低版本 |
|---|
--permission-mode、--model、--effort、--dangerously-skip-permissions | v2.1.142 |
--allow-dangerously-skip-permissions | v2.1.143 |
--agent 和尊重分派工作階段的 agent 設定 | v2.1.157 |
agent 設定並分派內建的 claude 代理。
活動預設值出現在分派輸入下方的頁腳中。
沒有這些標誌，工作階段使用該目錄設定中的 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 agents --json | 將即時工作階段列印為 JSON 陣列並結束：每個即時工作階段，加上仍在執行或被阻止的背景工作階段，即使其程序已結束。新增 --all 以同時包含已完成的背景工作階段。每個項目都有 cwd、kind 和 startedAt。背景項目也有 id（可與 claude attach/logs/stop 搭配使用）和 state：working、blocked、done、failed 或 stopped 之一。pid 和 status 僅在程序執行時出現，加上當 status 為 waiting 時的 waitingFor，其說明工作階段被阻止的原因，例如 permission prompt 或 input needed；sessionId 和 name 在設定時出現。與 --cwd <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 --resume 繼續使用 |
claude daemon status | 列印 supervisor 的狀態、版本、socket 目錄和 worker 計數 |
claude daemon stop --any | 停止 supervisor 程序及其託管的背景工作階段。傳遞 --keep-workers 以保持背景工作階段執行中，以便下一個 supervisor 可以重新連接到它們。下一個 claude agents 或 claude --bg 會啟動全新的 supervisor |
背景工作階段如何被託管
agent view 中列出的每個工作階段都被視為背景工作階段，無論您目前是否連接到它。相比之下，直接執行 claude 啟動的工作階段與該終端相關聯，並在終端關閉時結束，除非您將其發送到背景。
監督程序
背景工作階段由每個使用者的監督程序託管，與您的終端和 agent view 分開。監督程序在您第一次背景化工作階段或開啟 agent view 時自動啟動，您不直接管理它。
監督程序及其工作階段使用與互動工作階段相同的認證進行身份驗證，並且除了模型 API 外不進行額外的網路連接。
每個背景工作階段都是其自己的 Claude Code 程序，由監督程序管理而不是與您的終端相關聯。正在主動工作、等待您的輸入或已連接終端的工作階段保持其程序執行。執行中的背景 shell 命令、子代理、動態工作流程或監視器計為主動工作，因此長時間執行的程序（例如開發伺服器）會保持工作階段活躍。
一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序停止其程序以釋放資源。您使用 Ctrl+T 釘選的工作階段不受此限制，在閒置時保持其程序執行。無論如何，文字記錄和狀態保留在磁碟上，下次您附加、查看或回覆已停止的工作階段時，監督程序從中斷的地方啟動新程序。當每個工作階段都完成且沒有終端連接時，監督程序本身退出，並在下次您需要它時再次啟動。
按下 ← 留下的空白列，從未被給予提示，會在約五分鐘後被完全移除，以便列表自動清除。使用 claude --bg 啟動的工作階段和等待設定提示（例如信任對話）的工作階段不會以這種方式被移除。
當主機記憶體不足時，監督程序首先停止閒置的未釘選工作階段，只有在釋放任何資源時才停止閒置的釘選工作階段。
監督程序監視磁碟上已安裝的 Claude Code 二進位檔案，並在常規自動更新程序替換它後重新啟動到新版本。這是本地檔案監視，不是網路檢查。背景工作階段是分離的程序，因此它們在重新啟動期間繼續執行，新監督程序重新連接到它們。閒置的釘選工作階段也會就地重新啟動到新版本，以便它在您不重新附加的情況下獲取更新。
狀態存儲位置
工作階段狀態存儲在您的 Claude Code 配置目錄下。如果您設定 CLAUDE_CONFIG_DIR，監督程序改用該目錄而不是 ~/.claude，並作為具有其自己工作階段的單獨實例執行。
| 路徑 | 內容 |
|---|
~/.claude/daemon.log | 監督程序日誌 |
~/.claude/daemon/roster.json | 執行中的背景工作階段列表，用於在重新啟動後重新連接 |
~/.claude/jobs/<id>/state.json | 在 agent view 中顯示的每個工作階段狀態 |
~/.claude/jobs/<id>/tmp/ | 每個工作階段的暫存目錄。寫入此處不會提示權限。工作階段刪除時移除 |
CLAUDE_JOB_DIR 環境變數，指向其 ~/.claude/jobs/<id> 目錄，因此工作階段執行的 shell 命令可以將臨時檔案寫入 $CLAUDE_JOB_DIR/tmp，而不會與平行工作階段衝突。
要在不直接讀取檔案的情況下檢查此狀態，請執行 claude daemon status。它報告監督程序是否可達、其程序 ID 和版本、socket 目錄，以及有多少背景工作階段處於活動狀態。/doctor 包含相同檢查的摘要。在 Windows 上，當 daemon 的 pipe-key 檔案被鎖定或無法讀取時，claude daemon status 會顯示基礎檔案錯誤，而不是報告通用連接失敗。
該命令也會在執行中的監督程序版本與您叫用的 claude 版本不同時發出警告，這會在監督程序尚未重新啟動到新版本的更新後發生。警告會顯示兩個版本，並告訴您執行 claude daemon stop --any 以採用新版本。當 Claude Code 安裝為作業系統服務時，建議的命令是 claude daemon stop，不帶該旗標。
關閉 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 still running in the background，工作階段有進行中的工作，例如子代理、動態工作流程或背景 shell 命令，快捷鍵不會無聲地放棄它。執行 /tasks 以查看正在執行的內容，然後執行 /bg 以確認放棄它們。請參閱從工作階段內部以了解背景化時哪些會轉移，哪些不會。
提示被拒絕為過短
分派輸入期望任務描述，而不是對話開場白。短於四個字元的提示會被拒絕並顯示 Too short 提示，以便隨意按鍵不會啟動工作階段。描述您希望工作階段執行的操作，例如 investigate the flaky checkout test。
工作階段在關閉後顯示為失敗
關閉或重新啟動您的機器會停止執行中的背景工作階段，因此當您下次開啟 agent view 時，它們會顯示為失敗。附加、查看或回覆任何工作階段，工作階段會從中斷的地方重新啟動。
睡眠單獨不會導致這種情況。工作階段在睡眠期間會被保留，監督程序在喚醒時會重新連接到它們。
Agent view 表示背景服務未回應
如果附加、查看或 claude logs 報告背景服務未回應，監督程序可能已停止回應。停止它並讓下一個 claude agents 啟動新的程序。若要在重新啟動期間保持背景工作階段執行，請傳遞 --keep-workers：
claude daemon stop --any --keep-workers
--keep-workers，該命令也會結束背景工作階段。--any 旗標確認您想要停止按需啟動的監督程序，而不是作為已安裝的服務啟動的程序，這是預設值。
在 Windows 上，如果監督程序未回應停止請求，該命令會列印其程序 ID。使用 taskkill /PID <pid> 結束該程序以完成復原。當您傳遞 --keep-workers 時，背景工作階段仍會被保留。
背景工作階段無法在 macOS 上讀取 Desktop、Documents 或 Downloads
在 macOS 上，背景工作階段主機作為其自己的程序執行，並與您的終端分開請求對受保護資料夾的存取。如果背景工作階段在讀取 ~/Desktop、~/Documents、~/Downloads 或其他受保護位置時報告 Operation not permitted，請在系統設定中的隱私與安全性 > 檔案和資料夾下授予存取權限，或為該項目啟用完整磁碟存取。
使用原生安裝程式，該項目會顯示為 Claude Code，授予的權限在更新後會保留。使用其他安裝方法（例如 Homebrew 或 npm），該項目會顯示二進位檔路徑，更新後可能需要再次授予。
工作階段在附加後響應緩慢
一旦工作階段完成並在未附加的情況下閒置約一小時，監督程序會停止其程序以釋放資源。附加會啟動從中斷的地方開始的新程序，這需要一些時間。正在工作、等待您或釘選的工作階段不會以這種方式停止，因此使用 Ctrl+T 釘選工作階段以保持其回應性。
.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 的其他方式，請參閱：
