實戰手冊 · Field Manual 2026 初夏號
Claude Code v2.1.154+ · Research Preview
Claude Code 進階編排 · Workflows / Ultracode / Ultraplan

Claude Code 三大編排功能
完整使用說明

Dynamic Workflows、Ultracode、Ultraplan 是 Claude Code 的進階編排功能。工作流以 Claude 產生的 JavaScript 腳本在背景調度數十到上千個 subagent;Ultracode 在 xhigh effort 下自動判斷何時啟動工作流;Ultraplan 將規劃任務送至雲端,並在瀏覽器中逐段評審。本手冊依官方文件說明各功能的概念、啟用方式、範例 Prompt、適用情境與最佳實踐。

1,000
單次工作流上限 Agent
16
同時並行 Agent
3
進階功能
2.1.154+
所需版本
01
概念與三者關係

三種不同的任務調度模型

三個功能解決同一個問題:任務大到單一對話視窗無法容納時,如何處理?差別在於計畫由誰掌控Dynamic Workflows(動態工作流)將計畫寫入一支 JavaScript 腳本,由 runtime 在背景執行,腳本本身掌握迴圈、分支與中間結果,Claude 的 context 只接收最終答案。Ultracode 是一個 effort 設定,啟用後 Claude 會自動替每個有份量的任務規劃工作流,無需每次手動觸發。Ultraplan 將規劃步驟移至雲端,讓使用者在瀏覽器中逐段評審計畫。

理解工作流的關鍵,在於與 subagent、skill 的比較。三者都能執行多步驟任務,但計畫的存放位置完全不同,這也決定了各自能支援的任務規模。

面向 Subagents Skills Workflows
本質 Claude 派出的工人 Claude 遵循的指示 runtime 執行的腳本
誰決定下一步 Claude,一回合一回合 Claude,照著 prompt 腳本本身
中間結果住在 Claude 的 context Claude 的 context 腳本變數
可重複的是 工人的定義 那段指示 整套編排本身
規模 每回合幾個 同 subagents 單次數十到上千個

因為中間結果存於腳本變數而非 context,工作流可套用「可重複的品質模式」:讓多個獨立 agent 交叉審查彼此的發現再回報,或從多個角度各擬一版計畫後互相比對。這種多 agent 對抗驗證的結果,比單次 pass 更可信。

A workflow moves the plan into code.
工作流把「計畫」搬進程式碼裡。
— Claude Code 官方文件 · Dynamic Workflows
02
啟用、觸發與關閉

三大功能的啟用指令速查

前提:Claude Code v2.1.154 以上,功能處於 research preview。所有付費方案皆可用;Pro 方案需到 /config 的「Dynamic workflows」列把它打開。下面是三大功能與相關指令的速查。

觸發 · 01
workflow(關鍵字)
單次開工作流
prompt 任何位置含 workflow 這個字,Claude 就替這個任務寫一支工作流,不改變 session 的 effort。
觸發 · 02
/deep-research
內建研究工作流
最快體驗工作流的方式:跨多角度搜尋、交叉查證、投票過濾,回傳附引用的報告。
監看 · 03
/workflows
進度監看台
列出進行中/已完成的工作流,進去看每個 phase 的 agent 數、token、耗時,並可暫停、停止、存檔。
自動 · 04
/effort ultracode
讓 Claude 自己決定
把 effort 設為 xhigh,並讓 Claude 自動判斷何時該開工作流。只在本 session 生效。
雲端 · 05
/ultraplan
雲端規劃
/ultraplan <需求> 把規劃丟到 Claude Code on the web 的 plan mode,瀏覽器裡逐段評審。
存檔 · 06
s 鍵(於 /workflows)
變成可重用指令
滿意的工作流選起來按 s,存到專案 .claude/workflows/ 或個人 ~/.claude/workflows/,日後用 /<名稱> 呼叫。
取消 · 07
alt+w
忽略誤觸
不小心打到 workflow 被高亮時,按 alt+w 這回合忽略,或在該字後按 backspace。
關閉 · 08
disableWorkflows
整個關掉
/config 切掉、或設 "disableWorkflows": true、或環境變數 CLAUDE_CODE_DISABLE_WORKFLOWS=1。關閉後 ultracode 也會從 /effort 選單消失。

關閉工作流的三種方式

