计划模式 (Plan Mode)

计划模式是 Claude Code 的核心安全机制之一，它确保在执行复杂任务之前先制定详细的计划，避免意外的系统更改。

什么是计划模式

计划模式是 Claude Code 的一种特殊运行状态，在这种模式下：

这种机制特别适用于：

• 复杂的多步骤任务
• 涉及多个文件修改的操作
• 需要系统配置更改的任务
• 不确定影响范围的代码重构

计划模式的工作流程

1. 任务分析阶段

Claude 会首先：

• 分析用户的需求
• 探索相关的代码结构
• 识别需要修改的文件
• 评估潜在的影响范围

2. 计划制定阶段

基于分析结果，Claude 会制定包含以下内容的详细计划：

• 具体的执行步骤
• 需要修改的文件列表
• 预期的更改内容
• 可能的风险点和注意事项

3. 用户确认阶段

Claude 会向用户展示完整的计划，等待用户：

• 审核计划内容
• 提出修改建议
• 确认是否执行

4. 执行阶段

用户确认后，Claude 才会开始：

• 按计划执行代码更改
• 实时更新任务状态
• 处理执行过程中的问题

如何触发计划模式

计划模式可以通过以下方式触发：

自动触发

Claude Code 会在以下情况自动进入计划模式：

• 检测到复杂的多步骤任务
• 涉及系统配置文件的更改
• 可能影响多个文件的重构操作

手动触发

用户可以主动要求使用计划模式：

请使用计划模式帮我重构这个组件的状态管理

或者在 CLAUDE.md 中配置：

# 执行策略
- 对于涉及多个文件的更改，必须使用计划模式
- 重构操作前需要制定详细计划

计划模式的优势

🛡️ 安全性

• 避免意外的代码损坏
• 减少不必要的文件更改
• 提供执行前的最后检查机会

📋 可预测性

• 清楚了解将要进行的更改
• 评估更改的影响范围
• 提前识别潜在问题

🎯 精确性

• 确保所有步骤都被考虑到
• 避免遗漏重要的配置更改
• 保证任务的完整性

最佳实践

何时使用计划模式

如何优化计划质量

1. 详细描述需求

   请使用计划模式，将现有的 REST API 调用重构为 GraphQL，
   包括：认证机制、错误处理、数据格式转换

2. 指定约束条件

   重构时需要保持向后兼容性，不能破坏现有的测试用例

3. 明确期望结果

   完成后应该能够支持实时查询，并提高 20% 的性能

常见问题

Q: 计划模式会影响执行效率吗？

A: 虽然增加了计划阶段，但可以避免返工和错误修复，总体上提高了效率。

Q: 可以跳过计划模式直接执行吗？

A: 对于简单任务可以，但建议在复杂场景下始终使用计划模式。

Q: 如何在 CLAUDE.md 中配置计划模式策略？

A: 可以在项目的 CLAUDE.md 中添加执行策略部分，定义何时必须使用计划模式。

相关概念

• 自动计划模式 - 计划模式的自动化版本
• 主线程思维 - Claude Code 的核心思维模式
• CLAUDE.md 至上 - 配置优先的原则