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 和需求直接发送到您的公开待办清单。

继续阅读