Skip to content

2.1 用 /plan 先想后做

学习目标:理解为什么不能直接让 AI 动手写代码;掌握 /plan 的完整使用流程;学会审阅计划、提出修改、确认执行的三步工作法。


先讲一个翻车现场

小张想给公司内部做一个任务管理工具。他打开 Claude Code,直接输入:

帮我做一个任务管理系统,要有用户登录、任务增删改查、分配任务、截止日期提醒。

Claude Code 立刻开始写代码。20 秒后,文件哗哗地创建出来。小张很兴奋——直到他打开项目一看:

  • 用了他完全不熟悉的技术栈(Vue 3 + Pinia,而他团队用的是 React)
  • 数据库选了 MongoDB,但公司标准是 PostgreSQL
  • 文件结构乱成一锅粥,routes、controllers、models 混在一起
  • 没有写任何测试
  • 最离谱的是,AI 用了一个已经废弃的 npm 包

小张花了整整一个下午清理这些代码,比自己从头写还慢。

问题出在哪? 不是 AI 不够聪明,而是你没告诉它"先想清楚再动手"。就像你不会让一个新来的实习生拿到需求就直接写代码一样——你得先让他出个方案,你看过了,点头了,他再开始干。

/plan 就是这个"先出方案"的机制。


/plan 是什么

/plan 是 Claude Code 的规划模式。激活后,AI 不会直接修改任何文件,而是先输出一份详细的实施计划,等你确认后才开始执行。

[截图: 在 Claude Code 中输入 /plan 后的界面变化,顶部出现 "Plan Mode" 标识]

两种进入方式:

bash
# 方式一:用斜杠命令切换到规划模式
/plan

# 方式二:直接在提示词里要求规划
请先给我一个实施计划,不要直接写代码

进入 Plan 模式后,你会在界面顶部看到一个标识,提醒你当前处于规划状态。此时无论你输入什么需求,AI 都只会输出计划,不会动你的文件。

[截图: Plan Mode 标识在终端顶部的显示效果]


正确的三步工作法

第一步:描述需求,让 AI 出计划

进入 Plan 模式后,像平时一样描述你的需求:

我要做一个 Todo App。
技术栈:React + TypeScript,用 Vite 构建。
功能:添加/删除/标记完成、按分类筛选、本地存储。

AI 会输出一份结构化的计划,通常包含:

  • 技术选型:用什么框架、什么库
  • 文件结构:会创建哪些文件,目录怎么组织
  • 实施步骤:先做什么、后做什么,分几个阶段
  • 注意事项:可能遇到的问题和解决方案

[截图: AI 输出的 Todo App 实施计划,包含文件结构树和分步说明]

第二步:审阅计划,提出修改

这是最关键的一步。不要看到计划就直接说"好,开始吧"。仔细看一遍,重点关注:

  • 技术栈对不对? AI 是否用了你想要的框架和工具?
  • 文件结构合不合理? 目录组织是否符合你的团队习惯?
  • 有没有遗漏? 你想要的功能是否都被覆盖?
  • 优先级对不对? 是不是先搭骨架再做功能?

发现问题直接提:

计划整体不错,但有几个地方改一下:
1. 状态管理不要用 Redux,用 Zustand,更轻量
2. 文件结构改成按功能模块组织,不要按类型分
3. 先做核心的增删功能,筛选和分类放到第二阶段

AI 会根据你的反馈修改计划,直到你满意为止。这个来回的过程可能需要 2-3 轮,但这几分钟的投入能省掉后面几个小时的返工。

[截图: 用户提出修改意见后,AI 更新了计划的对比效果]

第三步:确认执行

计划满意了,告诉 AI 开始干活:

计划确认,开始执行吧。

此时 AI 会按照你们共同敲定的计划,一步步创建文件、写代码。因为方向已经对齐,写出来的代码基本不会出现"方向性错误"——最多是细节需要调整,而不是推倒重来。

[截图: AI 按照计划逐步创建文件,终端显示执行进度]


实战:用 /plan 规划一个 Todo App

下面是一个完整的实战流程。跟着做一遍,你就能掌握这套工作法。

第一步,进入规划模式并描述需求:

bash
/plan
我要做一个 Todo App,具体需求:
- 技术栈:React 18 + TypeScript + Vite
- 核心功能:添加任务、删除任务、标记完成、编辑任务内容
- 数据存储:localStorage,页面刷新不丢失
- UI 要求:简洁美观,支持深色模式
- 代码质量:组件拆分合理,有基本的类型定义

第二步,AI 输出计划后,审阅并提出修改:

整体方案 OK,有两点调整:
1. 深色模式切换做成一个独立的 hook,方便复用
2. 任务数据的类型定义单独放一个 types.ts 文件

第三步,确认并执行:

好的,按这个方案执行。先从项目初始化和核心的 TodoItem 组件开始。

从这里开始,AI 就会按部就班地写代码。整个过程你始终掌控方向,AI 负责执行细节。


效率对比

维度不用 /plan(直接写)用 /plan(先想后做)
技术栈匹配靠运气,经常猜错计划里明确确认
文件结构AI 自由发挥,风格随机按你审批的结构来
返工次数3-5 次推倒重来很常见通常 0-1 次微调
总耗时(中型功能)2-3 小时(含返工)30-40 分钟(含规划)
心情指数焦虑、失控感从容、一切尽在掌握

小结

  • 永远不要让 AI 拿到需求就直接写代码,先规划再执行是基本纪律。
  • /plan 模式让 AI 输出计划而不动文件,你审阅确认后再执行。
  • 三步法:描述需求 → 审阅修改 → 确认执行,每一步都不能省。
  • 在规划阶段多花 5 分钟,能在执行阶段省 2 小时。
  • 养成习惯:任何超过 10 行代码的改动,都先 /plan

用 Claude Code 构建,用 VitePress 驱动