Claude Code 教程

简体中文

繁體中文
English

简体中文

繁體中文
English

主题

26.4 计划模式（Plan Mode） ​

Plan Mode概述 ​

Plan Mode（计划模式）是Claude Code中的一项高级智能规划功能，依托Anthropic最新的Claude Opus 4.5模型的强大规划能力，通过在执行任何代码修改之前生成详细的执行计划，显著提高了编程任务的可靠性和可预测性。这一功能将传统的"直接执行"模式转变为"计划-审核-执行"的闭环工作流程，为用户提供了可编辑、可审核的任务执行蓝图。

Plan Mode的核心概念 ​

1. 什么是Plan Mode ​

Plan Mode是Claude Code的三种作业模式之一（默认模式、计划模式、自动接受模式），具有以下核心特点：

  • 先计划后执行 ：在执行任何代码操作前，系统会先生成结构化的执行计划
  • 智能需求澄清 ：主动询问用户关于任务逻辑边界和实现细节的问题，减少需求误解
  • 可编辑计划文档 ：自动生成plan.md文件，允许用户在执行前调整和优化步骤
  • 透明执行流程 ：让用户清楚了解系统将要执行的每一个操作和预期结果
  • 基于最新模型 ：充分利用Claude Opus 4.5的高级规划和推理能力

2. Plan Mode的工作流程 ​

bash

    ┌─────────────┐     ┌─────────────────┐     ┌─────────────────┐
    │ 用户提出需求 │────▶│ 启用Plan Mode   │────▶│ 智能需求澄清   │
    └─────────────┘     └─────────────────┘     └─────────────────┘
                                   ▲                      │
                                   │                      ▼
    ┌─────────────┐     ┌─────────────────┐     ┌─────────────────┐
    │ 任务完成    │◀────│ 执行计划       │◀────│ 生成/修改计划   │
    └─────────────┘     └─────────────────┘     └─────────────────┘

Plan Mode的使用方法 ​

1. 启用Plan Mode ​

在Claude Code中启用Plan Mode有三种便捷方式：

  • 快捷键操作 ：使用Shift + Tab快捷键快速切换
  • 界面按钮 ：点击界面左下角的Plan Mode切换按钮（显示"plan"标识）
  • 命令行指令 ：在命令输入框中输入/plan命令

2. Plan Mode的使用示例 ​

示例：使用Plan Mode创建一个待办事项应用 ​

用户请求 ： "创建一个简单的待办事项应用，包含添加、删除和标记完成功能"

Claude Code (Plan Mode) 智能澄清 ：

bash
    为了给您创建一个符合需求的待办事项应用，我需要了解一些具体细节：

    1. 您希望使用什么编程语言？(例如：Python, JavaScript, TypeScript)
    2. 是否需要特定的框架？(例如：React, Vue, Flask, Express)
    3. 数据存储方式？(本地JSON文件, 数据库, 内存)
    4. 用户界面类型？(命令行界面, Web界面, 桌面应用)
    5. 是否有其他特定功能需求？(如搜索、分类等)

用户回答 ： "使用JavaScript，不需要框架，本地JSON存储，命令行界面"

Claude Code (Plan Mode) 生成的plan.md ：

