Claude Code 界面里有两个看起来都能"让结果更好"的旋钮：模型（model）和 effort 等级（effort level）。很多人随手乱调，或者调了一个本该调另一个的，最后花了更多 token，问题还是没解决。这篇文章把两者的区别讲清楚，并给出一张决策地图。
两个旋钮控制的是不同的东西
模型决定的是 Claude 的"智力上限"——哪个版本的 Claude 在处理你的请求。Haiku 快而轻，Sonnet 均衡，Opus 重型推理，Fable 是当前旗舰。选模型，等于选了一个不同天花板的队友。
Effort 等级决定的是 Claude 愿意在这个任务上"投入多少工作量"——它会读多少文件、用多少工具、在返回给你之前走多少步。同一个模型，effort 高时会多跑几次测试、追更多引用、在不确定时选择验证而不是猜测；effort 低时则更快收敛，不会过度发散。
一个形象的类比：模型是在雇哪个工程师，effort 是告诉他这件事你愿意让他花多少时间。
Effort 等级一览
Claude Code 目前支持以下 effort 等级（从低到高）：
| 等级 | 特点 | 适用场景 |
|---|---|---|
low |
token 少，响应快 | 简单查询、快速确认 |
medium |
均衡 | 一般编辑、解释代码 |
high |
更多推理，检查更细 | 中等复杂度任务 |
xhigh |
默认推荐，深度推理，不乱花 token | 大多数编码和 Agent 任务 |
max |
无上限推理，token 不设约束 | 极难调试、架构决策 |
auto |
Claude 自己按任务决定 | 懒得管的场景 |
Anthropic 团队内部的经验：日常任务用 high，复杂任务用 xhigh，真正卡住了再用 max。
xhigh 是官方推荐的默认等级，对绝大多数编码和 Agent 工作来说是最优的性价比点——比 high 更深，但不会像 max 那样在长 Agent 任务里无节制消耗 token，也不容易陷入过度反思。
max 的适用场景是"我知道这很难，我明确需要 Claude 把这个问题推到它的能力边界"，比如：
- 复杂 bug 的根因定位
- 涉及多个系统的架构决策
- 评估模型在特定场景下的能力上限
遇到问题，该调哪个？
这是最常见的困惑。一个简单的决策树：
Claude 已经拿到了所有信息，认真尝试了，结果还是错的 → 换更强的模型。问题在于"智力"，不在于投入时间。
Claude 显然没有把任务做完整：跳过了某个文件、没跑测试、重构做到一半就停了 → 调高 effort。问题在于工作量，不在于能力。
几个更具体的信号：
- Claude 只读了入口文件就给出了答案，没追依赖 → effort 太低
- Claude 一遍一遍确认同样的问题，迟迟不做决定 → max effort 过度反思，试试 xhigh
- Claude 把你的指令理解反了，或者在简单任务上犯了逻辑错误 → 换更强模型
- Claude 能理解问题但停在"这超出了我的能力"→ 换更强模型
模型选择基准
| 任务复杂度 | 推荐模型 |
|---|---|
| 日常辅助、快速问答 | Haiku / Sonnet |
| 标准编码任务、代码 review、重构 | Sonnet / Opus |
| 复杂架构、多文件协同、长 Agent 任务 | Opus / Fable |
| 你不确定的时候 | 先用默认（Fable），再降级省 token |
在混合场景里，Claude Code 支持为不同的子任务分配不同的模型——比如用 Haiku 做大量文件的探索，用 Fable 做最后的生成决策。这在多 agent 编排里能显著降低成本。
几个常见误区
“把 effort 调到 max 肯定比 xhigh 好” ——并不总是。max 更容易陷入过度推理，在本来不需要那么多步骤的任务里绕圈子，结果反而不如 xhigh 直接。
“模型和 effort 一起调” ——会让你不知道是哪个起了作用，下次遇到类似问题也不知道该怎么调。建议一次只动一个变量。
“任何时候都用最贵的组合” ——在 Agent 长任务里，这会导致 token 消耗暴涨且难以预测。把 xhigh + Fable 留给真正需要的地方，其他阶段用低等级过一遍再升级。
两个旋钮，各自管各自的事。模型决定天花板，effort 决定投入力度。搞清楚这一点，不只是省 token——更重要的是，下次出问题时你知道该往哪个方向调。
原文：Choosing a Claude model and effort level in Claude Code，发布于 Claude by Anthropic 官方博客，2026 年 7 月 7 日。
关于
关注我获取更多资讯
