Claude Code 计划模式怎么用:先审方案,再动代码

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 启动:

Bash
claude --permission-mode plan

如果会话已经启动,可以使用下列操作。切换时看模式指示器,不要只记按了几次快捷键。

想做什么具体操作
循环切换到计划模式按 Shift+Tab,直到状态栏显示 ⏸ plan mode on。
直接进入计划模式输入 /plan。
进入计划模式并指定任务在 /plan 后加上任务描述,例如 /plan extract the shared pricing policy。
亲自修改 Claude 提出的计划审阅计划时按 Ctrl+G,在默认文本编辑器中打开计划。
不批准计划,直接退出按 Shift+Tab 切换模式。

从 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:

JSON
{
  "permissions": {
    "defaultMode": "plan"
  }
}

如果要设置用户级的终端默认模式,改用 ~/.claude/settings.json。启动参数的优先级高于设置文件,项目设置或托管设置也可以覆盖用户默认值。VS Code 有独立的启动设置:在 VS Code 用户设置中加入 "claudeCode.initialPermissionMode": "plan"。扩展不会从项目设置中读取启动时的权限模式。参见启动模式配置。

下面这些附加配置项应放在 Claude Code 设置的顶层,而不是 permissions 内部:

配置项作用
"useAutoModeDuringPlan": false对规划期间执行、且不在内置只读命令集中的命令请求确认;绕过权限检查的例外仍然适用。默认值为 true。可通过用户、本地或托管设置配置;在 /config 中,该选项名为 Use auto mode during plan(规划期间使用 auto 模式)。
"plansDirectory": "./plans"将计划文件存放在相对于项目根目录的指定路径中。未设置时,保存到 ~/.claude/plans。如果指定的路径位于项目之外,会退回默认目录;使用正斜杠可以提高路径的跨平台兼容性。
"showClearContextOnPlanAccept": true在批准计划时增加一个选项:清空对话上下文,仅根据计划开始实施。默认值为 false。

这几项设置相互独立,分别决定计划存在哪里、规划期间如何审查命令,以及批准时是否提供清空对话的选项。参见设置参考、计划存储说明和清空上下文选项。

如果选择清空上下文,就要把约束条件、尚未解决的决策和验收标准写进计划本身。否则,实施时所依赖的讨论内容已经不在上下文里了。

计划模式与自动模式如何配合?

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 提取结账与续费共用的计价策略。先检查调用方和现有测试。保持当前扣费金额、舍入方式、折扣应用顺序和错误行为不变。列出涉及的文件、实施顺序、验证方法和回滚方案。如果调用方之间存在差异,请明确指出,不要擅自统一。暂时不要实施。

假设项目中的相关文件如下:

文件在本次改动中的作用
src/api/checkout.ts调用结账计算逻辑,保持现有响应结构。
src/jobs/renewal.ts在后台任务中计算周期性扣费。
src/pricing/checkout.ts现有结账规则和舍入逻辑。
src/pricing/renewal.ts现有续费规则和舍入逻辑。
src/pricing/policy.ts拟新增的共享计算逻辑,显式表达各调用方的差异。
tests/pricing.test.ts记录现有金额、折扣和边界情况。
tests/checkout.test.ts检查 API 契约。
tests/renewal.test.ts检查续费行为。

一份看似合理的初稿,可能会建议提取通用计算函数、切换两个调用方、删除旧辅助函数,再更新测试。听起来很整齐,却漏了关键问题:如果结账和续费的舍入时机不同,怎么办?

接受计划之前,先修改它。 审阅时按 Ctrl+G,用下面的修订意见替换过早删除旧代码的步骤:

保留现有计价函数作为兼容适配层,直到两条调用路径都通过验证。先记录当前行为,再修改实现。明确保留结账和续费各自的舍入方式,不要在这次重构中将它们统一。只有对比测试通过后,才能删除旧实现。数据库结构变更不在本次范围内。

保存计划并返回。如果方案仍需调整,选择继续规划,让 Claude 按这条修订意见重新梳理整份计划。目的是消除前后矛盾的删除步骤,而不是在它下面补一句警告。直接编辑计划和继续规划,都是文档明确支持的工作流程。参见 Anthropic 关于探索、规划和编码的建议。

修订后的计划应该形成一套可以执行的步骤:

  1. 记录现有行为。 为当前结账和续费金额补充测试用例,覆盖舍入边界、折扣和无效输入。任何尚不明确的预期结果,都要先厘清再继续。
  2. 通过适配层引入共享策略。 保留各现有函数的输入、输出和错误行为,明确表达调用方之间的差异。
  3. 分步迁移调用方。 先更新结账逻辑并验证,再更新续费逻辑。不要把无关的代码清理混进来。
  4. 验证结果。 运行项目实际使用的计价、API 和后台任务检查,然后执行常规类型检查与集成检查。审阅差异,确认对外响应或扣费语义是否发生变化。
  5. 保留回滚路径。 验证成功前,保留兼容层这一边界。将删除废弃代码拆成独立、可审阅的步骤。
建筑风格的流程图连接了保持行为、添加适配层、迁移调用方和验证各步骤,同时保留回滚路径。
修订后的计价计划先确保现有行为不变并保留回滚路径,再将调用方迁移到共享逻辑。

在这个例子中,批准时选择手动审阅修改。实施完成后,对照计划检查实际改动和测试结果。计划里写了要测试,并不代表验证已经完成;真正运行这些检查之前,它仍只是一份提案。

这里节省成本的方式很具体:在两个调用方及其测试都被重写之前,先发现行为变化。没必要为此编一个节省 token 的百分比。

