如何使用 Dynamic Workflows 在 Claude Code 中啟動數百個代理

在 Ailoot 說明文件 中尋找更多工具設定相關資料。

什麼是 Dynamic Workflows？Anthropic 為什麼在 5 月 28 日推出它？#

過去，這種形式本身限制了規模：一個對話 = 一個計畫 = 一個上下文視窗。子代理雖然有所幫助，但「接下來要執行什麼」仍由主對話中的 Claude 決定，而且每一項中間結果都會占用同一個上下文。當任務涉及 500 個檔案或十個互不相關的假設時，這就成了瓶頸。

Dynamic Workflows 將計畫移入程式碼。Claude 會把任務編寫成編排指令碼，執行環境則在隔離環境中執行該指令碼；中間結果會存放在指令碼的變數中，而不是你的上下文裡。代理在背景工作時，工作階段仍能維持回應。

相較於舊方法，實際改變之處是：彼此獨立的代理會質疑彼此的發現，只有通過交叉核對的內容才會送到你面前。名稱中的「動態」正是指這一點：每次執行都會依照當下的任務撰寫，並沒有預先準備好的程序清單。

Workflow、子代理和 Skill 有何不同：3 種編排方式#

我會用兩個問題來決定使用 workflow、子代理還是 Skill：誰掌握計畫？中間結果存放在哪裡？

主要轉變是把計畫移入程式碼。使用子代理和 Skills 時，Claude 始終是編排者：它會一路決定接下來要啟動什麼，每次返回的結果也都會進入上下文視窗。Workflow 則把迴圈、分支和中間結果保留在自身內部；只有最終答案會傳回 Claude。

你可以執行同一項計畫，讓彼此獨立的代理從不同角度拆解問題，再由指令碼整合經得起檢驗的內容。一般只透過單一對話執行一輪做不到這一點：Claude 沒有獨立的綜合判斷點。

我的選擇方式如下：例行且包含幾個步驟的任務，使用子代理或 Skill。無法在一次對話中完成，或你想按需重新執行的流程，則使用 workflow。我在核心指南 Skills、子代理、MCP 或 Plugins 中詳細介紹了全部四種基本元件。

在 Claude Code 中啟動 Workflow 的 3 種方式#

方法 1。在提示詞中加入 workflow 關鍵字。 這是最簡單的選項，不會變更工作階段設定。只要在任何提示詞中加入 workflow 一詞，Claude Code 就會在你輸入時標示出來，並產生編排指令碼，而不是進行一般對話。

Run a workflow to audit every API endpoint under src/routes/ for missing auth checks

如果 Claude Code 標示出這個詞，但你並不是要啟動 workflow，按下 alt+w 就能停用這次提示詞的觸發功能。

方法 2。/effort ultracode 模式。 這會啟用模型最高的推理力度（xhigh），也讓 Claude 自行判斷任務是否適合使用 workflow。

/effort ultracode

在此模式下，一項要求可能依序展開成多個 workflow：一個用來理解程式碼，另一個用來進行變更，第三個則用來檢查結果。每次執行都比一般 effort 等級消耗更多 token、花費更長時間。此模式只適用於目前的工作階段，開啟新工作階段時會重設。回到例行工作時，使用 /effort high 即可關閉 ultracode。

方法 3。內建的 /deep-research 指令。 這是 Anthropic 為網路研究提供的現成 workflow。下一節會介紹這種方式。

使用上述三種方式時，Claude Code 都會在第一次執行時要求確認，並顯示階段清單。可選的回應包括 Yes, run it（是，執行）、Yes, and don't ask again for <name>（是，不要再詢問 <name>），這會記住你的核准；View raw script（檢視原始指令碼，可用 Ctrl+G 開啟程式碼）；以及 No（否）。在 Auto 模式下，只需在第一次執行時確認，之後就會直接執行，不再詢問。使用 claude -p 和 Agent SDK 時則完全不會要求確認：子代理權限會改用共用允許清單中的設定。