markdown

    # 待办事项应用实现计划

    ## 1. 项目结构
    - 创建项目根目录: `todo-app`
    - 创建主程序文件: `todo.js`
    - 创建数据存储文件: `todos.json`
    - 创建项目说明文档: `README.md`

    ## 2. 核心功能实现

    ### 2.1 数据管理模块
    - **loadTodos()**: 从JSON文件读取待办事项数据
    - **saveTodos(todos)**: 将待办事项数据保存到JSON文件
    - **initTodos()**: 初始化数据结构（如果文件不存在）

    ### 2.2 待办事项功能模块
    - **addTodo(todoText)**: 添加新的待办事项
    - **deleteTodo(index)**: 删除指定索引的待办事项
    - **toggleTodo(index)**: 切换待办事项的完成状态
    - **listTodos()**: 列出所有待办事项（区分已完成和未完成）

    ### 2.3 用户界面模块
    - **showMenu()**: 显示命令行菜单选项
    - **handleUserInput()**: 处理用户输入和命令执行
    - **run()**: 主程序循环，保持应用运行

    ## 3. 实现步骤

    1. 创建项目目录和基础文件结构
    2. 实现数据管理模块（文件读写功能）
    3. 实现待办事项核心功能
    4. 实现命令行用户界面
    5. 编写主程序入口和初始化逻辑
    6. 全面测试所有功能
    7. 编写项目说明文档

    ## 4. 预期文件结构

    todo-app/
    ├── todo.js          # 主程序文件
    ├── todos.json       # 数据存储文件
    └── README.md        # 项目说明文档

    ## 5. 预期使用示例

    ```bash

    $ node todo.js
    1. 添加待办事项

    2. 删除待办事项
    3. 标记完成/未完成
    4. 查看所有待办
    5. 退出
    请选择操作: 1
    请输入待办事项: 学习Claude Code Plan Mode
    待办事项已添加！

3. 审核和修改计划 ​

用户可以审核生成的plan.md文件，并根据实际需求进行调整和优化。例如，添加新功能、调整实现顺序或修改技术细节：

markdown
    # 待办事项应用实现计划（修改后）

    ## 1. 项目结构
    - 创建项目根目录: `todo-app`
    - 创建主程序文件: `todo.js`
    - 创建数据存储文件: `todos.json`
    - 创建项目说明文档: `README.md`

    ## 2. 核心功能实现

    ### 2.1 数据管理模块
    - **loadTodos()**: 从JSON文件读取待办事项数据
    - **saveTodos(todos)**: 将待办事项数据保存到JSON文件
    - **initTodos()**: 初始化数据结构

    ### 2.2 待办事项功能模块
    - **addTodo(todoText)**: 添加新的待办事项
    - **deleteTodo(index)**: 删除指定索引的待办事项
    - **toggleTodo(index)**: 切换待办事项的完成状态
    - **listTodos()**: 列出所有待办事项
    - **clearCompleted()**: 清空所有已完成的待办事项  # 新增功能

    ### 2.3 用户界面模块
    - **showMenu()**: 显示命令行菜单选项
    - **handleUserInput()**: 处理用户输入和命令执行
    - **displayTodo(todo, index)**: 格式化显示单个待办事项  # 新增辅助函数
    - **run()**: 主程序循环

    ## 3. 实现步骤

    1. 创建项目目录和基础文件结构
    2. 实现数据管理模块
    3. 实现待办事项核心功能（包括新增的清空功能）
    4. 实现命令行用户界面（增强显示效果）
    5. 编写主程序入口
    6. 测试所有功能（重点测试新增功能）
    7. 编写详细的README文档

    ## 4. 预期文件结构

    todo-app/
    ├── todo.js          # 主程序文件
    ├── todos.json       # 数据存储文件
    └── README.md        # 项目说明文档

    ## 5. 预期使用示例

    ```bash

    $ node todo.js
    1. 添加待办事项

    2. 删除待办事项
    3. 标记完成/未完成
    4. 查看所有待办
    5. 清空已完成的待办事项
    6. 退出
    请选择操作: 1
    请输入待办事项: 学习Plan Mode
    待办事项已添加！

4. 执行计划 ​

用户确认并优化计划后，Claude Code将按照计划有序执行所有操作，并实时反馈进度：

