使用動態工作流程大規模協調子代理

動態工作流程從 Claude 編寫的指令碼協調許多子代理，您可以重新執行。用於程式碼庫審計、大規模遷移和交叉檢查研究。

{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

動態工作流程是一個 JavaScript 指令碼，可大規模協調子代理。Claude 為您描述的任務編寫指令碼，執行時期在背景執行它，同時您的工作階段保持回應。

當任務需要超過一個對話可以協調的代理數量時，或當您想將協調編成可以讀取和重新執行的指令碼時，請使用工作流程。範例包括程式碼庫範圍的錯誤掃描、500 個檔案遷移、需要相互交叉檢查來源的研究問題，以及值得從多個獨立角度起草的困難計畫，然後再提交給其中一個。

本頁涵蓋如何：

• 決定何時使用工作流程而不是子代理或技能
• 執行捆綁的工作流程與 /deep-research
• 讓 Claude 為您的任務編寫工作流程並儲存它
• 瞭解工作流程如何執行和管理執行

何時使用工作流程

子代理、技能、代理團隊和工作流程都可以執行多步驟任務。區別在於誰掌握計畫：

工作流程將計畫移入程式碼。使用子代理、技能和代理團隊，Claude 是協調者：它逐輪決定接下來要生成或指派什麼，每個結果都進入上下文視窗。工作流程指令碼保存迴圈、分支和中間結果本身，因此 Claude 的上下文只保存最終答案。

將計畫移入程式碼也讓工作流程應用可重複的品質模式，而不僅僅是執行更多代理：它可以讓獨立代理在報告前對彼此的發現進行對抗性審查，或從多個角度起草計畫並相互權衡，因此您獲得比單次通過更可信的結果。

執行捆綁的工作流程

查看工作流程運作的最快方式是執行 /deep-research，內建工作流程Claude Code 包含用於跨許多來源調查問題。您將看到代理在背景中完成一組階段，同時您的工作階段保持自由，最後獲得一份報告而不是逐輪記錄。

/deep-research What changed in the Node.js permission model between v20 and v22?

/workflows

要為您自己的任務執行工作流程，讓 Claude 編寫一個，一旦執行執行您想要的操作，您可以儲存它作為您自己的命令。

捆綁的工作流程

Claude Code 包含 /deep-research 作為內建工作流程：

您自己儲存的工作流程以相同方式成為命令，並在 / 自動完成中與捆綁的命令一起出現。

監視執行

工作流程在背景中執行，因此工作階段在代理工作時保持回應。隨時執行 /workflows 以列出執行中和已完成的工作流程，然後選擇一個以開啟其進度檢視。

/workflows

進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵：

讓 Claude 編寫工作流程

您可以通過兩種方式讓 Claude 為您的任務編寫工作流程：

• 在您的提示中要求工作流程，使用關鍵字 ultracode，Claude 為任務編寫一個。
• 讓 Claude 使用 ultracode 決定：設定 /effort ultracode，Claude 為工作階段中的每項實質性任務規劃工作流程。

您也可以執行已存在的工作流程命令：捆綁的工作流程如 /deep-research，或您儲存的工作流程。

在您的提示中要求工作流程

要在不改變工作階段努力級別的情況下將單個任務作為工作流程執行，請在提示中包含關鍵字 ultracode。用您自己的話提問，例如「使用工作流程」或「執行工作流程」，也可以：Claude 將直接請求視為相同的選擇加入。在 v2.1.160 之前，字面觸發關鍵字是 workflow；自然語言請求在兩個版本中都有效。

ultracode: audit every API endpoint under src/routes/ for missing auth checks

Claude Code 在您的輸入中突出顯示該關鍵字，Claude 為任務編寫工作流程指令碼，而不是逐輪完成它。如果執行執行您想要的操作，您可以之後將其儲存為命令。

如果您沒有打算啟動工作流程，請在 macOS 上按 Option+W 或在 Windows 和 Linux 上按 Alt+W 以忽略此提示的突出顯示，或在游標位於突出顯示單詞的正後方時按退格鍵。要停止該單詞完全觸發，請在 /config 中關閉 Ultracode keyword trigger。

如果您已經以另一種方式建立了協調器，例如子代理提示的資料夾或一個分散工作的技能，您可以指向 Claude 並要求工作流程執行相同的操作。

讓 Claude 使用 ultracode 決定

Ultracode 是一個 Claude Code 設定，結合 xhigh 推理努力與自動工作流程協調。啟用它後，Claude 為每項實質性任務規劃工作流程，而不是等待您要求。

/effort ultracode

啟用 ultracode 後，Claude 決定任務何時值得工作流程。單個請求可以變成一系列工作流程：一個用於理解程式碼，一個用於進行更改，一個用於驗證它。這適用於工作階段中的每項任務，因此每個請求使用更多令牌並花費比較低努力級別更長的時間。

Ultracode 持續當前工作階段，當您啟動新工作階段時重設。當您返回日常工作時，使用 /effort high 下降。它在支援 xhigh 努力的模型上可用；在其他模型上，/effort 功能表不提供它。

在執行前批准計畫

在 CLI 中，每次執行提示顯示計畫的階段和這些選項：

• 是，執行它：啟動執行
• 是，不再詢問 <name> 在 <path> 中：啟動，並從現在開始跳過此專案中此工作流程的此提示
• 檢視原始指令碼：在決定前讀取指令碼
• 否：取消

Ctrl+G 在您的編輯器中開啟指令碼。Tab 讓您在執行啟動前調整提示。

您是否看到此提示取決於您的權限模式：

在桌面應用程式中，批准卡顯示工作流程名稱、階段列表和令牌使用警告，具有一次、始終和拒絕動作。進度檢視出現在背景任務側窗格中。

您的權限模式僅控制上面的啟動提示。工作流程生成的子代理始終在 acceptEdits 模式下執行，並繼承您的工具允許清單，無論您的工作階段模式如何。檔案編輯自動批准。

Shell 命令、網路獲取和不在您允許清單中的 MCP 工具仍可在執行中提示您。要在長時間執行時避免這種情況，請在啟動前將代理需要的命令新增到您的允許清單。

在 claude -p 和 Agent SDK 中沒有人提示，因此工具呼叫遵循您配置的權限規則，無需互動確認。

儲存工作流程以供重複使用

當 Claude 為您將重複的任務編寫工作流程時，您可以將該執行的指令碼儲存為命令。一個您在每個分支上執行的審查流程然後每次執行相同的協調。

執行 /workflows，選擇您想保留的執行，然後按 s。在儲存對話中，Tab 在兩個儲存位置之間切換：

• .claude/workflows/ 在您的專案中：與克隆儲存庫的每個人共享
• ~/.claude/workflows/ 在您的主目錄中：在每個專案中可用，僅對您可見

按 Enter 儲存。工作流程在未來工作階段中從任一位置作為 /<name> 執行。

{/* min-version: 2.1.178 */}自 v2.1.178 起，儲存到專案位置會寫入您的工作目錄和儲存庫根目錄之間已存在的最接近的 .claude/workflows/ 目錄，或如果尚不存在則寫入儲存庫根目錄。專案工作流程也從該路徑沿著的每個 .claude/workflows/ 載入，當多個定義相同名稱時 Claude Code 執行最接近工作目錄的那個。

如果專案工作流程和個人工作流程共享名稱，則執行專案工作流程。

將輸入傳遞給已儲存的工作流程

已儲存的工作流程可以通過 args 參數接受輸入。指令碼將其讀取為名為 args 的全域變數。使用此功能在調用時提供研究問題、目標路徑清單或配置物件，而不是為每次執行編輯指令碼。

以下提示使用問題編號清單執行已儲存的工作流程：

> Run /triage-issues on issues 1024, 1025, and 1030

Claude 將清單作為結構化資料傳遞，因此指令碼可以直接在 args 上呼叫陣列和物件方法，無需先解析它。如果省略 args，全域變數在指令碼內為 undefined。

工作流程如何執行

工作流程執行時期在隔離環境中執行指令碼，與您的對話分開。中間結果保留在指令碼變數中，而不是進入 Claude 的上下文。

每次執行都會將其指令碼寫入您工作階段目錄下的 ~/.claude/projects/ 中的檔案。執行開始時 Claude 會收到該路徑，因此您可以要求它。您可以開啟該檔案以讀取 Claude 編寫的協調指令碼，將其與先前執行的指令碼進行比較，或編輯它並要求 Claude 從編輯後的版本重新啟動。

執行時期在執行進行時追蹤每個代理的結果，這是使執行在同一工作階段中可恢復的原因。

行為和限制

執行時期應用以下約束：

管理執行

執行啟動後，您從 /workflows 檢視或通過展開輸入框下方任務面板中的進度線來管理它。

暫停後恢復

如果您停止執行，您可以恢復它：已完成的代理返回其快取結果，其餘的實時執行。從 /workflows 恢復暫停的執行，方法是選擇它並按 p，或要求 Claude 使用相同指令碼重新啟動工作流程。

恢復在同一 Claude Code 工作階段內工作。如果您在工作流程執行時退出 Claude Code，下一個工作階段將重新啟動工作流程。

成本

工作流程生成許多代理，因此單次執行可以使用比在對話中完成相同任務更多的令牌。執行計入您的方案使用量和速率限制，如任何其他工作階段。

為了在提交大型任務前評估支出，請先在小片段上執行工作流程：一個目錄而不是整個儲存庫，或一個狹隘的問題而不是廣泛的問題。/workflows 檢視顯示每個代理的令牌使用量，隨著執行進行，您可以隨時在那裡停止執行而不會丟失已完成的工作。執行時間的代理上限限制單次執行可以生成多少個代理，這限制了失控指令碼的成本。

工作流程中的每個代理使用您的工作階段模型，除非指令碼將階段路由到不同的模型。要控制模型成本：

• 在大型執行前檢查 /model，如果您通常為日常工作切換到較小的模型
• 當您描述任務時，要求 Claude 為不需要最強模型的階段使用較小的模型

關閉工作流程

工作流程在 CLI、桌面應用程式、IDE 擴充功能、非互動模式與 claude -p 和 Agent SDK 中可用。相同的禁用設定適用於每個表面。

要為自己關閉工作流程：

• 在 /config 中切換 Dynamic workflows 關閉。在工作階段中持續。
• 在 ~/.claude/settings.json 中設定 "disableWorkflows": true。在工作階段中持續。
• 設定 CLAUDE_CODE_DISABLE_WORKFLOWS=1。在啟動時讀取，因此它適用於您設定它的任何位置。

要為整個組織關閉工作流程，在受管設定中設定 "disableWorkflows": true，或使用 Claude Code 管理員設定頁面上的切換。

禁用工作流程時，捆綁的工作流程命令不可用，ultracode 關鍵字不再觸發執行，ultracode 從 /effort 功能表中移除。

相關資源

• 並行執行代理：比較子代理、代理檢視、代理團隊和工作流程
• 建立自訂子代理：工作流程協調的工作者原始類型
• 管理成本：多代理執行如何計入使用限制