# 1. 寫進使用者設定(跨 session 持續) ~/.claude/settings.json → "disableWorkflows": true # 2. 環境變數(啟動時讀取) export CLAUDE_CODE_DISABLE_WORKFLOWS=1 # 3. 互動式:在 /config 把 Dynamic workflows 切為 off /config
Ultraplan 的前提不一樣。它需要 Claude Code on the web 帳號與一個 GitHub repo,且因為跑在 Anthropic 雲端,不支援 Amazon Bedrock、Google Vertex AI、Microsoft Foundry。版本需求是 v2.1.91+。
03
Dynamic Workflows

runtime 在背景執行編排腳本

當你含關鍵字或叫 Claude 寫工作流時,它會產生一支 JavaScript 編排腳本,由 runtime 在獨立於對話的環境背景執行,你的 session 仍可繼續用。腳本用幾個原語組裝:agent() 派一個 subagent、parallel() 一批同時跑(會等全部完成)、pipeline() 讓每個項目獨立走完所有階段、phase() 分組進度。

體驗工作流最低風險的方式是執行內建的 /deep-research。它在背景分階段 fan-out 搜尋、交叉查證來源、對每條主張投票,未通過查證的主張會被過濾,最終輸出附引用的報告,而非逐回合的對話記錄。

# A. 關鍵字:prompt 含 workflow 即觸發(單次) Run a workflow to audit every API endpoint under src/routes/ for missing auth checks # B. 內建研究工作流 /deep-research What changed in the Node.js permission model between v20 and v22? # C. 直接叫它寫一支 請建立一個 workflow,掃描整個 repo 找出未處理的 Promise rejection 並逐一驗證

用 /workflows 監看與操控

工作流在背景跑,隨時 /workflows 列出所有 run,選一個按 Enter 進去看進度。每個 phase 顯示 agent 數、token 總量、耗時。footer 的快捷鍵如下:

按鍵動作
/ 選擇 phase 或 agent
Enter / 鑽進該 phase,再進 agent 看它的 prompt、近期工具呼叫與結果
Esc退回上一層
j / kagent 細節溢出時上下捲動
p暫停 / 繼續整個 run
x停掉選中的 agent;焦點在 run 上時停整個工作流
r重啟選中的執行中 agent
s把這個 run 的腳本存成可重用指令

執行前的核准與權限

在 CLI,啟動前會先顯示規劃好的 phases 與選項:Yes, run it(開跑)、Yes, and don't ask again(本專案這個工作流以後不再問)、View raw script(Ctrl+G 用編輯器開腳本)、No(取消);按 Tab 可在開跑前微調 prompt。要注意:工作流派出的 subagent 一律以 acceptEdits 模式跑、繼承你的工具 allowlist,檔案編輯自動核准;不在 allowlist 的 shell、web fetch、MCP 工具仍可能中途跳出詢問。

限制與可續跑

runtime 的硬限制:同時最多 16 個 agent(CPU 核心較少的機器更低)、單次最多 1,000 個 agent(防止失控迴圈)。腳本本身不能直接讀寫檔案或執行 shell 指令,這些操作由 agent 負責,腳本只負責調度。工作流不接受中途使用者輸入;若需要逐階段人工確認,請將每個階段拆為各自獨立的工作流。run 在同一個 session 內可續跑:已完成的 agent 回傳快取結果,其餘重新執行。關閉 Claude Code 後,下次將從頭開始。

04
Ultracode

由 Claude 自動判斷是否啟動工作流

Ultracode 是一個 Claude Code 設定,把 xhigh 推理 effort自動工作流編排綁在一起。打開後,Claude 會替每個有份量的任務主動規劃工作流,不必你說。一個請求可能連開好幾支工作流:一支理解程式碼、一支做修改、一支驗證。

# 開啟(只在本 session 生效) /effort ultracode # 回到日常工作,降回一般 effort /effort high

因為它對 session 裡每個任務都套用,每個請求都會比低 effort 吃更多 token、花更久。它只在新 session 重置,所以做完大任務記得切回 /effort high。Ultracode 只在支援 xhigh effort 的模型上出現(否則 /effort 選單不會列它);工作流被整個關閉時,ultracode 也會從選單消失。

Effort 等級與工作流的關係

Effort推理深度會自動開工作流嗎適用
high(預設)自適應否 — 只有含 workflow 關鍵字才開多數日常編碼
xhigh更深否 — 一樣只靠關鍵字需要更強推理的單一任務
ultracodexhigh是 — 每個有份量的任務都自動判斷大型重構、難決策、不在乎成本時
Auto 權限模式注意:ultracode 啟用時,Auto 模式下連工作流啟動的核准提示都會直接略過。執行前務必先將所需工具加入 allowlist,避免意外操作。
05
Ultraplan