現成的 /deep-research Workflow：首次執行範例#

試用 Dynamic Workflows 最快的方法，是執行現成 workflow，而不是自行撰寫。Anthropic 在 Claude Code 中內建了 /deep-research workflow。它會從幾個互相獨立的角度探討問題、找出來源、針對每項主張進行投票，並只將通過交叉核對的主張保留在報告中。

1. 執行指令

   在 Claude Code 工作階段中輸入 /deep-research，並用詳細提示詞說明你的問題。措辭愈精確，指令碼就愈不會浪費時間啟動多餘階段。

2. 允許 Workflow 執行

   對話框會顯示各個階段，以及 Yes / View raw script / No 按鈕。若你選擇含有 don't ask again 的選項，核准會儲存到此專案。

3. 使用 /workflows 查看進度

   執行工作會轉到背景進行，讓工作階段保持可用。/workflows 指令會顯示執行中和已完成的工作清單。使用方向鍵選取階段，按 Enter 展開並查看其代理，按 j/k 捲動檢視詳細資訊，按 p 暫停，按 x 停止工作，按 r 重新啟動代理，按 s 儲存指令碼。

4. 閱讀報告

   執行完成後，附有連結的報告會出現在工作階段中。沒有通過交叉核對的主張會自動篩除。

與一般聊天中只進行一次網路搜尋不同，/deep-research 會自行平行處理查詢，並調和不同來源之間的衝突。我會在撰寫指南前用它探索主題，這是了解 token 用量、評估擴大 workflow 前的便利方式。

Ultracode：由 Claude 決定何時啟動 Workflow 的模式#

Ultracode 結合了兩件事：最高的推理力度，以及允許 Claude 自行啟動 workflow。預設情況下，即使使用 /effort xhigh，執行的仍是一般對話：Claude 會思考更久，但步驟仍保留在自己的上下文中。Ultracode 則允許 Claude 一旦發現某項任務無法在一次工作階段中完成，就自行將它轉成 workflow。

/effort ultracode

啟用此模式後，一項要求可能接連啟動兩或三個 workflow：一個檢查程式碼庫，另一個進行變更，第三個則是獨立執行，嘗試證明該變更有問題。這仍是「多次獨立嘗試 ⇒ 最終綜合」的模式，但你不必再手動啟動每個階段。

代價很明顯：每項要求花費的時間和費用都比使用 /effort high 更多。在幕後，數次執行會各自受限；Anthropic 本身也不建議將 ultracode 設為預設模式。此模式只適用於目前的工作階段，並會在下一個工作階段重設。

回到例行工作時，使用 /effort high 關閉 ultracode，工作階段就會回到使用子代理的一般聊天。在不支援 xhigh 的模型上，/effort 中不會出現 ultracode 選項。

限制、Token 用量與首次執行的常見問題#

執行環境設有以下硬性技術限制：

• 同時最多執行 16 個代理。 核心數較少的機器可執行數量會更少。這是本機資源預算限制。
• 每次執行最多 1,000 個代理。 這是防止迴圈失控的保護措施：如果指令碼開始無止盡地啟動代理，執行環境就會將它關閉。
• 執行期間無法等待使用者輸入。 只有工具權限可以暫停執行。如果你需要在不同階段之間核准，就將工作拆成多個 workflow。
• 指令碼本身無法直接存取檔案或命令殼層。 讀取、寫入和執行命令都由它啟動的代理負責。指令碼只負責協調它們。
• 需要 Claude Code v2.1.154 或更新版本。 Pro、Max、Team 和 Enterprise 皆可使用（Pro 需透過 /config 啟用），Claude API、Amazon Bedrock、Vertex AI 和 Microsoft Foundry 也都支援。

主要提醒是成本。

