Claude Code 裡的 ultracode 是什麼?它做什麼,花多少

ultracode 是 Claude Code 的一個設定,不是強度檔位:開啟後,Claude 會為每個有分量的任務寫一個 dynamic workflow,也就是一個執行多個子代理的腳本。本文講怎麼開啟和關閉它、為什麼它不是 max 強度,以及同一次程式碼審查在 Opus 5.5 上跑兩遍的結果,一次用 xhigh,一次用 ultracode:令牌約為四倍,時間超過兩倍,而且在 claude -p 裡驗證結果始終沒有回來。

「What is ultracode in Claude Code」 在 Google 趨勢上已經連續十四個晚上上升,Google 現在還會推薦 「what does ultracode do in claude code」、「what does opus ultracode do」 和 「what does ultracode mode do」。回答這個問題的頁面互相矛盾:一個說它是最高的強度模式,另一個說它就是 xhigh。按今天的情況,兩者都不對。

簡短回答:ultracode 是 Claude Code 的一個設定,它讓 Claude 把每個有分量的任務組織成一個 dynamic workflow,也就是由腳本驅動的多個子代理,而不是在一段對話裡一輪一輪地做完。 它不是強度檔位,而且會消耗更多令牌。多多少,我們在一個真實任務上量過。

下文所有內容都在 2026 年 11 月 19 日核對過:Anthropic 的文件(code.claude.com 上的 Model configuration 和 Dynamic workflows 頁面)、Claude Code 的 changelog,以及我們機器上安裝的 Claude Code 2.1.318。

一段話說清 ultracode

dynamic workflow 是 Claude 為你的任務寫的一個 JavaScript 腳本。執行時在後台執行它:腳本啟動子代理,常常同時啟動好幾個,給每個代理分派它那部分工作,並把結果存在腳本變數裡,而不是堆進你的對話。開啟 ultracode 後,Claude 會自己判斷一個任務是否有分量到值得用工作流程,用 Anthropic 的話說,「一個請求可能連續變成好幾個工作流程:一個用來理解程式碼,一個用來做修改,一個用來驗證」。Anthropic 的模型配置頁面用一句話概括:ultracode 是「Claude Code 的設定,而不是模型的強度檔位」。

怎麼開啟,怎麼關閉

有兩種用法,持續的時間不一樣。

只用於一個任務:關鍵詞。 在你輸入的提示詞裡寫上 ultracode,例如 ultracode: audit every API endpoint under src/routes/ for missing auth checks。Claude Code 會高亮這個詞,Claude 只為這個任務寫一個工作流程,不改變會話的強度檔位。用你自己的話說「用一個工作流程」也行。如果是誤輸入,在 macOS 上按 Option+W,在 Windows 和 Linux 上按 Alt+W,就能取消這條提示詞的高亮。

用於整個會話:設定。

  • /effort ultracode 為當前會話開啟,/effort ultracode off 關閉。在 /effort 滑塊裡,Tab 切換 Ultracode 開關,Enter 應用。
  • claude --effort ultracode 以開啟狀態啟動會話,同時把強度檔位設為 xhigh。
  • 在設定檔案裡寫 "ultracode": true,每個會話都會開啟。Claude Code 會讀取這個鍵,但從不寫入它。

徹底停用。 在 /config 裡關掉 「Ultracode keyword trigger」,這個詞就不再啟動工作流程。在 /config 裡關掉 「Dynamic workflows」,或設定 "disableWorkflows": true,或設定 CLAUDE_CODE_DISABLE_WORKFLOWS=1,工作流程就會連同 ultracode 一起消失。組織可以在託管設定裡做同樣的事。

有兩種情況它根本不會出現:工作流程被關掉了,或者模型不支援 xhigh 強度。工作流程本身在所有付費套餐、Anthropic API 接入,以及 Amazon Bedrock、Google Cloud 和 Microsoft Foundry 上都可用;在 Pro 上,要先在 /config 裡開啟 Dynamic workflows 這一項。

