Anthropic 在 Claude Code 2.1.267（changelog 日期 2026 年 9 月 9 日）加入 maxEffortLevel。原文是：caps the effort level on every provider, including Bedrock, Vertex and Foundry；可以写在顶层，也可以按模型写在 modelSettings 下。用户仍可选更低档，不能超过上限。同版本还修了一处：自定义 command、skill 和 subagent 的 effort: frontmatter，在默认 effort 仍被钉死的模型上会被忽略——点名 Opus 4.7、Opus 4.8 和 Fable 5。现在这条 frontmatter 会生效。
平台团队原先的摩擦是：CLI 里谁都能把 effort 拉到最高，子代理再继承同一档，账单和延迟在长任务里失控。组织策略如果只挡模型名，挡不住同一模型的更高思考预算。本文只写这条封顶：它改的是“能选多高”，不是“代码是否写对”。
AI Coding 交流群
如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。
发生了什么
2.1.267 把 effort 从个人偏好收成可策略化的上限。maxEffortLevel 是硬顶：全局一份，或按模型分别写。changelog 特意写 every provider，并列出 Bedrock、Vertex 和 Foundry，避免“本地 settings 封顶、云上绕过”。用户侧仍可在上限以下选择，这和把 effort 锁死成单一值不是一回事。
同一版本的 frontmatter 修复决定了封顶能不能真正落地。在此之前，若模型默认 effort 被钉死，command、skill、subagent 文件头里的 effort: 会被忽略，文档写了低档也不生效。修复之后，这些声明会按文件执行，但仍不能突破 maxEffortLevel。两者一起看：组织设顶，任务文件设低于顶的值，运行时取被允许的那一档。changelog 点名的钉死默认模型是 Opus 4.7、Opus 4.8 和 Fable 5，说明问题出在“模型自带默认档”而不是“用户不会写文件头”。
2.1.267 还有一项与提示词迭代相关、但不是本文主事件的开关：--system-prompt-snapshot off 会在每次请求重新渲染 system prompt。它改变的是提示词缓存行为，不是 effort 上限，这里只作边界说明，避免和封顶混用。
完整工作场景：长任务不再默认拉满
输入是一次会拉高思考预算的任务，例如跨仓库排障或长时重构。操作从“开发者在会话里选最高 effort，子代理跟着走”变成：管理员或用户在 settings 写 maxEffortLevel，必要时在 modelSettings 里给贵的模型单独更低的顶。会话、自定义 command、skill、subagent 只能 ≤ 上限。2.1.257 起 /effort 已支持会话级 s（只对当前会话生效，类似 /model）；有了硬顶之后，会话级选择也不能越过组织或用户设置的上限。
交付仍是代码和工具调用，但反馈变了：账单和延迟的上限可以在策略层解释，而不只靠事后对发票。若某个 skill 声明了更高 effort，运行时应被卡住或降到上限，而不是静默超标。人仍要看 diff 和测试；封顶只限制思考预算，不代替验收。
一个可核对的验收动作：把 maxEffortLevel 设到低于你平时使用的档，再跑一条带 effort: frontmatter 的 skill；确认实际 effort 不超过上限，并在 Bedrock 或 Vertex 通道上重复一次，避免只在 Anthropic 直连环境里测。第二条验收：在被点名的钉死默认模型（例如 Fable 5）上跑带低档 effort: 的 command，确认文件头不再被忽略，同时也不能高于封顶。
为什么这会改变工作流
因果是预算从“模型名单”下沉到“思考档位”。只禁用某模型的组织，仍可能在允许的模型上把 effort 拉满，子代理再并发放大。changelog 把云厂商写进同一句，说明封顶必须跟着请求走，而不是只写在本机 JSON 里当摆设。对同时走 Anthropic API 和 Bedrock 的团队，这是同一条策略能否执行的关键。
frontmatter 修复让“这个 skill 用低 effort”终于可执行。以前文件头是文档，运行时仍用被钉死的默认值；现在任务作者可以给例行检查低档、给罕见迁移高档，只要不超过组织顶。费用治理因此能写进仓库里的 skill 文件，而不是只写在 wiki。按模型的 modelSettings 则允许“便宜模型可以高、旗舰模型必须低”，不必全局一刀切。
限制与人接管点
封顶不会提高代码质量，也不会减少错误补丁。人仍要在合并前看测试和 diff。changelog 没有说默认开启某个具体数字，组织必须自己选顶；选太低会让复杂任务变差，选太高等于没策略。本文不编造 effort 枚举的内部数值，以你安装的 2.1.267 设置为准。
2.1.269 的 claude plugin eval、2.1.265 的文件夹 --plugin-dir、2.1.268 的 WebFetch 300 秒超时，都是相邻版本的独立事件，不要拼进这篇。Containment Escape 属于 2.1.257，也不是 effort 封顶。若组织同时用托管策略和用户 settings，以实际加载顺序为准，冲突时先看 /status 或 claude doctor 的策略诊断（2.1.261 已加入策略加载失败原因），而不是假设本地文件一定赢。并发子代理数量由后来的 CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 控制，那是 2.1.269 的环境变量，不能当成 2.1.267 封顶的一部分。
试用时不要把封顶理解成“自动选最便宜的模型”。changelog 只限制 effort 档位，不替你换模型。模型选择仍走原来的 /model 或策略名单。把两者当成一件事，会在事故复查里说不清账单到底来自模型单价还是思考预算。
若 settings 加载失败，封顶不会生效。2.1.261 起 /status 和 claude doctor 会显示组织策略为什么没加载；封顶验证应先确认策略已加载，再看会话里的实际 effort。
第一次落地建议只对一个模型写 modelSettings 上限，观察一周账单和失败任务，再推广到全局顶。不要第一天就全员一刀切。
如何试用
把 Claude Code 升到 2.1.267 或更高，在 settings 设置 maxEffortLevel，必要时按模型写 modelSettings。用一条带 effort: 的 skill 或 subagent 验证“可低于、不可高于”。若走 Bedrock、Vertex 或 Foundry，在同一条任务上复测。不要把封顶当成可以关掉代码审查的理由。升级后先看 changelog 里 frontmatter 修复是否覆盖你在用的模型，再把组织顶写进托管配置。
信息来源
开发必备：API 全流程管理神器 Apifox
介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具，Apifox 是目前提升研发效率的首选。
如果你正在开发项目，不妨试试其极其友好的界面设计，它完全兼容 Postman 和 Swagger 数据格式，导入数据非常方便，，即使是新手也能很快上手，点击这里即可注册使用。
值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。
获取专属报价与部署方案
详细的私有化部署系统架构与安全白皮书
针对您公司规模的专属报价单
免费的 1v1 专属产品演示 (Demo) 机会
