Claude Code 计划模式怎么用:先审方案,再动代码
Claude Code 计划模式怎么用?本文讲清启动命令、快捷键、默认配置、计划编辑和批准流程,梳理它与自动模式的关系及绕过权限检查时的例外。通过结账与续费共享计价逻辑的重构示例,展示如何保留现有行为、分步迁移调用方,并安排验证和回滚,帮助你判断哪些任务值得先做规划,哪些明确的小改动可以直接执行。
发布于

Claude Code 计划模式(Plan Mode)让你有机会在改动波及多个文件之前,先纠正重构、迁移或功能设计中的问题。方案尚未明确,或影响会跨越模块边界时,值得先做规划。对于小而明确的修复,多一轮规划讨论反而可能更费时间。
真正有价值的是批准之前的那一步:发现遗漏的调用方、保住现有接口约定,或者删掉一项没必要的数据库改动。详细的计划只有能改变决策,才值得花时间做。
Claude Code 计划模式能做什么?
Plan Mode 会让 Claude 先调查代码库,再提出修改方案。它可以读取文件、运行命令来了解项目,也可以编写计划。通常,在你批准之前,源码修改会被拦截。可以把它理解为装修前先审图,确认方案后再拆墙。参见 Anthropic 的规划工作流说明。
文档明确列出了一个重要例外:在交互式终端会话中,只要绕过权限检查的模式可用,Plan Mode 的拦截限制就不会生效。 Claude 仍会收到先做规划的指令,但如果它尝试修改文件,操作仍可能执行。通过 --allow-dangerously-skip-permissions 让绕过权限检查的模式可用,也属于这种情况,即使没有把它选为当前模式。如果你希望源码修改必须经过批准,启动时就不要启用绕过权限检查的能力。参见 Anthropic 的权限模式规则。
规划流程和权限系统各有分工:计划说明 Claude 准备改什么,权限模式决定哪些操作可以不经询问直接执行。

