在 Claude Code 中,计划模式(Plan Mode) 可以说是高阶玩家最常使用的"杀手级"功能。
在默认模式下,Claude 像一个急躁的初级程序员,听到需求就立刻开始改代码;而在计划模式 下,Claude 会化身为一位资深架构师 。它会被限制为只读权限(不能修改代码、不能运行危险命令、不能提交 Git/SVN),只负责阅读代码、理清逻辑、向你提问确认细节,并最终输出一份结构化的"实施计划"。
以下是开启和使用计划模式的完整指南:
1. 如何进入计划模式?
你有三种方法可以唤醒这个模式:
-
方法一:在对话中快捷切换(最常用) 在启动
claude后的交互界面中,直接按下Shift + Tab键。 这会循环切换权限模式(Normal 正常模式 -> Auto-Accept 自动接受模式 -> Plan Mode 计划模式)。当底部状态栏显示⏸ plan mode on时,即代表切换成功。 -
方法二:启动时直接进入 在终端输入:
claude --permission-mode plan -
方法三:单次无头指令 (Headless) 如果你只想让它在后台静默生成一份计划就退出,可以运行:
claude --permission-mode plan -p "分析当前鉴权模块的逻辑,并提供一份迁移到 JWT 的重构计划"
2. 标准的"计划驱动"工作流
Anthropic 官方推荐的最佳实践是 Explore (探索) -> Plan (计划) -> Implement (实施) 工作流。具体怎么玩?
第一步:下达宏观任务 在计划模式下,告诉它你的终极目标。
"我想在这个 SVN 项目里新增一个支付网关模块,请阅读现有的 payment 目录并帮我规划。"
第二步:互动与答疑 (AskUserQuestion) Claude 会开始疯狂读取你的本地文件(通过 cat、grep 或自定义的 svn 搜索指令)。如果遇到模糊的边界条件,它会主动停下来问你:
"我注意到老的支付接口依赖了
UserConfig类,新模块还需要保持向下兼容吗?" 你可以直接回答它的问题,帮助它完善上下文。
第三步:生成计划 (Plan File) 当 Claude 收集完所有信息后,它会在后台生成一份详细的 Markdown 计划文件(这是它在计划模式下唯一被允许写入的文件)。这份计划会列出:
-
需要修改哪些关键文件(附带路径)。
-
具体的修改步骤和代码结构设计。
-
潜在的风险或后向兼容性问题。
第四步:切回模式,一键执行 如果你看完计划觉得非常靠谱,再次按下 Shift + Tab 切换回 Normal(正常模式) 或 Auto-Accept(自动接受模式),然后对它说:
"计划很完美,请严格按照这份计划开始写代码吧。"
3. 什么时候"必须"用计划模式?
-
接手屎山/全新代码库时:不要让它瞎改,先用计划模式让它理清调用链路和架构模式("请画出这个模块的依赖关系")。
-
跨多文件的复杂重构:如果一个功能涉及修改 5 个以上的文件,直接改极容易发生上下文遗忘(Context 满了)。先出计划,再按步骤实施,成功率会翻倍。
-
防翻车(节省 Token 成本):写错代码再让它回滚,会浪费大量的 API Token。计划模式能确保它真正理解了需求再"动刀子"。