部落格

Claude Code 的 Ultracode 2026:如何用一個命令啟用

Markdown

Claude 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 會自行判斷任務是否需要工作流程。單一請求可以接連轉成多個工作流程:一個用來理解程式碼,一個用來進行變更,另一個用來驗證變更。

— Anthropic Docs,code.claude.com/docs/en/workflows

也就是說,你的一個請求可能依序展開成三個工作流程:理解程式碼、進行變更,以及驗證變更。每個工作流程都可能啟動 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 會將明確的要求視為相同的選擇加入。

— Anthropic Docs,code.claude.com/docs/en/workflows

如果你不小心輸入 ultracode,其實並不想啟動工作流程,請在游標緊接著反白顯示的詞之後時按下 Option+W(macOS)或 Alt+W(Windows/Linux)。反白效果會消失,任務便會照一般方式進行。

啟用後,Claude 的工作方式有何變化

重點摘要

Claude 不再以「一輪一輪」的方式回應,也就是你給一個提示詞,Claude 回一個答案。相反地,它會撰寫一段 JavaScript 程式碼,由執行環境在背景執行。程式碼可以啟動 10–30 個平行代理,每個代理都有自己的上下文,並彙整它們的結果。工作流程在背景執行時,你的工作階段仍可回應,因此你可以指派新任務。

未使用 Ultracode 時:你撰寫提示詞,Claude 思考 30 秒後回答。如果任務很大,中間結果會填滿上下文,到了工作階段尾聲,一切開始「偏離」。

使用 Ultracode 時:你撰寫提示詞,Claude 判斷任務規模後撰寫程式碼。程式碼會在隔離環境中執行:中間結果保存在程式碼變數中,而不是工作階段上下文中。你只會收到最終答案。

實際上,這會帶來三項效果:

  1. 工作階段上下文不會塞滿。 你可以更長時間工作,而不必使用 /compact。
  2. 你可以平行處理。 一次執行最多可啟動 16 個代理同時工作(CPU 較弱的電腦會更少)。整次執行的代理總數上限為 1000 個。
  3. 結果會自動檢查。 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;或提出範圍較窄的問題,而不是廣泛的問題。

— Anthropic Docs,code.claude.com/docs/en/workflows#cost

也就是先在一個資料夾執行工作流程,查看 /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 上的陣列與物件方法,不必先解析。

— Anthropic Docs,code.claude.com/docs/en/workflows#pass-input-to-a-saved-workflow

也就是說,你可以直接在程式碼中使用 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。這會讓你比看任何文字說明都更實際地了解成本與效益。

出處

另請參閱:

認識 Ailoot。

更多詳情

常見問題:Claude Code 的 Ultracode 2026:如何用一個命令啟用

如何只在刻意使用關鍵詞時,才啟動 workflows?

保持 Dynamic workflows 開啟,工作階段使用普通 effort,例如 /effort high;只在所選任務加 ultracode。全域停用也會關閉關鍵詞路徑。

如何停止工作階段自動選 workflows?

從 /effort ultracode 回到普通 effort。若要同時禁止整段工作階段與關鍵詞流程,才使用本文全域停用,並確認關鍵詞不再啟動。

所有文章