Claude Code 账单的两个开关:档位开 high 还是 max,子 agent 写不写 model
据 Artificial Analysis 编码 Agent 指数 v2.1,Claude Code + Fable 5.2 开 high 得 58.2 分、每题约 $7.51;开 max 反而 55.7 分、每题 $44.22、耗时两小时以上(API 按量价)。再加上官方 sub-agents 文档:子 agent 不写 model 就跟主会话同模型。本文给出档位上限 maxEffortLevel、子 agent 按职责配模型、/tasks 自查与改后验收的做法;数字均来自原始页面,未复现。

Claude Code 账单的两个开关:档位开 high 还是 max,子 agent 写不写 model
前面几篇讲账单,都在讲「看」:《Claude Code 有笔比主对话还贵的暗账》 看状态栏,《先看见再省:Thinker 裁上下文 + CodeBurn 拆账单》 看每一笔花在哪。这篇讲两个直接决定每题花多少钱的开关:
- 推理档位(effort):low / medium / high / xhigh / max,越往上想得越久、token 越多。
- 子 agent 用什么模型:你没写
model:的话,帮你 grep、做总结的子 agent 默认跟主会话用同一个模型。
第一个开关的依据是一份第三方数据:Artificial Analysis(下称 AA)的编码 Agent 指数,把 Claude Code + Claude Fable 5.2 的五个档位各跑了一遍。第二个开关的依据是 Claude Code 官方的 sub-agents 文档。两部分的数字和规则都来自原始页面,我没有在自己的项目里复现。文中凡是「建议」,都是我根据这些材料给的做法,不是 AA 或 Anthropic 的结论。
一、先看数据:max 比 high 贵约 5.9 倍,分数反而低 2.5
AA 的 Coding Agent Index v2.1 由三个基准组成:FrontierCode-AA 2.0、Terminal-Bench 4.1、SWE-Atlas-QnA-AA,三项等权;每道题跑三次取平均。成本按当前按量计费的 API 价格折算(含缓存写入和缓存折扣),页面原话也提醒了:很多人是用订阅套餐而不是按 token 付费,所以这里的美元数不等于你的订阅额度消耗。
Claude Code + Claude Fable 5.2 五个档位,据 AA 页面(2026-11-16 读取):
| 档位 | 指数得分 | 每题平均成本(API 按量) | 每题平均耗时 |
|---|---|---|---|
| low | 48.0 | $2.49 | 13.4 分钟 |
| medium | 53.0 | $2.89 | 15.1 分钟 |
| high | 58.2 | $7.51 | 31.3 分钟 |
| xhigh | 58.5 | $15.47 | 53.3 分钟 |
| max | 55.7 | $44.22 | 129.5 分钟 |
按表里的数字算几组比值(我自己算的):
- low → medium:+5.0 分,成本只多约 16%(2.49 → 2.89)。
- medium → high:+5.2 分,成本约 2.6 倍,耗时约 2 倍。
- high → xhigh:+0.3 分,成本约 2.1 倍,耗时约 1.7 倍。
- high → max:−2.5 分,成本约 5.9 倍,耗时约 4.1 倍。
也就是说,在这套题上,分数在 high 附近就到顶了;再往上加档位,钱和时间涨得很快,分数基本不动,到 max 还掉了。
同一张榜上几个可以对照的配置(同样是 AA 页面数字):
| 配置 | 得分 | 每题成本 | 每题耗时 |
|---|---|---|---|
| Claude Code + Opus 5.5(max) | 58.2 | $12.61 | 65.3 分钟 |
| Claude Code + Sonnet 5.5(max) | 56.3 | $11.40 | 86.8 分钟 |
| Devin Fusion CLI(Opus 5.5 Max + GPT-6 Luna High) | 58.4 | $8.75 | 54.9 分钟 |
| Codex + GPT-6.1 Sol(max) | 52.2 | $1.51 | 21.9 分钟 |
| Claude Code + Haiku 5.5(max) | 29.6 | $2.25 | 77.4 分钟 |
Fable 5.2 开 high,和 Opus 5.5 开 max 同分(58.2),每题便宜约 $5。Haiku 5.5 那一行也要记住,第二部分会用到:便宜模型做完整的编码任务分数很低,但这不代表它干不了搜索、总结这类杂活。
读这份数据要注意的四点
- 测的是「harness + 模型 + 档位」的组合,不是单独的模型。换成你自己的工具链、你自己的仓库,结果可能不一样。
- 成本是 API 按量价。用 Claude 订阅的话,档位影响的是额度消耗速度和撞限额的频率,而不是这张表里的美元数。
- 「为什么 max 反而掉分」AA 没给结论。网上有「撞了时间上限」一类解释,我只在二手转述里见过,这里不当事实写。Anthropic 自己的模型配置文档对 max 的描述是:适合你希望 Claude 自己啃下来的难题(例如找安全漏洞),「可能出现收益递减、容易想过头,大范围采用前先测」。
- 页面上的配置名带「Default Fallback」。AA 页面数据显示,有一部分尝试因为模型拒答而走了回退:high 档在 SWE-Atlas-QnA 有 38/372 次、Terminal-Bench 有 13/198 次;max 档分别是 45/372 次和 18/198 次(SWE-Atlas-QnA 里记录的回退模型是 Claude Opus 4.8)。比例不大,但说明这几行并不全是 Fable 5.2 单独跑出来的。
二、开关一:把默认档位钉住,把 max 关进笼子
先弄清楚 Claude Code 现在怎么决定档位。据官方 模型配置文档,档位按下面的顺序取第一个生效的:
- 环境变量
CLAUDE_CODE_EFFORT_LEVEL - 会话里用
/effort或/model选的档位 - 启动参数
--effort - 设置文件里为该模型保存的档位,或
effortLevel - 模型自身的默认值:Fable 5.2、Opus 5.5、Sonnet 5.5、Haiku 5.5 默认都是 medium
文档还写了两个细节:
max除非通过CLAUDE_CODE_EFFORT_LEVEL设,否则只对当前会话生效,不会存成默认。- 档位刻度是按模型分别校准的,同一个名字在不同模型上代表的推理量不一样。所以上面那张表只能说明 Fable 5.2,不能直接套到别的模型上。
结合 AA 的数据和文档对各档位的说明,我的建议是这样分:
| 场景 | 建议档位 | 理由 |
|---|---|---|
| 改名、小改动、头脑风暴、每步你都会看 | low / medium | 文档原话:low 适合「你会逐条审结果」的快速交互;表上 low→medium 只贵 16% |
| 修已有代码里的 bug、要验证边界情况 | high | 文档对 high 的定位;表上 high 是分数到顶的那一档 |
| 一次都没修好、卡住的硬题 | 临时 xhigh | 表上比 high 只多 0.3 分但贵一倍,只在真卡住时用 |
| 让它自己长时间啃的难题 | max,先小范围试 | 文档自己说 max 可能收益递减;表上 max 比 high 贵 5.9 倍还低分 |
操作:三步把档位管起来
第 1 步:看当前用的是什么档。 运行 /effort status,或者看会话头里「with xxx effort」的字样。
第 2 步:给常用模型存一个默认档。 在交互会话里:
text
/effort high
直接输入档位名(或在滑块上按 Enter)会存成你对当前模型的默认;在滑块里按 s 则只对本次会话生效(文档注明需要 v2.1.257+)。
第 3 步:给档位设一个上限,防止误开 max。 maxEffortLevel 可以写在任何一层设置文件里(需要 v2.1.267+),比它高的档位一律按上限跑,包括 /effort、--effort、环境变量和子 agent 自己的 effort 字段:
写进 ~/.claude/settings.json:
json
{
"maxEffortLevel": "xhigh"
}
团队用的话,把它放进 managed settings 就是全组统一的上限;多处同时设置时取最低的那个,别的层级抬不上去。
如果某个模型你确实想放开,可以在同一个设置文件的 modelSettings 里给那个模型单独写 "maxEffortLevel": "max"——它只豁免这一份设置里的上限,其他来源(比如 managed settings)设的上限照样生效。具体字段格式见 settings 参考文档 的 maxEffortLevel 和 modelSettings 两节。
三、开关二:子 agent 不写 model,就跟主会话一样贵
这一项比档位更容易漏。据官方 sub-agents 文档:
By default, a subagent you define runs on the same model as the conversation that starts it.
也就是说,你主会话开的是 Fable,那些只负责搜代码、读日志、做总结的子 agent,没写 model: 的话也按 Fable 跑。文档在开头也写了,子 agent 的请求「计入和主会话相同的用量限额」,并且把「把任务路由到 Haiku 这类更快更便宜的模型来控制成本」列为子 agent 的用途之一。
子 agent 的模型按什么顺序决定
文档给的优先级,取第一个生效的:
- Claude 启动子 agent 时传的
model参数(只接受别名,如haiku) - 子 agent 定义文件里的
model字段(包括inherit) - 环境变量
CLAUDE_CODE_SUBAGENT_MODEL - 主会话的模型(嵌套子 agent 则是启动它的那个子 agent 的模型)
有三个坑要单独记:
- 只设
CLAUDE_CODE_SUBAGENT_MODEL不会改内置的 Explore 和 Plan。 想全部统一,要再设CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1(v2.1.257+)。开了 FORCE 之后,定义文件里的model字段和 Claude 传的参数都会被忽略;但 fork 和model: inherit的 skill 子 agent 仍跟父会话走。 - 内置 Explore 在主会话是 Fable 时会换模型:用 Claude 订阅、Anthropic Console 账号或经
ANTHROPIC_BASE_URL走网关时,Explore 改跑opus别名指向的 Opus;在 Bedrock、Google Cloud Agent Platform、Microsoft Foundry 等平台上,Explore 仍留在 Fable。 - thinking 设置没法单独给子 agent 设,它继承主会话;但档位可以:定义里写
effort字段即可。没写的话,子 agent 跟主会话同模型时用会话档位,换了模型则会话档位不适用。
操作:子 agent 三步自查
第 1 步:看子 agent 实际跑在哪个模型上。 子 agent 运行时执行 /tasks,每一行会写出模型名,有单独档位的也会标出来(v2.1.242+)。
第 2 步:给杂活子 agent 写上便宜模型。 例如一个只读的日志/代码检索 agent:
markdown
---
name: log-scout
description: Search code and logs, return only the relevant lines and a short summary. Use for read-only lookups.
tools: Read, Grep, Glob
model: haiku
effort: low
---
Search the files you are pointed at. Return file paths, line numbers and at most
10 lines of summary. Do not propose fixes.
放在项目的 .claude/agents/(团队共享,可提交进仓库)或 ~/.claude/agents/(个人所有项目)。按文档,修改已存在目录下的文件几秒内生效,第一次新建 agents 目录则需要重启。
如果想让探索也走便宜模型,文档给的办法是自己定义一个同名的 Explore,它会覆盖内置的那个并使用你写的 model:
markdown
---
name: Explore
description: Fast read-only codebase search.
tools: Read, Grep, Glob
model: haiku
---
Find the relevant files and symbols. Report paths and a short summary only.
第 3 步(可选):一刀切。 想让所有子 agent(包括 Explore、Plan、teammate、workflow agent)都用同一个模型,在设置文件的 env 里写(官方示例):
json
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
注意这是一刀切:需要强模型的子 agent(比如做代码修改的 general-purpose、做审查的 reviewer)也会被压到 Haiku。回看第一部分那张表,Haiku 5.5 即使开 max 在完整编码任务上也只有 29.6 分。所以我更建议的做法是按职责分:
| 子 agent 类型 | 建议 model | 理由 |
|---|---|---|
| 搜索、读日志、列文件、做摘要 | haiku | 只读、结果回到主会话再判断 |
| 写测试、做中等修改 | sonnet 或 inherit | 需要真正写代码 |
| 审查、找安全问题、关键改动 | inherit(跟主会话) | 这里省钱最容易省出返工 |
四、把两个开关合在一起:一份可抄的配置
下面是一份个人用的起点,按需改。~/.claude/settings.json:
json
{
"maxEffortLevel": "xhigh"
}
text
## 会话里
/effort high # 给当前模型存默认档
/effort status # 确认
/tasks # 子 agent 跑起来后看模型
再加上第三部分的 log-scout 和自定义 Explore 两个文件。这样做之后:
- 主会话日常在 high,卡住了临时
/effort xhigh,用完/effort high退回; - 不会有人或子 agent 误开 max(被上限压回 xhigh);
- 搜索、总结类子 agent 不再按主会话的大模型计费。
改完之后怎么验收
光改配置不算完,验收要看数据。建议对照前文 781 的拆账思路做一次前后对比:
- 改之前,挑 3–5 个你常做的同类任务,记下每次的 token 或费用(状态栏或你在用的账单工具)、用时,以及结果是否一次过。
- 改之后,同样的任务再跑一遍,用
/tasks确认子 agent 已经是你设的模型。 - 只在「一次过的比例没降」的前提下,才算省到了;如果 haiku 子 agent 总结漏了关键信息、导致主会话多跑几轮,那就把这个 agent 退回 sonnet。
这一步我没替你跑,也不给「能省 xx%」的数字——不同仓库、不同任务差别太大,AA 的表只能告诉你方向:档位过了 high 之后,多花的钱很难换回分数;子 agent 的模型不写,就默认按最贵的那个算。
小结
- 据 AA Coding Agent Index v2.1,Claude Code + Fable 5.2:high 58.2 分、每题 7.51;max 55.7 分、每题 44.22、两小时以上。分数在 high 附近到顶。
- Fable 5.2 在 Claude Code 里的默认档是 medium;
max默认只对当前会话生效。用maxEffortLevel给档位设上限。 - 子 agent 默认跟主会话同模型;优先级是调用参数 → 定义里的
model→CLAUDE_CODE_SUBAGENT_MODEL→ 主会话。只设环境变量不改 Explore/Plan,要统一得加_FORCE=1。 - 用
/tasks查子 agent 实际模型,按职责分配:杂活 haiku,写代码 sonnet/inherit,审查跟主会话。 - 改完做一次前后对比,以「一次过的比例不降」为前提再谈省钱。
参考来源
- Artificial Analysis,Coding Agent Index(含五档数据、方法说明、成本口径):https://artificialanalysis.ai/agents/coding
- Artificial Analysis,编码 Agent 评测方法论:https://artificialanalysis.ai/methodology/coding-agents-benchmarking
- Claude Code 文档,Create custom subagents:https://code.claude.com/docs/en/sub-agents
- Claude Code 文档,Model configuration(effort 档位、默认值、优先级):https://code.claude.com/docs/en/model-config
- Claude Code 文档,Settings reference(
maxEffortLevel、effortLevel、modelSettings):https://code.claude.com/docs/en/settings-reference - 本站前文:770 状态栏暗账、781 Thinker + CodeBurn 拆账单、777 七家 AI 编程套餐额度对照