ultracode 不是 max 強度

設定它改變什麼
low、medium、high一次模型呼叫在回答前想多少
xhigh推理更深,令牌花得更多
max最深的推理檔位,用於你希望不用你插手就能解決的難題
ultracode工作的組織方式:由多個代理組成的工作流程,強度沿用會話當前的檔位

強度檔位作用於每一次呼叫。ultracode 作用於工作的形態。你可以在 medium 下用 ultracode,也可以不開 ultracode 用 max。

這個混淆有來歷。dynamic workflow 在 2026 年 5 月底隨 Claude Code v2.1.154 推出,當時的觸發詞是 workflow。幾天後,v2.1.160 把關鍵詞改名為 ultracode。直到 9 月底的 v2.1.284,開啟 ultracode 都會同時把會話切到 xhigh,而選擇別的檔位會把它關掉。這就是為什麼夏天寫的那麼多頁面都說「ultracode 就是 xhigh」。從 v2.1.284 起,它是一個獨立的開關,在任何檔位下都保持開啟。唯一的遺留:啟動引數 --effort ultracode 仍會同時設為 xhigh。

開啟後有什麼變化

開啟 ultracode 就等於接受大規模執行,所以有三道保護會靜默:

  • 「Large workflow」 警告不再出現,它通常在一個工作流程計劃超過 25 個代理或預計超過 150 萬令牌時顯示;
  • 會話的併發子代理數量上限,不再約束 Claude 用 Agent 工具啟動的子代理;
  • 在 auto 權限模式下,第一次啟動工作流程不再需要你批准。

仍然有效的是規模建議和執行時上限。規模建議是 Claude 寫腳本時 Claude Code 交給它的參考:small 表示少於 5 個代理,medium 少於 10 個,large 少於 50 個。預設是 medium,Pro 套餐上是 small。你可以在 /config(Dynamic workflow size)裡或用 workflowSizeGuideline 鍵修改。執行時本身預設最多同時執行 16 個代理,單次執行超過 1,000 個代理會被拒絕。

執行期間,/workflows 會開啟它的進度檢視,顯示每個代理的令牌用量,你也可以在那裡停止它。

同一次審查,我們跑了兩遍

Anthropic 的文件說,ultracode 會讓每個請求消耗更多令牌、花更長時間。我們想在一個真實任務上得到自己的數字,於是把同一件工作跑了兩遍。

任務。 本網站自己的六個腳本,也就是我們的夜間代理用來檢查連結、翻譯和 IndexNow 提交的工具:三個 Python 檔案和三個 TypeScript 檔案,共 1,394 行。兩次執行的提示詞完全相同:審查這個資料夾,找出真正的 bug(邏輯錯誤、會導致崩潰的未處理錯誤、錯誤的邊界情況),不修改任何檔案,每個 bug 給出檔案、行號和一行修復方案,按嚴重程度排序。

環境。 Claude Code 2.1.318,帶 1M 上下文視窗的 Opus 5.5,一個臨時資料夾裡六個檔案的全新副本,唯讀工具(Read、Grep、Glob,外加 Agent 和 Workflow),規模建議設為 small,用 claude -p 啟動。執行 A 用 --effort xhigh。執行 B 用 --effort ultracode,如上所述,它同樣意味著 xhigh。同一個模型,同一個強度檔位:唯一的區別是 ultracode。

執行 A:xhigh執行 B:ultracode
實際耗時6 分 8 秒14 分 14 秒
代理1 個,即會話本身會話加 4 個工作流程代理
處理的輸入令牌99,400735,111
輸出令牌(其中思考)39,054(35,105)148,602(126,222)
這些令牌按標價的成本1.20 美元4.87 美元
命令輸出了什麼按嚴重程度排序的 14 個 bug一條說執行已開始的訊息

