Claude Code 的 Ultracode 2026:如何用一個命令啟用
MarkdownClaude Code 的 Ultracode:Claude 自行啟動代理團隊的模式。了解它與 /effort xhigh 的差異、啟用方式,以及它消耗 token 的速度。
閱讀全文
重點摘要
Ultracode 是 Claude Code 的一種模式,Claude 會自行判斷某項任務是否值得以數十個平行代理執行工作流程,而不是只用單一提示詞回答。若要在整個工作階段啟用,請使用 /effort ultracode;若只用於單一任務,請在任務開頭輸入 ultracode。在底層,它結合了 xhigh 推理能力(類似 Opus 4.8 設為最高推理等級時的狀態)與自動協調器。它適合大型程式碼稽核、涉及數百個檔案的遷移,以及深入研究。它消耗 token 的速度比一般模式快好幾倍,因此日常工作最好使用 /effort high。
如需服務的使用資訊,請參閱 Ailoot 文件。
Ultracode 是什麼,適合哪些人
重點摘要
Ultracode 是 Claude Code 的工作階段層級設定,結合最高推理等級(xhigh)與動態工作流程的自動協調。它於 2026 年 5 月 28 日隨著 Opus 4.8 一同在 v2.1.154 推出。它適用於單一提示詞無法處理的大型任務:稽核整個專案、遷移 500 個檔案,或從 20 個來源研究複雜問題。
在 2026 年 5 月 28 日之前,Claude Code 只有 /effort 參數,提供 low / medium / high / xhigh 等級。這代表模型的「思考」程度:等級越高,推理所用的 token 越多,結果越精確,Claude 回覆所需的時間也越長。
Ultracode 不在 /effort low → xhigh 這個尺度上,而是與之並列。啟用後,Claude 會自動檢視你的任務並判斷:「這項任務最好拆成 30 個平行代理來處理,然後我再彙整結果。」以前你必須手動撰寫自己的工作流程,或組合子代理命令。現在 Claude 會自行判斷何時適合這麼做。
主要適用對象是已經碰到單一提示詞能力上限的人。如果你曾經:
- 在有 200 個檔案的 repo 上執行
/code-review,結果工作階段在檢查到第 50 個檔案時就卡住 - 要求「找出所有使用已淘汰 API 的地方」,Claude 卻只列出三處,漏掉另外十五處
- 希望 Claude 在回答前,從三個角度檢查自己的假設
那麼 Ultracode 就適合你。如果你只是在寫一個函式,只需要一種解法,就不需要它:一般的 /effort high 就能完成,token 用量只有三分之一。
Ultracode 與一般 low / medium / high / xhigh effort 等級有何不同
重點摘要
一般 effort 會改變單次回覆的推理深度。Ultracode 則增加了自動選擇機制:啟動有平行代理的工作流程,或一次完成任務。推理深度仍維持在 xhigh 的最高等級,另外再加上一層協調能力。
以下比較重點:
| 參數 | /effort low | /effort medium | /effort high | /effort xhigh | /effort ultracode |
|---|---|---|---|---|---|
| 推理深度 | 最低 | 中等 | 深入 | 最高 | 最高(xhigh) |
| 推理 token 用量 | 少 | 中等 | 多 | 非常多 | 非常多 + 協調 |
| 誰決定拆分任務 | 你 | 你 | 你 | 你 | Claude 自動決定 |
| 工作流程何時啟動 | 由你下令 | 由你下令 | 由你下令 | 由你下令 | 每逢重要任務 |
| 工作階段間是否重設 | 否 | 否 | 否 | 否 | 是,必須重新啟用 |
| 支援的模型 | 全部 | 全部 | 全部 | 僅支援 xhigh 的模型 | 僅支援 xhigh 的模型(Opus 4.8) |
用一句話概括主要差異:/effort xhigh 意味著「多想一會兒」;Ultracode 則意味著「多想一會兒,並自行判斷何時用一個提示詞就能處理,何時需要 30 個代理組成的團隊」。因此,本質上 Ultracode 在 xhigh 之上增加了另一層:自動協調。
Anthropic 在官方文件中明確說明:
啟用 ultracode 後,Claude 會自行判斷任務是否需要工作流程。單一請求可以接連轉成多個工作流程:一個用來理解程式碼,一個用來進行變更,另一個用來驗證變更。
也就是說,你的一個請求可能依序展開成三個工作流程:理解程式碼、進行變更,以及驗證變更。每個工作流程都可能啟動 10–30 個平行代理。
支援 Ultracode 的版本與模型
重點摘要
你需要 Claude Code v2.1.154 或更新版本,以及支援 xhigh effort 的模型。截至 2026 年 6 月,Anthropic 實際上將 xhigh 的推出與 Opus 4.8 綁定(變更紀錄中尚未確認其他支援 xhigh 的模型)。Pro / Max / Team / Enterprise 和 API 均可使用。Pro 方案必須在 /config 手動啟用;其他方案則預設即可使用。Bedrock、Vertex AI 和 Microsoft Foundry 也支援此功能。
檢查版本:
claude --version
如果版本低於 2.1.154,請更新:
npm install -g @anthropic-ai/claude-code
接著查看 effort 等級清單:
claude /effort
如果下拉選單中出現 ultracode,就表示一切就緒。如果沒有,最可能的原因是:
- 目前使用的模型不是 Opus 4.8(例如 Sonnet 4.7 不支援 xhigh)
- 你使用 Pro 方案,且在
/config中停用了此模式(請啟用「Dynamic workflows」選項) - 組織管理員已在受管理設定中停用工作流程
檢查模型:
claude /model
如果預設模型不是 Opus 4.8,請切換:在模型選單中選取 Opus 4.8,或按 d 鍵將它設為預設模型。
啟用 Ultracode 的兩種方法
重點摘要
第一種方法是使用 /effort ultracode,在整個工作階段啟用。該工作階段中後續的每項任務都會透過自動工作流程選擇處理。第二種方法只用於單一任務:在提示詞開頭輸入 ultracode;該詞會反白顯示,只有這項任務會以工作流程啟動。工作階段的 effort 等級不會改變。
方法 1:在整個工作階段啟用。
在 Claude Code 工作階段中輸入:
/effort ultracode
從此之後,Claude 會自行決定是否為每項重要任務啟動工作流程。工作階段會持續到你關閉為止。關閉 Claude Code 後再重新開啟,Ultracode 就會重設。這是刻意的設計:你應該有意識地啟用此模式,而不是讓它「預設開啟」。
方法 2:只用於單一任務。
在提示詞開頭輸入 ultracode(在 v2.1.160 之前,關鍵字是 workflow;該版本推出後,Anthropic 更改了觸發詞,以免和一般執行混淆):
ultracode: go through all /api/* endpoints in src/routes/ and find where authorization checks are missing
Claude Code 會將 ultracode 反白顯示,並以工作流程啟動這項任務。工作階段的 effort 等級維持不變(依你的設定為 high 或 medium)。
Anthropic 在文件中提到,用自然語言提出相同要求也可以:
用自己的話提出要求,例如「use a workflow」或「run a workflow」,也同樣有效:Claude 會將明確的要求視為相同的選擇加入。
如果你不小心輸入 ultracode,其實並不想啟動工作流程,請在游標緊接著反白顯示的詞之後時按下 Option+W(macOS)或 Alt+W(Windows/Linux)。反白效果會消失,任務便會照一般方式進行。
啟用後,Claude 的工作方式有何變化
重點摘要
Claude 不再以「一輪一輪」的方式回應,也就是你給一個提示詞,Claude 回一個答案。相反地,它會撰寫一段 JavaScript 程式碼,由執行環境在背景執行。程式碼可以啟動 10–30 個平行代理,每個代理都有自己的上下文,並彙整它們的結果。工作流程在背景執行時,你的工作階段仍可回應,因此你可以指派新任務。
未使用 Ultracode 時:你撰寫提示詞,Claude 思考 30 秒後回答。如果任務很大,中間結果會填滿上下文,到了工作階段尾聲,一切開始「偏離」。
使用 Ultracode 時:你撰寫提示詞,Claude 判斷任務規模後撰寫程式碼。程式碼會在隔離環境中執行:中間結果保存在程式碼變數中,而不是工作階段上下文中。你只會收到最終答案。
實際上,這會帶來三項效果:
- 工作階段上下文不會塞滿。 你可以更長時間工作,而不必使用
/compact。 - 你可以平行處理。 一次執行最多可啟動 16 個代理同時工作(CPU 較弱的電腦會更少)。整次執行的代理總數上限為 1000 個。
- 結果會自動檢查。 Claude 可以讓一個代理撰寫解法,另一個代理批判性地檢查。這能減少複雜任務中的幻覺。
你可以即時查看執行情況:
/workflows
系統會開啟執行中與已完成的工作流程清單。使用方向鍵選取一項,再按 Enter 開啟其階段詳細資訊。你可以查看代理、各代理的 token 用量及執行時間。按 p 暫停、按 x 停止,或按 r 重新啟動代理。
何時該啟用或不啟用 Ultracode
重點摘要
如果單一提示詞已無法處理任務,就啟用它,例如稽核整個專案、遷移數百個檔案,或需要交叉查證來源的深入研究。日常工作則不要啟用,例如修復一個錯誤、撰寫一個函式或更正一個錯字。Ultracode 模式下,每項任務的 token 成本都高出數倍,因此用它處理小工作只會浪費預算。
⚠️ 自 2026 年 6 月 15 日起,Anthropic 已拆分訂閱方案:程式化工作負載(包括工作流程)會使用每月 $20–$200 的獨立點數。點數用完後,工作流程請求會直接停止,不會改用訂閱方案額度。這大幅改變了 Ultracode 在 Pro 方案上的成本效益;請參閱下方 token 一節。
以下三種情況適合使用 Ultracode:
1. 稽核大型程式碼庫。 例如:「找出專案中所有會將密碼寫入日誌的地方。」小型 repo 用一個提示詞就能處理。在有 500 個檔案的 repo 中,單一 Claude 可能會漏掉一半;工作流程則會平行啟動 20 個代理,各自處理 25 個檔案。
2. 進行涉及許多檔案的遷移。 替換已淘汰的 API、從一個程式庫切換到另一個,或在整個專案重構某種模式。工作流程可以每 10 個檔案分成一批處理,並在每批完成後自行檢查。
3. 研究需要互相比對來源的問題。 Anthropic 將這項功能包裝成 /deep-research 工作流程:它會將問題拆成不同角度、尋找來源、交叉查證事實,並篩除無法確認的內容。我曾用它蒐集 AI 程式設計市場的資料,得到的報告比我手動工作一小時的成果還好。
以下三種情況會浪費 token:
1. 修復單一函式中的一個錯誤。 單一 /effort high 提示詞就能完成,成本只有十分之一。不要為此啟動工作流程。
2. 撰寫一個新函式或元件。 同理,使用 /effort high,甚至 medium 就可以。複雜度不會隨代理數量增加,而是隨推理深度增加;xhigh 本身就能提供深度推理,不需要協調。
3. 你想快速得到答案。 工作流程本來就比一般提示詞慢:即使代理平行運作,協調也需要時間。如果你需要「現在立刻、同一分鐘內」得到答案,就不要啟用。
這裡採用的策略是:日常編輯預設使用 /effort high。我只會針對特定任務啟用 Ultracode,在提示詞中加入該詞,而不是整個工作階段都開啟。這是因為任務完成後若忘了關閉,之後的日常工作仍會使用 Ultracode,白白消耗 token。
Token 數量與費用
重點摘要
每個工作流程使用的 token 等於所有代理用量的總和。由 30 個代理組成的工作流程代表有 30 個上下文,各自包含系統提示詞、工具與自身推理。token 用量會比單一提示詞高出好幾倍。在 Pro 方案中,一個大型工作流程可能耗掉每日額度的一半。Max 和 Team 的情況較寬裕,但仍需留意用量。
先粗略估算。Opus 4.8 使用 effort high 執行一般提示詞時,推理約使用 5,000–15,000 個 token,再加上模型的回覆。規模適中、內容充實的任務總計約使用 50,000–100,000 個 token。
一個有 20 個代理的工作流程代表 20 個平行提示詞,每個提示詞都有自己的系統提示詞上下文(約 5–10K)、自己的推理(xhigh,10–30K)和自己的回覆。粗略估計,單次執行會使用 600,000–150 萬個 token。費用是單一「一般」提示詞的 10–30 倍。
換算成費用如下:
- Pro(每月 $20): 2026 年 2 月,Anthropic 釐清了對第三方軟體程式化存取的禁令,並於 2026 年 6 月 15 日將工作流程點數與聊天訂閱分開。Pro 為程式化工作負載提供 $20 點數。一個大型工作流程就會用掉其中一半。點數用完後,除非啟用超額費用,否則工作流程會停止啟動。
- Max 5x(每月 $100): 有 $100 點數,足以每月執行 5–10 個大型工作流程。
- Max 20x(每月 $200): 有 $200 點數。
- Team(每位成員 $30/$150): 點數會依照各席位的訂閱方案配置。
- API: 直接依 token 費率付費。
Anthropic 本身建議在執行工作流程前先估算費用:
在承接大型任務之前,先用小範圍執行工作流程來評估費用:例如只跑一個目錄,而不是整個 repo;或提出範圍較窄的問題,而不是廣泛的問題。
也就是先在一個資料夾執行工作流程,查看 /workflows 了解費用,再決定是否要在整個 repo 執行。單次執行的代理總數上限是 1000 個,但在大型 repo 中,即使使用 100 個代理,也會消耗數十萬個 token。
如果你的目標是「降低用量」,可以在工作流程程式碼中,明確指定次要階段使用較小的模型。在提示詞中寫:「檔案分類階段使用 Sonnet 4.7,只有最終分析使用 Opus 4.8。」Anthropic 支援這種做法。
內部運作方式:工作流程、/workflows 與限制
重點摘要
工作流程是 Claude 為你的任務撰寫、並由執行環境在隔離環境中執行的 JavaScript 程式碼。程式碼本身會處理迴圈、分支與中間結果,不會讓你的上下文變得雜亂。你可以閱讀、編輯程式碼,並將它儲存為命令。執行環境的限制為:最多 16 個平行代理,每次執行總計最多 1000 個代理。
每次執行都會將專屬程式碼寫入 ~/.claude/projects/ 下的檔案。執行開始時,Claude 會取得程式碼路徑。這表示你可以:
- 要 Claude「顯示這個工作流程的程式碼」
- 在編輯器中開啟並檢查邏輯
- 與前一次執行的程式碼進行差異比較
- 編輯程式碼後,請 Claude 重新執行修改過的版本
執行環境設有以下限制:
| 限制 | 原因 |
|---|---|
| 執行中無法輸入使用者內容 | 避免執行無限期等待;若階段之間需要確認,請將每個階段分成獨立的工作流程 |
| 程式碼不能直接存取檔案或 shell | 這些工作由代理執行;程式碼只負責協調代理 |
| 同時最多 16 個平行代理 | 避免本機 CPU 負荷過重 |
| 每次執行總計 1000 個代理 | 避免有問題的程式碼進入無限迴圈 |
每次執行都會套用權限模式。預設情況下,Claude Code 每次都會要求許可。你可以選擇「Yes, and don't ask again for <name> in <path>」,之後在該專案中使用那個特定工作流程時,就不會再詢問。使用 Auto 模式時,系統只會在第一次詢問,之後會將你的核准儲存在使用者設定中。在 claude -p 和 Agent SDK 中,由於沒有人可以回覆,因此不會詢問。
有一點很重要:工作流程中的子代理一律以 acceptEdits 模式執行,並會繼承你的工具允許清單,不受目前權限模式影響。檔案編輯會自動核准。如果你正在處理重要內容,請記住這一點。
如何將可用的工作流程儲存為命令
重點摘要
如果你執行過工作流程、喜歡它的運作方式,而且知道之後會再用,可以在 /workflows 中按 s 鍵,將它儲存為 /command。之後它就像一般的斜線命令一樣使用:/workflow_name arguments。它會儲存在專案的 .claude/workflows/(供團隊使用)或 ~/.claude/workflows/(只有你能使用)。
情境:我在新分支上透過 Ultracode 執行了 /code-review。工作流程執行了三次:第一次快速檢視整個 diff,第二次深入檢查安全性函式,第三次針對已變更的函式執行測試。結果相當一致,並找出兩個問題。
現在我想在每個分支合併前都執行這個流程。我開啟:
/workflows
我選取已完成的執行項目並按下 s。在對話框中,我選擇儲存位置:.claude/workflows/(位於專案中,會放進 git,團隊皆可使用)或 ~/.claude/workflows/(個人專用,可用於任何專案)。我為它命名,例如 pre-merge-review,再按 Enter。
之後在任何工作階段中,都可以執行:
/pre-merge-review
工作流程就會以我除錯過的同一份程式碼啟動。
如果工作流程需要引數,請在儲存時的提示詞中說明;接著程式碼會將 args 作為全域變數接收。你可以傳入路徑清單、issue 編號、檔案 ID 或其他資料。
Anthropic 在文件中指出,引數會以結構化資料傳入:
Claude 會將清單以結構化資料傳遞,因此程式碼可以直接呼叫 args 上的陣列與物件方法,不必先解析。
也就是說,你可以直接在程式碼中使用 args.map(...),不用解析字串。這對大量處理票單、資料夾或端點清單很有用。
如何停用 Ultracode,以及為什麼要停用
重點摘要
使用 /effort high(或你需要的其他等級)即可停用,工作階段會回到一般模式。若要永久停用工作流程,請使用 /config 中的「Dynamic workflows」切換選項,或設定環境變數 CLAUDE_CODE_DISABLE_WORKFLOWS=1。組織也可以透過受管理設定停用。
停用它的主要原因是要回到日常工作。如果你為一項大型任務切換到 Ultracode,任務完成後就立刻切回:
/effort high
否則,你接下來的小型編輯也會以工作流程執行,白白消耗 token,沒有任何好處。
若只想用關鍵詞啟動,應保持 Dynamic workflows 開啟,工作階段維持普通 effort(如 /effort high),只在選定任務加 ultracode。不要為此套用下方全域停用,它也會停用關鍵詞;若要禁止兩種流程,才使用以下全域選項:
# 在用戶端設定中
# /config → Dynamic workflows → off
# 或者
# ~/.claude/settings.json
{
"disableWorkflows": true
}
# 或透過環境變數
export CLAUDE_CODE_DISABLE_WORKFLOWS=1
完成後,提示詞中的 ultracode 關鍵字就不會再觸發工作流程,而 /effort 選單中的 ultracode 選項也會消失。如果你的團隊想採用「不使用自動工作流程」這項共同規則,這種做法很有用。此時可以在組織的受管理設定中進行設定。
我將 /effort high 設為預設,只在需要時選擇性啟用 Ultracode。這是在「需要時做好工作」與「不浪費預算」之間取得折衷。對此處描述的專案進行日常編輯時,一般的 high 已經足夠。如果我需要進行大型安全稽核,或從 20 個來源蒐集研究資料,就會使用 /effort ultracode,或在提示詞開頭加上該詞。
接下來可以做什麼
如果你現在正在使用 Claude Code,而且已確認版本為 v2.1.154+,並使用 Opus 4.8 模型,不妨現在就試試看。不要在整個工作階段啟用,只用於一項特定任務:
ultracode: go through all the files in src/components/ui/ and find where the same button is styled differently
檢查 /workflows,看看啟動了多少個代理、用了多少 token。這會讓你比看任何文字說明都更實際地了解成本與效益。
出處
另請參閱:
- Claude Code 的動態工作流程:如何協調數百個平行代理
- Claude Code 的多代理:如何讓子代理平行處理
- Claude Code 的例行工作:使用排程而非 cron 自動化
- Claude Code 中的 Sonnet 或 Opus:不同任務該使用哪個模型
- Claude Code 與 Codex 的目標模式:設定目標並朝目標推進
認識 Ailoot。
更多詳情
常見問題:Claude Code 的 Ultracode 2026:如何用一個命令啟用
如何只在刻意使用關鍵詞時,才啟動 workflows?
保持 Dynamic workflows 開啟,工作階段使用普通 effort,例如 /effort high;只在所選任務加 ultracode。全域停用也會關閉關鍵詞路徑。
如何停止工作階段自動選 workflows?
從 /effort ultracode 回到普通 effort。若要同時禁止整段工作階段與關鍵詞流程,才使用本文全域停用,並確認關鍵詞不再啟動。