AI Agent / 系统课时
使用计划模式
使用计划模式
计划模式适合“先研究、后改动”的任务:Claude Code 可以读取代码、搜索引用并用只读命令收集证据,但不会直接修改源文件。你最终得到的不是一堆猜测,而是一份可审查、可反馈、可批准后再执行的实施计划。
学习目标
- 进入 Claude Code 的 Plan mode,并确认工作区在分析阶段没有被修改。
- 把模糊需求改写成包含范围、方案、风险和测试的计划请求。
- 判断一份计划是否足够具体,知道何时继续规划、何时批准执行。
计划模式把分析和写入分开
普通改动最容易出错的地方,不是代码写不出来,而是在影响范围尚未查清时就开始编辑。Plan mode 把“读取证据、形成方案”和“真正写文件”拆成两个阶段:先探索仓库,再提交计划,只有你批准后才进入修改阶段。

这种模式特别适合跨模块重构、陌生代码库、接口变更和风险较高的修复。若只是已经明确到单个文件和单行逻辑的小改动,规划成本可能高于收益。
进入计划模式并给出可审查任务
开始前先确认工作区是否干净;已有未提交改动不一定要删除,但必须知道它们不是 Claude 本轮产生的。然后从 CLI 直接以计划模式启动:
git status --short
claude --permission-mode plan预期输出
<git status --short 无输出>
<Claude Code 启动,当前状态显示 Plan mode>如果第一条命令有输出,应先辨认这些现有改动。会话中也可以用 Shift+Tab 循环进入 Plan mode,或在单次提示前使用 /plan。
进入后不要只说“帮我看看怎么改”。一条有效的计划请求应同时约束问题和交付物,例如:
先不要修改文件。请分析“订单取消后需要恢复库存”这项变更:定位入口、调用链和库存写入位置;比较至少两种可行方案;指出推荐方案需要改哪些文件或符号、为什么;列出需要新增或调整的测试以及可能的回归风险。信息不足时先标出未知项,不要猜测。
这类提示让 Claude 的搜索有明确终点:不是“读很多文件”,而是建立足以支撑实施方案的证据链。
审查计划里的证据和边界
计划是否可执行,可以看四件事。首先,改动位置要具体到文件与关键符号,而不是只写“修改订单模块”。其次,每个改动都应能对应需求或已发现的调用关系。再次,测试范围要覆盖直接行为和受影响调用方。最后,计划要明确风险、未知项以及验证方法。
当方案仍有分歧时,继续给反馈,例如要求比较事务边界、兼容性或最小改动面,而不是让 Claude 立刻编码。计划模式的价值就在于把方向错误暴露在写文件之前。
从计划切换到执行
计划通过审查后,再选择合适的批准方式进入执行;批准会结束计划阶段并让 Claude 按所选权限模式开始编辑。如果你暂时不想执行,可以继续规划,或用 Shift+Tab 离开 Plan mode 而不批准当前计划。
执行前最后确认三点即可:要改哪些文件、为什么改这些位置、用什么测试证明改对了。计划能回答这三问,才真正把“先想清楚”转化成了可控的代码变更。