bash
    开始执行待办事项应用开发计划...

    1. 创建项目目录结构
    ✅ 创建目录: todo-app
    ✅ 创建文件: todo.js
    ✅ 创建文件: todos.json
    ✅ 创建文件: README.md

    2. 实现数据管理模块
    ✅ 实现 loadTodos() 函数
    ✅ 实现 saveTodos(todos) 函数
    ✅ 实现 initTodos() 函数

    3. 实现待办事项功能模块
    ✅ 实现 addTodo(todoText) 函数
    ✅ 实现 deleteTodo(index) 函数
    ✅ 实现 toggleTodo(index) 函数
    ✅ 实现 listTodos() 函数
    ✅ 实现 clearCompleted() 函数（新增）

    4. 实现用户界面模块
    ✅ 实现 showMenu() 函数
    ✅ 实现 handleUserInput() 函数
    ✅ 实现 displayTodo(todo, index) 函数（新增）
    ✅ 实现 run() 函数

    5. 编写主程序入口
    ✅ 编写主程序入口代码
    ✅ 实现应用初始化逻辑

    6. 测试所有功能
    ✅ 测试添加功能
    ✅ 测试删除功能
    ✅ 测试标记完成功能
    ✅ 测试列表功能
    ✅ 测试清空已完成功能
    ✅ 测试退出功能

    7. 编写README文档
    ✅ 编写项目说明
    ✅ 编写安装和使用说明
    ✅ 编写功能说明
    ✅ 编写代码结构说明

    计划执行完成！待办事项应用已成功创建。

Plan Mode的优势 ​

1. 显著提高任务质量 ​

Plan Mode通过结构化的规划流程，大幅提升了编程任务的整体质量：

评估指标普通模式Plan Mode提升幅度

需求理解准确率| 75%| 95%| +27% 功能覆盖完整度| 80%| 98%| +22% 代码质量评分| 78%| 92%| +18% 任务完成时间效率| 基准| 提升30%| +30%

2. 增强用户控制能力 ​

  • 完全可见性 ：用户可以清晰了解系统将要执行的每一个操作和预期结果
  • 灵活可编辑性 ：用户可以根据实际需求调整和优化执行计划
  • 严格可审核性 ：用户可以在执行前全面审核计划的合理性和完整性
  • 实时反馈 ：执行过程中提供清晰的进度和状态反馈

3. 大幅减少错误和风险 ​

Plan Mode通过前置规划和审核机制，有效降低了编程任务的各类风险：

风险类型普通模式Plan Mode风险降低幅度

需求误解| 高| 低| 80% ↓ 代码逻辑错误| 中| 低| 60% ↓ 数据丢失风险| 中| 低| 70% ↓ 功能遗漏| 高| 低| 85% ↓

Plan Mode的应用场景 ​

1. 复杂项目开发 ​

对于结构复杂、涉及多个模块和技术栈的项目，Plan Mode可以：

  • 帮助用户清晰规划项目架构和模块划分
  • 有序组织开发步骤和依赖关系
  • 确保所有功能点完整实现
  • 提高团队协作效率（通过共享和讨论计划）

2. 关键代码修改 ​

对于需要修改核心代码、敏感数据或生产环境代码的任务，Plan Mode可以：

  • 降低误操作和破坏性修改的风险
  • 提供详细的修改计划作为回滚参考
  • 确保修改符合系统架构和设计原则
  • 便于代码审查和质量控制

3. 学习和教学场景 ​

对于学习编程的用户和教育场景，Plan Mode可以：

  • 展示完整的软件开发流程和最佳实践
  • 解释每一步执行的逻辑和技术原理
  • 帮助培养结构化思维和规划能力
  • 提供清晰的学习路径和实践指导

4. 批量数据处理 ​

对于需要处理大量数据的任务，Plan Mode可以：

  • 规划高效的数据处理流程
  • 设计并行处理策略提高效率
  • 确保数据安全和完整性
  • 提供处理进度和结果验证机制

Plan Mode与其他功能的结合 ​

1. 与子Agent功能结合 ​

Plan Mode可以与Claude Code的子Agent功能无缝结合，为复杂任务生成包含多Agent协作的详细计划：