哪些任务最值得先做规划?

优先考虑那些早期设计错误会扩散的任务。按我判断的潜在价值排序,以下场景最值得先走一遍规划流程:

场景计划需要解决什么审阅的价值在哪里
开发者提取共享业务逻辑梳理调用方、保持现有行为、分阶段迁移,就像前面的计价示例。在不兼容的假设进入多个模块之前发现它们。
创业者迁移到新的 API 或库盘点受影响的导入、配置、错误处理和测试,明确兼容性决策。安排实施顺序,让中间阶段也保持可用。
团队修改依赖数据库的功能拆开数据库结构、应用和部署步骤,明确兼容性与回滚要求。在代码默认新结构已经存在之前,暴露上线依赖。
开发者新增组织角色追踪 UI、API、授权规则和测试,明确每个角色允许执行哪些操作。让遗漏的权限校验成为可见的设计缺口。
维护者接手陌生子系统先说明入口、依赖和当前行为,再提出改动方案。在实施前纠正对代码库的错误理解。

这些是建议的工作流程,不是测量所得的结果。它们遵循 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
Devin 与 Claude Code 价格对比:个人和五人团队怎么选

Devin 与 Claude Code 价格对比:个人和五人团队怎么选

Devin 和 Claude Code 怎么选?本文对比云端任务委派、工程师主导的本地迭代、代码仓库集成与订阅费用,算清个人及五人团队的月账单,说明 Premium 席位升级何时让费用反超,并厘清额外用量、自动化计费和迁移条件,帮助创始人与技术负责人按实际工作流程选择 AI 编程工具。2026年10月12日Build
A2A 协议详解:与 MCP 的区别、协作机制和接入时机

A2A 协议详解:与 MCP 的区别、协作机制和接入时机

A2A 协议用于独立智能体之间的任务委派,MCP 则连接工具与数据。从供应商筛选出发,讲清 Agent Card、任务、消息与产物,梳理 v1.0 的兼容性变化及 Google ADK、LangSmith、CrewAI、Microsoft Foundry 的支持范围,帮助你判断接入时机,并规划授权、重试和结果验收。2026年10月12日Build
Cloudflare Workers 等 Deno Deploy 替代方案:价格对比与迁移指南

Cloudflare Workers 等 Deno Deploy 替代方案:价格对比与迁移指南

Deno Deploy 迁移该选哪家?比较 Cloudflare Workers、Netlify、Supabase、Vercel、Val Town 与自托管 Deno 的价格、免费额度和运行时限制,梳理 Deno KV、定时任务、队列及静态站点的迁移改造,帮助你先确定数据与调度方案,再安排代码部署、流量切换和回滚。2026年10月12日Build
Claude Agent SDK 入门:用工单分流任务搭建第一个 AI 智能体

Claude Agent SDK 入门:用工单分流任务搭建第一个 AI 智能体

把 Claude Code 的智能体循环接入自己的应用:本文讲清 Claude Agent SDK、Messages API 与 Claude Code 的选择,提供 Python 工单分流示例,并梳理内置工具、权限、项目配置、会话部署和计费说明,帮助团队从可人工验收的只读任务起步,评估自动化是否值得投入。2026年10月12日Build
tmux 配置指南:用 Claude Code 多开任务、远程重连

tmux 配置指南:用 Claude Code 多开任务、远程重连

这份 tmux 配置指南带你在远程主机上运行 Claude Code,为独立任务分配 Git worktree 和命名会话,合上笔记本后再通过 SSH 接回原会话。文中涵盖官方配置、常用切换命令、分屏智能体团队与排障要点,并说明会话保活、对话恢复和文件隔离各自解决什么问题,帮助你搭好可持续使用的远程开发工作流。2026年10月12日Build
Ollama vs vLLM 怎么选:从本地部署到高并发推理

Ollama vs vLLM 怎么选:从本地部署到高并发推理

Ollama vs vLLM 怎么选?围绕并发请求、GPU 显存、模型规模、量化格式和 API 兼容性,梳理本地部署与共享推理服务的取舍。两者自托管软件费用均为 $0,真正拉开成本的是硬件与运维。结合预算示例和迁移清单,判断何时保留 Ollama,何时评估 vLLM,并在切换前验证模型、延迟与回滚方案。2026年10月12日Build
Lovable vs Cursor:从 MVP 起步到代码接手,该选谁?

Lovable vs Cursor:从 MVP 起步到代码接手,该选谁?

Lovable vs Cursor 该怎么选?本文面向创始人和产品经理,对比 AI 编程工具的上手门槛、托管与数据库、代码所有权和维护责任,拆解 Lovable 价格与 Cursor 价格,并按单人开发、多人协作及交接月份计算订阅预算,说明如何通过 GitHub 接手代码,以及何时需要单独迁移后端。2026年10月11日Build
Ollama 和 LM Studio 对比:本地大模型部署怎么选?

Ollama 和 LM Studio 对比:本地大模型部署怎么选?

Ollama 和 LM Studio 对比,怎么选才适合本地大模型部署?本文从桌面体验、本地 API、无界面服务、GPU 与 Mac 支持、工作用途许可、隐私和云端费用分析,说明有状态 Responses 何时会改变选型,迁移前又该核对哪些设置。两者本地运行软件费用均为 $0,差异主要在工作流程、接口行为与授权边界。2026年10月11日Build
订阅通讯

每周日,一封信。写运转中的系统,不写热评。

每周一期。无垃圾邮件。随时退订。