大部分輸入令牌是快取讀取(執行 A 為 47,730,執行 B 為 424,037)。成本一行是 Claude Code 在 JSON 輸出裡為這些令牌算出的標價:訂閱套餐不按令牌計費,這只是衡量這次執行從你的額度裡用掉了多少。

開啟 ultracode 後 Claude 做了什麼。 它先自己讀了這六個檔案,列出 23 個疑似 bug。然後寫了一個兩階段的工作流程腳本,遵守 small 建議:三個查詢代理並行,每組檔案一個(兩個相互關聯的 TypeScript 檔案、連結檢查器、三個 Python 腳本),再加一個質疑代理,它唯一的任務是嘗試駁倒每一個候選,包括 Claude 自己的那 23 個。這正是 Anthropic 文件描述的交叉核查模式,紙面上看,正是你對一次找 bug 的期待。

查詢代理找到了什麼。 23 條結果。它們覆蓋了執行 A 中所有要緊的 bug(永遠到不了 IndexNow 的新檔案、超過 10,000 個 URL 就被刪除的佇列、標題沒加引號時的崩潰、漏掉 zh-TW 的語言前綴去除、掩蓋孤立頁面的自連結),另外還有 8 條執行 A 沒報告的,大多嚴重程度低:在 JSX 屬性裡遇到第一個 > 就停下的 nofollow 檢查、遇到連字號就停下的 namespace 正則、把部落格文章漏在外面的審計。沒有執行 A 漏掉的嚴重問題。

始終沒有回來的東西。 在 claude -p 下,Claude 在後台啟動了工作流程,並以 「I'll send the final list, sorted by severity, when it finishes」 結束了這一輪。命令輸出的就是這句話。隨後程序等待,601 秒後退出,而質疑代理還在核查:驗證後的列表始終沒到,查詢代理的結果只能在 ~/.claude/projects/ 下這次執行的檔案裡讀到。在我們讀過的頁面裡,沒找到關於 -p 中後台工作等待上限的文件說明;這是我們在 2.1.318 上看到的情況。在互動式會話裡,對話保持開啟,執行結束後結果會回來。

我們的結論。 對一次單個會話就能完整讀完的六檔案審查,ultracode 用約四倍的令牌和兩倍多的時間,只換來八個低嚴重程度的額外候選,而且在腳本里沒有交出驗證後的列表。如果是審計整個程式碼儲存庫,一段對話裝不下所有檔案,帳就不一樣了。在這個任務上,普通的 xhigh 回報更好。

它消耗什麼,何時保持關閉

Anthropic 對代價說得很明白:開啟 ultracode 後,「每個請求都比不用工作流程的同一請求消耗更多令牌、花更長時間」,在訂閱套餐上,「開啟 ultracode 的會話會比關閉時做同樣的工作更早碰到會話上限或每週上限」。我們的執行只是一個任務上的一個資料點,不是基準測試,但指向同一個方向。

保持關閉:

  • 日常工作:改個名字、小修復、問一個關於程式碼的問題;
  • 你的 5 小時視窗或每週上限已經所剩不多時,因為一個請求可能連續變成好幾個工作流程;
  • 在腳本和定時任務裡:關鍵詞在那裡會被忽略,而我們用引數啟動的 claude -p 執行在驗證結果回來前就退出了;
  • 在 Pro 上,Anthropic 已經把預設規模設為 small。

要開啟,最好用關鍵詞只開一個任務,而不是整個會話:

  • 用於一段對話裝不下的大範圍工作:審計整個儲存庫、遷移數百個檔案、需要多個來源相互印證的調研;
  • 當你希望獨立的代理在你閱讀之前互相核查對方的結果。

大規模執行之前,文件自己的建議就是對的:先在一小部分上試執行工作流程,盯著 /workflows,令牌數失控就停止執行。

在 AgentsRoom 裡怎麼看一個 ultracode 代理