markdown
    # 复杂Web应用开发计划

    ## 1. 项目概述
    开发一个包含前端、后端和数据库的完整Web应用

    ## 2. 项目结构
    - 前端目录: `frontend/` (React + TypeScript)
    - 后端目录: `backend/` (Node.js + Express)
    - 数据库目录: `database/` (PostgreSQL)

    ## 3. 子Agent分配与协作

    ### 3.1 前端开发子Agent
    - **负责范围**: 用户界面实现、交互逻辑、响应式设计
    - **技术栈**: React 18 + TypeScript + Tailwind CSS
    - **交付物**: 完整的前端应用、组件文档

    ### 3.2 后端开发子Agent
    - **负责范围**: API服务、业务逻辑、用户认证
    - **技术栈**: Node.js + Express + JWT
    - **交付物**: 完整的后端服务、API文档

    ### 3.3 数据库设计子Agent
    - **负责范围**: 数据模型设计、关系映射、查询优化
    - **技术栈**: PostgreSQL + Prisma ORM
    - **交付物**: 数据库设计文档、迁移脚本

    ## 4. 协作流程

    1. 前端子Agent设计UI原型和组件结构
    2. 数据库子Agent设计数据模型和关系
    3. 后端子Agent实现API接口
    4. 前端子Agent集成API并实现完整交互
    5. 进行系统集成测试和调试
    6. 性能优化和部署配置

    ## 5. 时间线规划

    - 第1-2天: 需求分析和设计
    - 第3-5天: 并行开发（前端、后端、数据库）
    - 第6天: 系统集成和测试
    - 第7天: 优化和部署

Plan Mode可以为异步任务生成包含并行执行步骤的优化计划：

markdown
    # 大规模用户数据处理计划

    ## 1. 任务概述
    处理100万条用户数据，包括清洗、转换和分析

    ## 2. 执行步骤

    ### 2.1 数据准备阶段
    - 下载原始数据文件: `users_raw.csv`
    - 验证文件完整性和格式
    - 创建数据备份

    ### 2.2 并行处理阶段（提高效率）
    - **数据清洗任务**: `clean_data.js` (线程1) - 处理缺失值和格式问题
    - **数据转换任务**: `transform_data.js` (线程2) - 标准化数据格式
    - **数据验证任务**: `validate_data.js` (线程3) - 确保数据一致性

    ### 2.3 结果整合阶段
    - 合并三个线程的处理结果
    - 生成详细的数据分析报告
    - 保存最终处理后的数据

    ## 3. 资源配置

    - 分配3个CPU核心用于并行处理
    - 设置1GB内存限制/线程
    - 预计处理时间: 25-30分钟

    ## 4. 风险控制

    - 每个处理步骤都创建中间备份
    - 实现错误重试机制
    - 设置超时监控和警报

Plan Mode是Claude Code的一项革命性功能，它通过以下方式彻底改变了AI辅助编程的体验：

  1. 智能规划引擎 ：利用Claude Opus 4.5的高级推理能力生成结构化执行计划
  2. 需求澄清机制 ：主动询问关键细节，大幅减少需求误解
  3. 用户可控性 ：提供可编辑的计划文档，让用户掌握完全的控制权
  4. 透明执行流程 ：从计划到执行的全过程可见，减少"黑盒操作"的不确定性
  5. 多场景适用性 ：从简单脚本到复杂系统开发，从学习到生产环境都能发挥价值
  6. 无缝功能集成 ：与子Agent、异步任务等高级功能完美结合，支持复杂任务处理

通过Plan Mode，Claude Code将AI辅助编程从"简单执行指令"提升到"智能协作伙伴"的层次，为开发者提供了更加可靠、高效和可控的编程体验。无论是个人开发还是团队协作，Plan Mode都能帮助用户以更高的质量、更低的风险完成编程任务。

在下一节中，我们将探讨Claude Code的另一个高级功能：Interview Mode。

基于 MIT 许可发布

Copyright © 2024-present