如何进入和退出计划模式?
在终端中,可以直接以 Plan Mode 启动:
claude --permission-mode plan如果会话已经启动,可以使用下列操作。切换时看模式指示器,不要只记按了几次快捷键。
从 auto 开始循环切换时,依次会进入 default(手动)、acceptEdits 和 plan。之后是当前可用的可选模式:先是绕过权限检查,最后是 auto。对于 Windows,Anthropic 文档说明,如果 Node 或 Bun 运行时没有启用 VT 输入模式,可以改用 Alt+M。参见模式切换说明、快捷键参考和命令参考。
Claude 给出计划后,你可以在批准提示中选择:
- No, keep planning(否,继续规划):给出具体的修改意见。
- Yes, manually approve edits(是,手动批准修改):认可方案,同时逐项审阅代码修改。
- Yes, and use auto mode(是,并使用 auto 模式):批准方案,并在 auto 模式可用时以该模式继续。
如果 auto 模式不可用,自动执行选项会改为自动接受修改。如果会话启动时启用了绕过权限检查,该选项就会切换到绕过权限检查的模式。选择前要看清提示中写的是哪种模式。批准计划会退出 Plan Mode,并按所选权限开始实施。用 Shift+Tab 切换也会退出计划模式,但不会批准这份计划。参见计划批准后的行为。
在编辑器界面里怎么操作? 在 VS Code 中,点击提示输入框下方的模式指示器,选择 Plan。在 Desktop 的 Code 标签页中,使用 Send 按钮旁的模式选择器。JetBrains 则是在内置终端里使用 CLI 控件。更新日志还记录了 VS Code 从 v2.1.280 开始支持直接输入 /plan。参见界面操作说明和官方更新日志。
计划模式有哪些值得配置的选项?
要让某个项目的终端会话默认进入 Plan Mode,把下面的配置合并到 .claude/settings.json:
{
"permissions": {
"defaultMode": "plan"
}
}如果要设置用户级的终端默认模式,改用 ~/.claude/settings.json。启动参数的优先级高于设置文件,项目设置或托管设置也可以覆盖用户默认值。VS Code 有独立的启动设置:在 VS Code 用户设置中加入 "claudeCode.initialPermissionMode": "plan"。扩展不会从项目设置中读取启动时的权限模式。参见启动模式配置。
下面这些附加配置项应放在 Claude Code 设置的顶层,而不是 permissions 内部:
这几项设置相互独立,分别决定计划存在哪里、规划期间如何审查命令,以及批准时是否提供清空对话的选项。参见设置参考、计划存储说明和清空上下文选项。
如果选择清空上下文,就要把约束条件、尚未解决的决策和验收标准写进计划本身。否则,实施时所依赖的讨论内容已经不在上下文里了。
计划模式与自动模式如何配合?
Plan Mode 把是否开始实施的决定留给你审阅。auto 模式则通过一个独立的分类器模型评估操作,减少常规权限确认。分类器检查操作是否涉及权限问题;你审阅计划时,要判断的是设计方案有没有解决正确的问题。
当 auto 模式可用,且 useAutoModeDuringPlan 保持启用时,分类器也会审查规划期间的 shell 命令。通过审查的命令会执行,未通过的会被拦截。如果 auto 不可用,或关闭了这项设置,内置只读命令集之外的命令就会改为请求确认。删除关键路径另有处理规则,而交互式终端中绕过权限检查的例外优先适用。处于计划模式,并不意味着所有 shell 命令都是只读的。 参见规划期间的命令规则。
实施阶段,default 表示手动审阅;acceptEdits 会自动允许范围内的修改和常见文件系统命令,但有文档列明的例外;auto 则增加了后台操作审查。这些模式都无法替你判断架构方案是否合理。Claude Code 自动模式指南对权限模式的选择有更详细的说明。
当前文档写明,从 v2.1.283 开始,auto 是交互式终端和 VS Code 会话内置的启动模式,但仍受配置、组织策略和可用性规则影响。因此,明确设置以 Plan Mode 启动仍然有意义。参见当前启动模式规则。
旧教程可能遗漏重要变化。Anthropic 更新日志记载:v2.1.72 为 /plan 增加了任务描述参数;v2.1.81 开始默认隐藏清空上下文选项;v2.1.218 则在规划期间启用 auto 时,让分类器处理那些无法确定是否只读的 Bash 命令。参见官方更新日志。
重构示例:统一计价逻辑,保持扣费行为不变
来看一个具体的重构场景:应用在 API 中计算结账价格,在后台任务中计算续费价格。你想共用计价规则,同时保留各调用方现有的舍入和折扣行为。下面是一份示意计划,不代表在真实仓库中测试过,也不保证 Claude 一定会给出这样的结果。
进入 Plan Mode,把真正的约束说清楚:
/plan 提取结账与续费共用的计价策略。先检查调用方和现有测试。保持当前扣费金额、舍入方式、折扣应用顺序和错误行为不变。列出涉及的文件、实施顺序、验证方法和回滚方案。如果调用方之间存在差异,请明确指出,不要擅自统一。暂时不要实施。
假设项目中的相关文件如下:
一份看似合理的初稿,可能会建议提取通用计算函数、切换两个调用方、删除旧辅助函数,再更新测试。听起来很整齐,却漏了关键问题:如果结账和续费的舍入时机不同,怎么办?
接受计划之前,先修改它。 审阅时按 Ctrl+G,用下面的修订意见替换过早删除旧代码的步骤:
保留现有计价函数作为兼容适配层,直到两条调用路径都通过验证。先记录当前行为,再修改实现。明确保留结账和续费各自的舍入方式,不要在这次重构中将它们统一。只有对比测试通过后,才能删除旧实现。数据库结构变更不在本次范围内。
保存计划并返回。如果方案仍需调整,选择继续规划,让 Claude 按这条修订意见重新梳理整份计划。目的是消除前后矛盾的删除步骤,而不是在它下面补一句警告。直接编辑计划和继续规划,都是文档明确支持的工作流程。参见 Anthropic 关于探索、规划和编码的建议。
修订后的计划应该形成一套可以执行的步骤:
- 记录现有行为。 为当前结账和续费金额补充测试用例,覆盖舍入边界、折扣和无效输入。任何尚不明确的预期结果,都要先厘清再继续。
- 通过适配层引入共享策略。 保留各现有函数的输入、输出和错误行为,明确表达调用方之间的差异。
- 分步迁移调用方。 先更新结账逻辑并验证,再更新续费逻辑。不要把无关的代码清理混进来。
- 验证结果。 运行项目实际使用的计价、API 和后台任务检查,然后执行常规类型检查与集成检查。审阅差异,确认对外响应或扣费语义是否发生变化。
- 保留回滚路径。 验证成功前,保留兼容层这一边界。将删除废弃代码拆成独立、可审阅的步骤。

