🏠 总目录 📚 资料库模型选择

在 Claude Code 中选择模型与 effort 级别

⏱ 10 分钟 | ⚙️ 两个旋钮,别只转一个

🎯 一句话

模型选择与 effort 是两个不同设置。effort 引导投入程度,并非精确 token 预算;先排除上下文与环境问题,再在同一任务集上比较调节 effort 或更换模型的收益。

本页先解决:怎样分别调整模型与 effort,并在同一任务上比较?

Claude 博客资料库 · 模型选择

怎样分别调整模型与 effort,并在同一任务上比较?

能力与投入程度不是同一个设置;窗口里的信息也不会改变模型的冻结权重。

读完可以:分别调整能力与投入程度,在同一任务条件下比较收益,先排除上下文或环境问题。

📄 来自 Claude 官方博客
原文标题
Choosing a Claude Model and Effort Level in Claude Code(在 Claude Code 中选择模型与 effort 级别)
原文链接
https://claude.com/blog/claude-model-and-effort-level-in-claude-code
作者
Lydia Hallie(Claude Code 团队)
发布日期
2026-07-07
⚠️ 本页是原文的中文结构化整理笔记(保留架构、数据、案例、结论),并非逐字翻译。版本、参数与案例数字属于原文所示条件,不是本资料库的实测结果;产品状态与接口以实施时官方文档为准。
📑 本页目录

控制 Claude 输出质量有两个独立的旋钮:模型选择(决定能力上限)和 effort 级别(决定投入的彻底程度)。两者不可互换——理解各自的作用才能同时优化效果和成本。

能力与投入程度不是同一个设置;窗口里的信息也不会改变模型的冻结权重。

模型选择 = 能力,不是上下文

模型选择决定的是「用哪一组冻结的权重」处理你的请求。训练时模型学习模式并把知识编码进参数;推理时这些权重是只读的。你的提示词能引导模型,但无法扩展它的底层知识。

「如果 Claude 已经拿到了全部相关上下文、明显认真尝试过但仍然做错了,这就是该换更大模型的信号。」

Effort 级别 = 彻底程度与工作范围

与直觉相反,effort 不只是「思考时间」。它控制的是 Claude 整体投入多少工作——读多少文件、用多少工具、做多少验证步骤。更高的 effort 会在思考、工具调用和解释上产生更多 token,然后才回来找你确认。

Effort 是模型权重中习得的行为;该设置随每次请求传递,效果类似提示词的一部分。

决策框架和类比帮助定位问题,但 effort 不是精确的 token 预算旋钮。

决策框架

Claude 没做好时,先问:是知识不够,还是投入不够?

症状 该调什么
跳过了文件、跳过了测试、任务做一半就放弃 提高 effort
上下文完整却自信地做错了 换更大的模型

默认 effort 级别代表大多数人希望 token 消耗落在的位置。把 effort 当作总体偏好来设置,而不是逐任务调整。

形象类比

Effort 级别决定各自愿意在你的问题上花多少时间。

把成本变化放回同一任务集比较,先排除上下文和环境问题再调参数。

成本动态

Token 消耗随任务复杂度变化,结论并不直观:

结语

「先用默认值,再去拧旋钮。」

大多数工作不需要调整。只有结果不理想时才系统性诊断——而且要先确认上下文和任务表述本身没问题,再去动模型和 effort。


✅ 检查点

  1. 模型和 effort 分别控制什么?
  2. 什么情况下该调 effort 而不是换模型?
  3. 高 effort 的代价是什么?
👀 答案
  1. 模型决定能力上限(它最好能做到什么),effort 引导本次投入程度,可能影响思考、工具和输出 token,但不是精确 token 预算(这次实际用多少力)。⭐ 两者是独立的旋钮。
  2. ⭐ 当模型偶尔能做对、但不稳定,且已排除缺失信息和环境故障时——这说明能力是够的,缺的是思考深度,可把提高 effort 作为待验证方案,不能仅凭不稳定就保证更便宜或有效。反过来,如果无论试多少次都做不对,那是能力上限问题,才该换模型。
  3. 延迟和成本都上升,而且不是线性的。⚠️ 更值得注意的是:简单任务上高 effort 不但浪费,还可能变差——模型会把简单问题想复杂,产生过度设计的答案。⭐ effort 要按任务难度匹配,不是越高越好。

本节回顾

先记住这几件事

  • 模型选择与单次推理投入是不同变量。
  • 在同一组任务上比较成功率、延迟和总成本,再调整配置。
  • 高投入不保证更适合简单任务,也不能补上缺失的关键信息。