Effort 等级完全拆解：ultrathink 的真相与推理深度的正确控制方式

旧系统：固定 Token 预算（2025 年 v1 时代）

We recommend using the word 'think' to trigger extended thinking mode... These specific phrases are mapped directly to increasing levels of thinking budget: 'think' < 'think hard' < 'think harder' < 'ultrathink'.

新系统：Effort 等级 + 自适应推理（2026 年）

五个等级的实际行为

max 的特殊性：session 限定，谨慎使用

1. 只对当前 session 生效，关闭 session 后失效。不能写入 settings.json 的 effortLevel 字段（该字段只接受 low/medium/high/xhigh）
2. 容易过度思考：官方文档明确标注「may show diminishing returns and is prone to overthinking」——对大多数编码任务，xhigh 的实际输出质量与 max 差别有限，但成本差距可能显著

ultrathink：唯一保留的特殊关键词

• 在 prompt 中任意位置出现 ultrathink → Claude Code 识别为特殊指令，对该 turn 触发 high effort 推理
• 仅影响当前 turn，完成后恢复 session 的常规 effort 设置
• 不会升级到 xhigh 或 max——无论你的当前 session effort 是什么，ultrathink 的上限就是 high
• 如果 session 的 effort 已经是 high 或以上，ultrathink 实际无效果

ultrathink 这个认证流程的 token 刷新逻辑为什么会在并发请求下产生竞争条件？追踪 src/auth/ 里的完整调用链

ultrathink 对比三种架构方案的优劣，我需要决定用 event sourcing 还是 CQRS

ultrathink vs 持久 effort 设置：选哪个？

设置方式与优先级

CLAUDE_CODE_EFFORT_LEVEL 环境变量（最高优先级）
    ↓
/effort <level> 当前 session 设置
    ↓
settings.json 的 effortLevel 字段（持久化，接受 low/medium/high/xhigh）
    ↓
模型默认（Opus 4.8: high，Opus 4.7: xhigh，Opus 4.6 & Sonnet 4.6: high）

• /effort auto：把 session 的手动设置清除，回到模型默认值。注意：对 Opus 4.7 来说这会回到 xhigh，不是降低 effort
• /effort 在模型切换后不会自动重置，手动切了模型后记得重新确认 effort 设置
• ultracode（/effort ultracode）是另一个特殊选项：在 xhigh 推理的基础上额外触发动态工作流编排，让 Claude 自动规划多 Agent 协作方案。仅限当前 session，不写入 settings.json

如何观察当前的 effort 状态

1. 状态栏（如果你配置了 statusline）：会实时显示当前 effort，如「with low effort」
2. /status 命令：显示当前模型和账号信息，含 effort 等级
3. /model 选择器：左右方向键可以直接调整 effort 滑动条，同时完成模型和 effort 的确认

实际运营建议

// settings.json（持久化适中设置）
{
  "effortLevel": "medium"
}

---

tools:
  - Read
effort: low
---