Workflows
Claude Code Plan Mode 使用教程
学习用 Claude Code Plan Mode 先检查任务、比较方案、评估风险，再确认是否进入代码编辑。
Plan Mode 是处理非简单改动时更稳的 Claude Code 工作方式。它让 Claude 先检查项目、提出实施计划、列出风险，再进入文件编辑。
快速结论
只要任务涉及认证、支付、数据库、部署、共享架构，或者跨多个模块，就建议先用 Plan Mode。普通模式更适合文案、小样式和低风险单文件修改。
| 任务类型 | 是否建议先用 Plan Mode |
|---|---|
| 修正文案或错别字 | 通常不需要 |
| 调整小组件样式 | 通常不需要 |
| 新增 API route | 建议使用 |
| 修改认证、计费或权限 | 建议使用 |
| 跨模块重构 | 建议使用 |
| 数据库迁移或部署变更 | 建议使用 |
如何进入 Plan Mode
最明确的方式是使用 CLI permission mode：
claude --permission-mode plan在交互会话中，你的环境也可能支持：
/plan/permissionsShift+Tab切换权限模式
如果某个快捷方式不可用，先检查 Claude Code 版本和官方 permission mode 文档，不要把快捷键写成所有环境都固定可用。
Plan Mode 工作流
1. 先让 Claude 检查现状
请找出订阅升级流程涉及的文件，解释当前流程，先不要编辑文件。2. 要求输出可审查计划
请提出增加年度计费的最小安全方案，包含影响文件、数据模型变化、支付服务调用、测试命令和回滚步骤。3. 反问风险
这个方案里有哪些风险假设？会不会绕过已有服务、权限或支付边界？4. 一次只批准一步
只实现第 1 步，保持 diff 小，修改后运行相关测试命令。这样可以把方案和实现拆开，后续审查代码会轻很多。
一个好计划应该包含什么
| 部分 | 应该写清楚什么 |
|---|---|
| 当前状态 | 已检查文件、当前流程和已有约束。 |
| 改动方案 | 按实施顺序拆成小步骤。 |
| 风险 | 认证、数据、计费、迁移、性能或兼容性风险。 |
| 测试 | 明确命令或手工验证步骤。 |
| 回滚 | 改坏后如何恢复。 |
| 未确认问题 | Claude Code 无法从仓库确认的假设。 |
如果计划没有测试、忽略现有服务，或者一上来就大范围重写，应要求它重新收窄。
示例提示词
/plan 请分析当前 onboarding 流程，并提出增加“公司名称必填”步骤的最小安全方案。包含影响文件、校验变化、UI 状态、测试和回滚步骤。不要编辑文件。确认计划后再进入实现：
只实现第 1 步里的 validation 和类型改动，先不要改 UI。常见错误
- 把 Plan Mode 当成形式，没读计划就批准。
- 明明小改可以解决，却要求完整重建。
- Claude Code 还没梳理当前实现，就让它直接编辑文件。
- 接受忽略认证、支付或部署边界的方案。
- 第一条提示词里同时做架构探索和文件编辑。
相关页面
官方来源
下一步：Explore-Plan-Code - 把规划变成可重复的实现流程。