在瀏覽器中評審雲端規劃結果

Ultraplan 將規劃任務從本機 CLI 交給 Claude Code on the web 的 plan mode 執行。Claude 在雲端擬定計畫,本機終端機同時可繼續使用。計畫完成後,可在瀏覽器中針對個別段落留言、要求修訂,再決定在哪裡執行。適合需要比終端機更完整評審介面的情境,支援 inline comment、emoji 反應與大綱側欄跳轉。

Ultraplan 流程
CLI 發動 雲端擬計畫 瀏覽器評審 雲端執行 或 傳回終端
# A. 指令 /ultraplan migrate the auth service from sessions to JWTs # B. 關鍵字:一般 prompt 含 ultraplan 我需要一個 ultraplan 來重構整個資料庫層 # C. 從本機計畫轉雲端:在核准對話框選 No, refine with Ultraplan on Claude Code on the web

終端機的狀態指示

雲端 session 啟動後,CLI 的輸入列會顯示狀態。可用 /tasks 選 ultraplan 項目,打開含 session 連結、agent 活動與「Stop ultraplan」的詳情。

狀態意思
◇ ultraplan正在研究你的程式碼、擬計畫
◇ ultraplan needs your input有澄清問題;開連結回答
◆ ultraplan ready計畫好了,到瀏覽器評審

計畫批准後,在哪裡執行

評審滿意後,從瀏覽器二選一:Approve Claude's plan and start coding — 在同一個雲端 session 實作,完成後 review diff、開 PR;或 Approve plan and teleport back to terminal — 把計畫傳回正在等待的終端機。傳回後終端會跳出「Ultraplan approved」對話框,三個選項:Implement here(注入目前對話繼續做)、Start new session(清空、只帶計畫重開)、Cancel(存成檔案、印出路徑,日後再用)。

Remote Control 與 Ultraplan 共用 claude.ai/code 介面,兩者不能同時啟用。啟動 ultraplan 時,Remote Control 連線會被中斷。
06
範例 Prompt · 使用情境 · 最佳實踐

可直接套用的範例與最佳實踐

以下八張卡片涵蓋範例 prompt、適用情境與最佳實踐,全部依據官方文件。核心原則:描述「階段與目標」,不要描述「派幾個 agent」,編排由 Claude 決定。

範例 01

全庫稽核(Workflow)

workflow 掃描 src/ 下所有 API 端點,找出缺少權限檢查的,並讓獨立 agent 對每個發現各自驗證後再回報。」

情境:上線前的安全清查。給它測試案例或預期結果,agent 才能自我過濾誤報。

適用 · 大範圍掃描
範例 02

大型遷移(Workflow)

「建立一個 workflow,把 200 個路由從 callback 改寫成 async/await,每個檔案獨立走『改寫 → 跑測試 → 修正』。」

最佳實踐:這種「每項目各自走完多階段」用 pipeline() 最省時,不必等整批。

適用 · 500 檔級遷移
範例 03

交叉查證研究

/deep-research 比較 2026 年三大向量資料庫的一致性保證,來源要彼此交叉查證。」

情境:需要可信、有引用的調查。沒撐過查證的主張會被自動濾掉。

適用 · 多來源研究
最佳實踐 04

先跑 /deep-research 探路

不確定工作流適不適合時,先跑內建的 /deep-research 看它怎麼運作。如果模式不對,你也沒白寫一支自訂腳本。

官方建議
最佳實踐 05

跑成功就存起來

一個你每條 branch 都要跑的流程(例如上線前審查),在 /workflowss 存成 /<名稱>,以後每次跑同一套編排。

可重用化
最佳實踐 06

先顧好 token 與模型成本

工作流會派出多個 agent,單次 token 用量可能明顯高於一般對話。大型執行前先用 /model 確認目前模型;並告知 Claude「不需要高階模型的階段改用較小模型」以降低成本。

成本控制
最佳實踐 07

長跑前先放行工具

不在 allowlist 的 shell / web / MCP 工具會中途跳出詢問,打斷無人值守的長跑。開跑前先把 agent 需要的指令加進 allowlist。

無人值守
範例 08

難架構先 Ultraplan

/ultraplan 設計月費訂閱的對帳流程,含 schema、邊界案例與測試。」用瀏覽器逐段留言修訂,定案後再 teleport 回終端實作。

語意越具體越好:「含測試與 schema 更新」比「修一下 auth」更能產生完整計畫。

