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 梳理和改进项目结构。