Optimization

Claude Code Ultrathink 模式教程

学习在 Claude Code 中合理使用 ultrathink、effort 等级和 Plan Mode,处理架构决策、复杂调试和深度重构。

ultrathink 是 Claude Code 中用于单次深度推理的提示词关键词。它适合用在“方案质量比速度更重要”的任务里,比如架构规划、复杂 bug、迁移、支付认证和安全相关改动。

Ultrathink 的作用

需要更深一层推理时,可以在提示词任意位置加入 ultrathink

ultrathink 分析替换支付 webhook handler 的最安全迁移方案。先不要编辑文件。

按照当前 Claude Code 的模型配置文档,ultrathink 会为当前这一次请求增加深度推理指令,但不会修改整个会话的 effort 设置。它不是“万能质量开关”,也不能替代清晰上下文、明确约束和实际验证。

适合使用的场景

场景为什么适合
架构决策需要比较边界、取舍、风险和迁移路径。
复杂 bug先做根因分析,再决定是否改代码。
大型重构需要拆分探索、顺序、测试和回滚策略。
认证、支付、安全需要更谨慎地检查失败模式和权限边界。
数据模型调整需要考虑约束、迁移和兼容性。

如果只是文案调整、简单 CRUD 字段、单文件样式或明显 lint 修复,通常不需要使用 ultrathink

配合 Plan Mode 使用

高风险任务建议把 ultrathink 放在规划阶段,而不是直接进入编辑:

/plan ultrathink 分析从旧 auth middleware 迁移到新 guard 的方案。请列出影响文件、风险、测试命令和回滚步骤。

先审查计划,再批准执行。这样可以把深度思考留在方案阶段,让实际 diff 更容易控制。

用 Effort 控制整段会话

如果整段会话都需要更强推理,不要每条提示词都重复 ultrathink,可以使用 /effort 或模型设置:

/effort high

使用 /model 可以查看当前模型,并确认当前模型是否支持 effort 控制。可用等级取决于模型和 Claude Code 版本。

成本和速度控制

更深的推理可能带来更多 token 消耗和更长响应时间。建议控制范围:

  • 只在规划回合使用 ultrathink,不要每个实现回合都使用。
  • 编辑前先要求输出简短风险清单。
  • 把大型迁移拆成可审查的小步骤。
  • API 计费场景下用 /usage 检查使用情况。
  • 常规后续修改可以换成更快或更省的设置。

提示词模板

ultrathink 分析这个架构调整。请先梳理当前流程,再提出最小安全方案。不要编辑文件。
ultrathink 判断这个间歇性测试失败的原因。列出可能原因、需要检查的文件,以及第一个验证实验。
ultrathink 审查这个认证 diff 的安全风险。只关注真实攻击路径、缺失校验和回归测试。

相关页面

官方来源


下一步架构分析 - 用 Claude Code 梳理和改进项目结构。