主题
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。