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,400 | 735,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 代理。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。
继续阅读
如何在 Windows 上安装 Claude Code 和 Codex CLI
在 Windows 10 和 11 上安装 Claude Code、安装 Codex CLI 的确切 PowerShell、CMD、WinGet 和 npm 命令,什么时候该选 WSL,以及如何修复“'claude' 不是内部或外部命令”等你会遇到的错误。
阅读全文如何从 Git 提交中去掉 Co-Authored-By Claude
Claude Code 会给你的提交加上 Co-Authored-By 尾注,给你的 pull request 加上一行 Generated with Claude Code。去掉它们的设置、该放进哪个文件,以及如何清理已经推送的提交。
阅读全文Claude Code mod:它是什么,以及我们给每个代理都装上的那个 mod
mod 是一种让 JavaScript 在 Claude Code 内部运行的插件。它能做什么、由哪三个文件组成、如何加载和测试,以及我们给每个代理都装上的那个 mod。
阅读全文