在这个例子中,批准时选择手动审阅修改。实施完成后,对照计划检查实际改动和测试结果。计划里写了要测试,并不代表验证已经完成;真正运行这些检查之前,它仍只是一份提案。
这里节省成本的方式很具体:在两个调用方及其测试都被重写之前,先发现行为变化。没必要为此编一个节省 token 的百分比。
哪些任务最值得先做规划?
优先考虑那些早期设计错误会扩散的任务。按我判断的潜在价值排序,以下场景最值得先走一遍规划流程:
这些是建议的工作流程,不是测量所得的结果。它们遵循 Anthropic 的建议:方案尚不明确、改动跨越多个文件,或者不熟悉代码时,先做规划。对于错别字、一条明确的日志语句,或范围清楚的重命名,直接要求修改即可。参见 Anthropic 建议何时使用规划。
估算成本时,要对比两种工作流程。直接执行,可能等到已经投入实施和审阅时间之后,才发现方向错了。先做规划,则是在前面增加调查和审阅计划的时间,换取避免这类返工的可能。
当规划所需的人力成本与额外模型使用成本之和,低于它预计能避免的返工成本时,规划才划算。 这是一条决策原则,不是 Anthropic 发布的节省成本基准。请用自己的工程成本和实际用量判断。如果计划只是复述一项你已经能精确描述的改动,就跳过它。
围绕计划模式,哪些产品值得做?
最有潜力的方向是面向团队的重构审阅包:把一项拟议改动整理成方便审阅者使用的材料,包括文件关系图、需要保留的接口约定、验收检查和回滚说明。工程负责人可能愿意为不同开发者之间更一致的工作方式付费,尤其是在改动共享业务逻辑时。
2026 年 10 月 12 日获取的 DataForSEO 美国关键词估算数据显示,“code refactoring tools” 的月搜索量为 170 次。这只能说明有人关注这类工作,且需求信号不大,并不能证明搜索者愿意购买计划审阅产品。最小可用产品可以接收导出的计划和仓库文件关系图,检查是否遗漏调用方、是否存在缺乏依据的假设,再生成拉取请求说明。难点在于:Claude Code 已经能生成通用计划。产品必须提供针对团队的检查,并产出有用的审阅材料,才有存在的价值。
更垂直的机会是为开发服务商提供迁移准备评估包:在升级报价前,生成受影响组件清单、分阶段上线检查表和待决事项清单。同一次 DataForSEO 查询估算,“code migration tools” 在美国的月搜索量为 20 次。这类商业查询的搜索量很小,因此应该先找现有客户验证需求,再考虑做覆盖面更广的产品。
最小版本可以专注于某一类迁移,并要求每项改动旁都附上适用的供应商文档链接。难点在于维护:针对具体版本的迁移规则很快就会过时。Plan Mode 可以辅助调查,但不会提供一套已经核实的迁移规则。这些是以搜索需求为依据的产品假设,不是营收预测。
Ultraplan 已停止提供
Anthropic 已移除 Ultraplan 研究预览,包括 /ultraplan、对应的关键词触发方式,以及批准计划时转到网页端用 Ultraplan 进一步完善方案的选项。相关页面说明,研究预览具有实验性质,可能根据反馈调整或移除。页面建议使用本地 Plan Mode 和 Claude Code 云端会话来完成规划工作。参见 Anthropic 当前的 Ultraplan 页面。
使用前,你可能还想知道这些
Claude 修改文件之前,我能先修改它的计划吗?
可以。审阅计划时,按 Ctrl+G 在默认文本编辑器中修改方案,或者选择继续规划并给出修正意见。批准之前,先读一遍修改后的计划。参见计划审阅操作说明。
计划模式会拦住所有可能产生改动的操作吗?
不会。规划期间仍可按文档规定的权限规则运行命令;如果交互式终端会话中绕过权限检查的模式可用,Plan Mode 的拦截限制就不会生效。应把它理解为一套具有特定权限行为的规划流程。参见 Plan Mode 权限说明。
批准计划后,Claude 就能自动修改文件了吗?
取决于你选择的批准选项。你可以批准方案,同时保留手动审阅修改;也可以按界面提供的自动模式继续。批准会结束规划阶段,选择时要看清选项标明的模式。参见批准选项说明。
只要涉及多个文件,就应该先做规划吗?
如果还需要确定方案、兼容性要求或验证方法,就值得先规划。如果只是规格明确的机械性改动,即使涉及多个文件,也可能不需要多少讨论。判断标准是:审阅能否改变实施决策。参见 Anthropic 的规划建议。
周一,遇到下一项涉及共享逻辑调用方的重构时,进入 Plan Mode,要求它列出需要保留的行为、受影响的文件、验证方法和回滚方案。批准前,先修正最站不住脚的假设。也可以结合 Claude Code 最佳实践中的建议,完善日常代码审阅习惯。
如果你的团队需要一套可重复执行的规划和审阅流程,我们可以帮你把它融入开发过程。
- 发布日期
- 分类
- Build
- 语言