適用 · 複雜規劃
07
完整實戰示例 · 情境演示

三個功能協同使用的完整流程

以下是示意流程(用於說明指令與狀態,非實測逐字稿):你要為一個服務加上 OAuth2。先用 ultraplan 在雲端擬計畫、評審後傳回終端,再開 ultracode 讓 Claude 自動分工作流實作與驗證。

~/projects/api · claude code v2.1.154
You › /ultraplan 為 auth 服務加上 OAuth2,含測試與 DB schema 更新
[確認對話框 → Yes · 雲端 session 啟動] ◇ ultraplan 研究 codebase、擬計畫中…(終端機空出來可做別的事)
◆ ultraplan ready → 開瀏覽器連結評審 [瀏覽器:逐段 inline comment「token 刷新要用 rotating refresh token」] [Claude 修訂計畫 → 選 Approve plan and teleport back to terminal]
Ultraplan approved › Implement here / Start new session / Cancel You › Implement here
You › /effort ultracode [effort = xhigh + 自動工作流編排 · 本 session 生效]
You › 照計畫實作 OAuth2。
[Claude 自動規劃工作流 · 核准 phases → Yes, run it] workflow 1/3 理解現有 auth 架構(parallel readers) workflow 2/3 實作 OAuth2 + rotating refresh token(pipeline) workflow 3/3 獨立 agent 對抗驗證 + 跑測試
You › /workflows [↑↓ 選 phase · Enter 鑽進去看每個 agent 找到什麼 · p 暫停 · s 存檔]
DONE — OAuth2 已實作,測試通過,工作流可按 s 存成 /add-oauth 重用。 You › /effort high ← 回到日常,降回一般 effort
Ultraplan 確定計畫內容,
Workflows 以大規模 agent 執行,
Ultracode 自動判斷何時啟動工作流。
— 三者的分工
08
注意事項

使用限制、成本與邊界條件

  • Token 成本明顯上升。工作流派很多 agent,單次可能比同樣任務用對話做吃掉「明顯更多」token,且都計入方案用量與速率限制。Ultracode 對每個任務都這樣做,成本更要盯。
  • 都還是 research preview。Workflows 需 v2.1.154+、Ultraplan 需 v2.1.91+,行為與能力可能隨回饋改變。先在非關鍵任務上試。
  • Ultraplan 會上傳到雲端。它跑在 Anthropic 雲端、需要 GitHub repo,且不支援 Bedrock / Vertex / Foundry。機密程式碼若不能上傳,改用本機 plan mode(Shift+Tab)。
  • 工作流不跨 session 續跑。同一個 session 內可暫停後繼續(已完成的 agent 使用快取結果);關閉 Claude Code 後,下次從頭執行。需要暫停時,請勿關閉應用程式。
  • 檔案編輯自動核准。工作流的 subagent 一律以 acceptEdits 跑、繼承你的 allowlist。接近 production 時要特別小心,先確認 allowlist 沒放行危險操作。
  • 工作流不收中途輸入。只有 agent 的權限提示能暫停它。要在階段之間人工簽核,就把每一階段拆成各自的工作流。
  • 小任務別用。改個 typo、修個小 bug,直接用一般對話比走工作流快得多。Workflows / Ultracode 是給跨檔、多階段、規模大的任務用的。
09
進階路徑

進階使用建議與官方文件

1. 先用 /deep-research 建立直覺。這是體驗工作流最低風險的入口,看懂它的 phase、交叉查證與報告長相,再去寫自己的。

2. 把重複流程存成指令。每條 branch 都要做的審查、每次發版的檢查,跑成功後在 /workflowss 存成 /<名稱>,團隊版放 .claude/workflows/ 進 repo 共用。

3. 規劃用 Ultraplan、實作用 Ultracode、審查用 Ultrareview。三個「ultra」各司其職:/ultraplan 在雲端擬計畫、ultracode 自動分工作流實作、/code-review ultra(ultrareview)在雲端用一支 reviewer 隊伍做 pre-merge 把關。

4. 執行前確認成本。大型任務前先用 /model 確認目前模型,把不需要高階模型的階段指定為較小模型;ultracode 執行完畢後切回 /effort high

官方文件

Dynamic Workflows:工作流的完整運作、限制、存檔與關閉。
Ultraplan:雲端規劃的發動、評審與執行選項。
Model configuration:effort 等級與 ultracode 的設定位置。

描述「階段與目標」,
讓 Claude 決定編排,
不要替它指定派幾個 agent。
— 工作流使用原則