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
smolagents 教程:Python 代码智能体原理、沙箱与框架选型

smolagents 教程:Python 代码智能体原理、沙箱与框架选型

smolagents 如何用 Python 驱动 AI 智能体?了解两种智能体的区别、工具与模型的搭配,以及 Docker 示例的执行流程。本文梳理沙箱边界、权限与资源限制,并对比 LangGraph 和 OpenAI Agents SDK,帮助开发者判断何时适合动态组合代码,何时应采用持久化工作流或专职智能体协作。2026年10月31日Build
Warp Terminal 评测:先换终端,再决定要不要换 AI 编程助手

Warp Terminal 评测:先换终端,再决定要不要换 AI 编程助手

Warp Terminal 值得替换现有终端吗?本文拆解命令块、外部编程智能体集成与 Warp Drive,比较 iTerm2、Ghostty,并梳理套餐价格、平台计费、隐私设置、共享会话保留和离线限制。先保留 Claude Code 或 Codex,用实际任务判断终端体验是否改善,再决定是否更换智能体或推广到团队。2026年10月31日Build
Kilo Code 评测:多模型、云端任务与代码审查,值得换吗?

Kilo Code 评测:多模型、云端任务与代码审查,值得换吗?

Kilo Code 评测:梳理 VS Code、JetBrains、CLI 与云端智能体的工作方式,比较 Cline、Claude Code 等替代方案,拆解模型选择、共享账单、推理与计算费用,并说明云端配置、代码审查和数据路由的限制,帮助个人开发者与小团队判断,是否值得为一套相互衔接的开源 AI 编程工作流迁移。2026年10月31日Build
Amazon Bedrock AgentCore 架构详解:组件分工、适用场景与试点指南

Amazon Bedrock AgentCore 架构详解:组件分工、适用场景与试点指南

Amazon Bedrock AgentCore 能替代智能体技术栈中的哪些自建工作?本文梳理各组件的职责与适用场景,讲清执行隔离、会话归属、记忆、工具访问和业务权限的边界,并说明运行限制与区域支持如何影响架构。附 CLI 试点流程,帮助团队判断何时值得采用、哪些责任仍需自己承担,以及上线前该验证什么。2026年10月30日Build
投机解码实战:原理、性能边界与大模型推理加速配置

投机解码实战:原理、性能边界与大模型推理加速配置

投机解码如何让大模型更快输出,同时保留目标模型的采样行为?本文讲清草稿生成、精确验证与接受率,比较独立草稿模型、EAGLE 和 MTP,给出 vLLM、SGLang、TensorRT-LLM 配置示例,并说明并发、显存与草稿开销如何影响收益,帮助自建推理服务和托管 API 团队确定评估与上线条件。2026年10月30日Build
GPU云服务器怎么选?2026 年 7 家服务商价格与场景对比

GPU云服务器怎么选?2026 年 7 家服务商价格与场景对比

GPU云服务器怎么选?对比 Runpod、Lambda、CoreWeave、Vast.ai、Modal、Together AI 和 Google Cloud,梳理模型微调、无服务器推理与集群的适用场景。从显存需求、计费单位、冷启动、存储和传输费用到区域限制,帮你核算完整成本,判断该租机器、调用 API,还是预留算力。2026年10月30日Build
GitHub Copilot Fusion 怎么用?模型协作、档位与积分详解

GitHub Copilot Fusion 怎么用?模型协作、档位与积分详解

GitHub Copilot Fusion 如何选择并协调模型?本文梳理各客户端的开启方式、Standard、High 与 Max 档位,以及 AI 积分计费和官方基准的适用边界,并给出单仓库试用流程,帮助开发者和团队核对用量、审查完整代码差异,再决定是否将 Fusion 设为默认配置。2026年10月29日Build
Bright Data 评测:代理、网页抓取与 AI 数据采集怎么选

Bright Data 评测:代理、网页抓取与 AI 数据采集怎么选

Bright Data 评测:梳理代理、Web Unlocker、Scraper API、数据集及智能体浏览器的用途与计费差异,说明共享免费额度、住宅代理 KYC 和浏览器限制。结合价格监控成本模型,比较 Firecrawl 与 Browse AI,帮助开发和运营团队按所需输出、时效与维护职责选型。2026年10月28日Build
订阅通讯

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

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