除非指令碼將某個階段導向其他模型，否則執行中的每個代理都會使用工作階段的模型。在大型執行前，先查看 /model：如果你習慣在例行任務時切換到較便宜的模型，漏掉這項檢查可能會讓 ultracode 和 /deep-research 增加帳單。你可以在提示詞中明確要求 Claude「在不需要最高能力的階段使用較便宜的模型」，這是有效的成本管理方式。

如果執行偏離方向，開啟 /workflows、選取該次執行，再按 x。已完成的代理會保留結果。你可以直接按 p 接續已停止的執行，或要求 Claude 從同一位置重新啟動指令碼：已快取的代理會回傳結果，其他代理則會繼續即時工作。這只在同一工作階段中有效：離開 Claude Code 後，下個工作階段會從頭開始執行 workflow。

如果你計畫長時間執行，請參考指南如何避免耗盡 Claude Code 額度和 Second Brain，開始管理用量：有了適當的專案結構，workflow 就不必把整個儲存庫載入每個代理。

如何在專案中儲存 Workflow#

如果 Claude 已為重複性任務（例如檢查每個分支或定期進行安全稽核）建立 workflow，你可以儲存該指令碼，就不必每次都用文字重新描述任務。

1. 開啟 /workflows

   此指令會顯示近期執行清單。使用方向鍵選取需要的項目。

2. 按 s

   儲存對話框會出現。按 Tab 切換儲存位置。

3. 選擇資料夾

   .claude/workflows/ 位於專案中，複製儲存庫的每個人都看得到。~/.claude/workflows/ 位於你的家目錄，在所有專案中都能使用，只有你看得到。

4. 將它當作指令呼叫

   /[script_name] 會使用與第一次相同的指令碼啟動 workflow。如果專案資料夾和家目錄中有同名 workflow，會優先使用專案中的版本。

這會形成一種有趣的模式：團隊中的某個人先讓 workflow 成功執行，再將它提交到 .claude/workflows/，接著每位團隊成員都能透過指令執行相同的編排。這是可讀的 JavaScript，因此你可以檢視、編輯並提交新版本。

在專案中第一次執行已儲存的 workflow 時，Claude Code 仍會顯示權限對話框，因此儲存指令碼並不會自動核准它。你必須另外選擇 Yes, and don't ask again 才能核准。

哪些任務適合使用 Workflows？#

Anthropic 明確列出這個執行環境的適用情境：

• 橫跨整個程式碼庫的稽核——依照檢查清單檢查每個端點、檔案和函式。例如，檢查是否缺少驗證機制、找出重複邏輯，或依照 OWASP 規則進行安全稽核。每個檢查清單項目都會啟動一個獨立代理。
• 大型遷移——更換框架、移除已棄用的 API，或將數千個檔案移植到另一種語言。workflow 會追蹤進度，代理會平行處理檔案，而交叉核對代理則負責找出遺漏之處。
• 需要交叉核對的研究——需要從不同角度查找來源的問題，以及評估哪些主張能通過交叉核對。這是內建 /deep-research 的基本適用情境。
• 想從多個獨立角度擬定的複雜計畫——workflow 會產生數份彼此獨立的計畫草案，由立場相反的代理審查，再交付綜合結果。適用於「出錯代價高，而且一次執行還不夠」的情況。

若任務只是「修正一個錯誤」或「新增一個函式」，Dynamic Workflows 就不如一般工作階段：消耗的 token 不值得花時間。Anthropic 的說明文件清楚指出這一點：「先從範圍較小的任務開始，了解它的用量。」我的原則是：若互相獨立的子任務少於 5 個，或檔案少於 50 個，使用搭配幾個子代理的一般聊天會更省成本。

如果你在 Enterprise 方案中負責帶領團隊，管理員可能已透過受管理設定或 Claude Code 管理頁面上的開關停用了 Workflows。在把它當成「萬用解決方案」之前，先確認它是否已啟用：/config → Dynamic workflows 項目。

在 Ailoot 說明文件 中尋找更多工具使用資料。