我們大部分代理都在 AgentsRoom 裡並排執行,而 ultracode 首先弄壞的就是我們自己產品裡的一樣東西。工作流程執行時,Claude Code 的主迴圈會回到它的提示符:唯一剩下的活動跡象是任務面板裡的一行進度,類似 6/7 agents done · 5m 45s · 411.6k tokens,或 「Waiting for 1 dynamic workflow to finish」。我們的狀態檢測把這個安靜的提示符讀成了「已完成」,在工作流程的子代理還在幹活時就把代理標成了空閒。現在 AgentsRoom 會讀取這行進度,所以執行工作流程的代理會在卡片上一直顯示「工作中」,桌面版和手機上都是,直到最後一個子代理返回。

如果你也這樣用,有兩點實用提醒:

  • AgentsRoom 用你為每個 CLI 選擇的預設推理強度啟動 Claude Code,從 low 到 max。ultracode 不在這些檔位裡,因為它本來就不是檔位:任務值得時,在代理的終端裡輸入 /effort ultracode,用完再輸入 /effort ultracode off。
  • 進度行會隨執行即時顯示令牌數。我們的令牌計數器在旁邊顯示會話的用量,而 5 小時視窗是一次長時間 ultracode 執行最先吃掉的東西。

常見問題

Claude Code 裡的 ultracode 是什麼?

Claude Code 的一個設定,不是推理強度檔位。開啟後,Claude 會為每個有分量的任務規劃一個 dynamic workflow:一個啟動多個子代理、在後台執行的簡短腳本,你的會話在此期間仍然可用。在輸入的提示詞裡寫關鍵詞 ultracode,只對那一個任務起同樣的作用。

ultracode 和 max 強度是一回事嗎?

不是。強度檔位決定一次模型呼叫想得多深。ultracode 決定工作怎麼組織,用多個代理代替一段對話。從 v2.1.284 起,它在任何強度檔位下都保持開啟;啟動引數 --effort ultracode 是唯一仍會順帶設為 xhigh 的地方。

怎麼開啟和關閉 ultracode?

一個任務:在你輸入的提示詞裡寫關鍵詞。整個會話:/effort ultracode 和 /effort ultracode off,或在 /effort 滑塊裡按 Tab。啟動時:claude --effort ultracode。每個會話:在設定檔案裡寫 "ultracode": true。/config 裡的 Ultracode keyword trigger 可以停用關鍵詞;disableWorkflows 會把工作流程和 ultracode 一起去掉。

ultracode 會消耗更多令牌嗎?

會。Anthropic 的文件說,用了工作流程,每個請求都會消耗更多令牌、花更長時間,在訂閱套餐上也會更早碰到會話上限或每週上限。在我們實測的一次執行中,在 Opus 5.5 上對六個檔案做同樣的審查,ultracode 產生了 148,602 個輸出令牌,普通 xhigh 是 39,054 個,按標價算成本約為四倍(4.87 美元對 1.20 美元),因為 Claude 先自己讀了這些檔案,又額外啟動了四個代理。

為什麼 ultracode 關鍵詞在 claude -p 或定時任務裡不起作用?

只有人親手輸入時,這個關鍵詞才算數:互動式提示詞、IDE 面板、Remote Control 客戶端,或把輸入標記為人工輸入的 Agent SDK 應用。在 -p、定時任務、webhook 或轉發的 pull request 評論裡,請改用 --effort ultracode 或 ultracode 設定。

ultracode 和 Claude Ultra 套餐或 ultrareview 有關係嗎?

沒有。Ultra 是 Anthropic 由 Max 20x 改名而來的訂閱,每月 200 美元。ultrareview 是由多個代理在雲端完成的程式碼審查(/code-review ultra),處於研究預覽階段,Pro、Max 和 Ultra 可免費執行三次,之後使用用量額度。ultracode 是你本地 Claude Code 會話的一個設定。

下載 AgentsRoom

在一個視窗中執行你所有專案的所有 AI 代理。

下載 AgentsRoom免費

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

把 Bug 和需求直接傳送到您的公開待辦清單。

繼續閱讀