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

> Claude Code 的 Ultracode：Claude 自行啟動代理團隊的模式。了解它與 /effort xhigh 的差異、啟用方式，以及它消耗 token 的速度。

Source: https://ailoot.ai/blog/zh-hant-tw/ultracode-claude-code/
Canonical: https://ailoot.ai/blog/zh-hant-tw/ultracode-claude-code/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-227
Revision: sha256-1f1318e9fd42a642d5f95161018aaa97777bdd3951adbc4179aac78a204d984e


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

Ultracode 是 Claude Code 的一種模式，Claude 會自行判斷某項任務是否值得以數十個平行代理執行工作流程，而不是只用單一提示詞回答。若要在整個工作階段啟用，請使用 `/effort ultracode`；若只用於單一任務，請在任務開頭輸入 `ultracode`。在底層，它結合了 xhigh 推理能力（類似 Opus 4.8 設為最高推理等級時的狀態）與自動協調器。它適合大型程式碼稽核、涉及數百個檔案的遷移，以及深入研究。它消耗 token 的速度比一般模式快好幾倍，因此日常工作最好使用 `/effort high`。

</div>

如需服務的使用資訊，請參閱 [Ailoot 文件](https://ailoot.ai/docs/)。



## Ultracode 是什麼，適合哪些人

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

Ultracode 是 Claude Code 的工作階段層級設定，結合最高推理等級（xhigh）與動態工作流程的自動協調。它於 2026 年 5 月 28 日隨著 Opus 4.8 一同在 v2.1.154 推出。它適用於單一提示詞無法處理的大型任務：稽核整個專案、遷移 500 個檔案，或從 20 個來源研究複雜問題。

</div>

在 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 等級有何不同

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

一般 effort 會改變單次回覆的推理深度。Ultracode 則增加了自動選擇機制：啟動有平行代理的工作流程，或一次完成任務。推理深度仍維持在 xhigh 的最高等級，另外再加上一層協調能力。

</div>

以下比較重點：

| 參數 | `/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 在[官方文件](https://code.claude.com/docs/en/workflows#let-claude-decide-with-ultracode)中明確說明：

<figure>
<blockquote>
<p>啟用 ultracode 後，Claude 會自行判斷任務是否需要工作流程。單一請求可以接連轉成多個工作流程：一個用來理解程式碼，一個用來進行變更，另一個用來驗證變更。</p>
</blockquote>
<figcaption>— Anthropic Docs，code.claude.com/docs/en/workflows</figcaption>
</figure>

也就是說，你的一個請求可能依序展開成三個工作流程：理解程式碼、進行變更，以及驗證變更。每個工作流程都可能啟動 10–30 個平行代理。

## 支援 Ultracode 的版本與模型

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

你需要 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 也支援此功能。

</div>

檢查版本：

```bash
claude --version
```

如果版本低於 `2.1.154`，請更新：

```bash
npm install -g @anthropic-ai/claude-code
```

接著查看 effort 等級清單：

```bash
claude /effort
```

如果下拉選單中出現 `ultracode`，就表示一切就緒。如果沒有，最可能的原因是：

- 目前使用的模型不是 Opus 4.8（例如 Sonnet 4.7 不支援 xhigh）
- 你使用 Pro 方案，且在 `/config` 中停用了此模式（請啟用「Dynamic workflows」選項）
- 組織管理員已在受管理設定中停用工作流程

檢查模型：

```bash
claude /model
```

如果預設模型不是 Opus 4.8，請切換：在模型選單中選取 Opus 4.8，或按 `d` 鍵將它設為預設模型。

## 啟用 Ultracode 的兩種方法

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

第一種方法是使用 `/effort ultracode`，在整個工作階段啟用。該工作階段中後續的每項任務都會透過自動工作流程選擇處理。第二種方法只用於單一任務：在提示詞開頭輸入 `ultracode`；該詞會反白顯示，只有這項任務會以工作流程啟動。工作階段的 effort 等級不會改變。

</div>

**方法 1：在整個工作階段啟用。**

在 Claude Code 工作階段中輸入：

```bash
/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 在[文件中](https://code.claude.com/docs/en/workflows#ask-for-a-workflow-in-your-prompt)提到，用自然語言提出相同要求也可以：

<figure>
<blockquote>
<p>用自己的話提出要求，例如「use a workflow」或「run a workflow」，也同樣有效：Claude 會將明確的要求視為相同的選擇加入。</p>
</blockquote>
<figcaption>— Anthropic Docs，code.claude.com/docs/en/workflows</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

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

</div>

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

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

實際上，這會帶來三項效果：

1. **工作階段上下文不會塞滿。** 你可以更長時間工作，而不必使用 `/compact`。
2. **你可以平行處理。** 一次執行最多可啟動 16 個代理同時工作（CPU 較弱的電腦會更少）。整次執行的代理總數上限為 1000 個。
3. **結果會自動檢查。** Claude 可以讓一個代理撰寫解法，另一個代理批判性地檢查。這能減少複雜任務中的幻覺。

你可以即時查看執行情況：

```bash
/workflows
```

系統會開啟執行中與已完成的工作流程清單。使用方向鍵選取一項，再按 Enter 開啟其階段詳細資訊。你可以查看代理、各代理的 token 用量及執行時間。按 `p` 暫停、按 `x` 停止，或按 `r` 重新啟動代理。



## 何時該啟用或不啟用 Ultracode

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

如果單一提示詞已無法處理任務，就啟用它，例如稽核整個專案、遷移數百個檔案，或需要交叉查證來源的深入研究。日常工作則不要啟用，例如修復一個錯誤、撰寫一個函式或更正一個錯字。Ultracode 模式下，每項任務的 token 成本都高出數倍，因此用它處理小工作只會浪費預算。

⚠️ 自 2026 年 6 月 15 日起，Anthropic 已拆分訂閱方案：程式化工作負載（包括工作流程）會使用每月 $20–$200 的獨立點數。點數用完後，工作流程請求會直接停止，不會改用訂閱方案額度。這大幅改變了 Ultracode 在 Pro 方案上的成本效益；請參閱下方 token 一節。

</div>

以下三種情況適合使用 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 數量與費用

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

每個工作流程使用的 token 等於所有代理用量的總和。由 30 個代理組成的工作流程代表有 30 個上下文，各自包含系統提示詞、工具與自身推理。token 用量會比單一提示詞高出好幾倍。在 Pro 方案中，一個大型工作流程可能耗掉每日額度的一半。Max 和 Team 的情況較寬裕，但仍需留意用量。

</div>

先粗略估算。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 本身[建議](https://code.claude.com/docs/en/workflows#cost)在執行工作流程前先估算費用：

<figure>
<blockquote>
<p>在承接大型任務之前，先用小範圍執行工作流程來評估費用：例如只跑一個目錄，而不是整個 repo；或提出範圍較窄的問題，而不是廣泛的問題。</p>
</blockquote>
<figcaption>— Anthropic Docs，code.claude.com/docs/en/workflows#cost</figcaption>
</figure>

也就是先在一個資料夾執行工作流程，查看 `/workflows` 了解費用，再決定是否要在整個 repo 執行。單次執行的代理總數上限是 1000 個，但在大型 repo 中，即使使用 100 個代理，也會消耗數十萬個 token。

如果你的目標是「降低用量」，可以在工作流程程式碼中，明確指定次要階段使用較小的模型。在提示詞中寫：「檔案分類階段使用 Sonnet 4.7，只有最終分析使用 Opus 4.8。」Anthropic 支援這種做法。

## 內部運作方式：工作流程、/workflows 與限制

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

工作流程是 Claude 為你的任務撰寫、並由執行環境在隔離環境中執行的 JavaScript 程式碼。程式碼本身會處理迴圈、分支與中間結果，不會讓你的上下文變得雜亂。你可以閱讀、編輯程式碼，並將它儲存為命令。執行環境的限制為：最多 16 個平行代理，每次執行總計最多 1000 個代理。

</div>

每次執行都會將專屬程式碼寫入 `~/.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` 模式執行，並會繼承你的工具允許清單，不受目前權限模式影響。檔案編輯會自動核准。如果你正在處理重要內容，請記住這一點。

## 如何將可用的工作流程儲存為命令

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

如果你執行過工作流程、喜歡它的運作方式，而且知道之後會再用，可以在 `/workflows` 中按 `s` 鍵，將它儲存為 `/command`。之後它就像一般的斜線命令一樣使用：`/workflow_name arguments`。它會儲存在專案的 `.claude/workflows/`（供團隊使用）或 `~/.claude/workflows/`（只有你能使用）。

</div>

情境：我在新分支上透過 Ultracode 執行了 `/code-review`。工作流程執行了三次：第一次快速檢視整個 diff，第二次深入檢查安全性函式，第三次針對已變更的函式執行測試。結果相當一致，並找出兩個問題。

現在我想在每個分支合併前都執行這個流程。我開啟：

```bash
/workflows
```

我選取已完成的執行項目並按下 `s`。在對話框中，我選擇儲存位置：`.claude/workflows/`（位於專案中，會放進 git，團隊皆可使用）或 `~/.claude/workflows/`（個人專用，可用於任何專案）。我為它命名，例如 `pre-merge-review`，再按 Enter。

之後在任何工作階段中，都可以執行：

```bash
/pre-merge-review
```

工作流程就會以我除錯過的同一份程式碼啟動。

如果工作流程需要引數，請在儲存時的提示詞中說明；接著程式碼會將 `args` 作為全域變數接收。你可以傳入路徑清單、issue 編號、檔案 ID 或其他資料。

Anthropic 在[文件中](https://code.claude.com/docs/en/workflows#pass-input-to-a-saved-workflow)指出，引數會以結構化資料傳入：

<figure>
<blockquote>
<p>Claude 會將清單以結構化資料傳遞，因此程式碼可以直接呼叫 args 上的陣列與物件方法，不必先解析。</p>
</blockquote>
<figcaption>— Anthropic Docs，code.claude.com/docs/en/workflows#pass-input-to-a-saved-workflow</figcaption>
</figure>

也就是說，你可以直接在程式碼中使用 `args.map(...)`，不用解析字串。這對大量處理票單、資料夾或端點清單很有用。

## 如何停用 Ultracode，以及為什麼要停用

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="セクションの要点">

重點摘要

使用 `/effort high`（或你需要的其他等級）即可停用，工作階段會回到一般模式。若要永久停用工作流程，請使用 `/config` 中的「Dynamic workflows」切換選項，或設定環境變數 `CLAUDE_CODE_DISABLE_WORKFLOWS=1`。組織也可以透過受管理設定停用。

</div>

停用它的主要原因是要回到日常工作。如果你為一項大型任務切換到 Ultracode，任務完成後就立刻切回：

```bash
/effort high
```

否則，你接下來的小型編輯也會以工作流程執行，白白消耗 token，沒有任何好處。

若只想用關鍵詞啟動，應保持 Dynamic workflows 開啟，工作階段維持普通 effort（如 `/effort high`），只在選定任務加 `ultracode`。不要為此套用下方全域停用，它也會停用關鍵詞；若要禁止兩種流程，才使用以下全域選項：

```bash
# 在用戶端設定中
# /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。這會讓你比看任何文字說明都更實際地了解成本與效益。



## 出處

<div class="section" role="doc-bibliography" aria-label="出典">

### 出處

- [使用動態工作流程大規模協調子代理 - Claude Code Docs](https://code.claude.com/docs/en/workflows)
- [Claude Code 變更紀錄](https://code.claude.com/docs/en/changelog)

</div>

另請參閱：

- [Claude Code 的動態工作流程：如何協調數百個平行代理](https://ailoot.ai/blog/zh-hant-tw/claude-code-dynamic-workflows/)
- [Claude Code 的多代理：如何讓子代理平行處理](https://ailoot.ai/blog/zh-hant-tw/claude-code-parallel-worktree-agents/)
- [Claude Code 的例行工作：使用排程而非 cron 自動化](https://ailoot.ai/blog/zh-hant-tw/claude-code-routines/)
- [Claude Code 中的 Sonnet 或 Opus：不同任務該使用哪個模型](https://ailoot.ai/blog/zh-hant-tw/claude-code-model-effort-sonnet-opus/)
- [Claude Code 與 Codex 的目標模式：設定目標並朝目標推進](https://ailoot.ai/blog/zh-hant-tw/goal-mode-claude-code-codex/)



認識 [Ailoot](https://ailoot.ai/)。

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

### 如何只在刻意使用關鍵詞時，才啟動 workflows？

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

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

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


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。