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
Airtable 替代品怎么选?NocoDB、Baserow 等工具的价格与适用场景

Airtable 替代品怎么选?NocoDB、Baserow 等工具的价格与适用场景

想换掉 Airtable,先分清是席位太贵、容量不够,还是缺少客户门户。本文对比 NocoDB、Baserow、SeaTable、Grist、Smartsheet、Notion 和 Softr,拆解价格、免费额度、自托管、API、自动化与权限差异,帮你按真实工作流选型,并在迁移前验证关联数据、集成和恢复方案。2026年11月10日Build
2026 年 proxy 代理服务推荐:Bright Data、Oxylabs、Decodo 等 7 家怎么选

2026 年 proxy 代理服务推荐:Bright Data、Oxylabs、Decodo 等 7 家怎么选

proxy 代理服务该怎么选?对比 Bright Data、Oxylabs、Decodo、Webshare、ThorData、IPRoyal 与 NetNut,梳理住宅、数据中心、ISP 和移动代理的价格、试用、KYC 与会话控制,分清原始网络、托管解封和抓取 API 的职责,按有效记录成本和实际任务需求筛选。2026年11月10日Build
NVIDIA OpenShell:为 AI 智能体划定可执行的权限边界

NVIDIA OpenShell:为 AI 智能体划定可执行的权限边界

NVIDIA OpenShell 如何限制编程智能体的文件、网络和凭据访问?本文梳理受支持的平台、CLI 安装与 OpenCode 启动流程,解释哪些策略可实时更新、哪些变更需要重建沙箱,并给出可审查的编程策略模板、权限测试方法和团队落地场景,帮助平台团队在开放真实项目与服务前看清实际授予的权限。2026年11月9日Build
CodeRabbit 价格详解:席位费用、用量限制与附加收费

CodeRabbit 价格详解:席位费用、用量限制与附加收费

CodeRabbit 价格怎么算?本文梳理 Essentials、Team、Advanced 与 Enterprise 的席位收费、年付折扣、PR 审查额度及关联仓库限制,并列出不同团队规模的预算算例。了解免费版和开源方案的适用范围,分清超限文件审查、Agent 分钟数与安全扫描费用,再按实际工作流和安全需求选择套餐。2026年11月9日Build
2026 企业杀毒软件怎么选:六款小企业方案、价格与响应服务对比

2026 企业杀毒软件怎么选:六款小企业方案、价格与响应服务对比

企业杀毒软件怎么选,关键在于谁来管理设备、谁来处理告警。本文对比 Bitdefender、Microsoft Defender、ESET、Sophos、CrowdStrike 与 Malwarebytes,梳理美元价格、设备额度、服务器授权和托管响应范围,帮助小企业按现有订阅、设备类型与管理能力确定候选方案。2026年11月8日Build
Paperclip AI 评测:多智能体协作怎么管,部署前要看什么

Paperclip AI 评测:多智能体协作怎么管,部署前要看什么

Paperclip AI 能把分散的 AI 智能体组织成可追踪的工作流,但安装管理面板并不等于完成权限与验收配置。本文梳理官方安装方式、运行时与模型支持、任务交接、预算策略和审批边界,并对比 OpenClaw 与 Hermes Agent,帮你判断是否值得花一个周末试用,以及上线前应检查什么。2026年11月7日Build
Supabase 是什么?看懂 AI 应用背后的数据库、权限与后端

Supabase 是什么?看懂 AI 应用背后的数据库、权限与后端

Supabase 是什么,为什么 AI 应用构建工具常用它做后端?本文从 Postgres 数据库、登录认证、文件存储、实时更新与向量搜索讲起,梳理 Lovable、Bolt、v0 和 MCP 的接入方式,解释 RLS 权限、项目控制权与迁移边界,帮你在接收真实客户数据前,明确需要验证的隔离、恢复和交接事项。2026年11月7日Build
AI IDE 怎么选?2026 年 Cursor、VS Code、Zed 等 6 款编辑器对比

AI IDE 怎么选?2026 年 Cursor、VS Code、Zed 等 6 款编辑器对比

AI IDE 怎么选?比较 Cursor、VS Code 搭配 GitHub Copilot、Windsurf(现为 Devin Desktop)、Zed、Kiro 与 JetBrains AI,梳理价格、免费方案、智能体模式、模型接入、BYOK、本地推理、隐私边界与团队管控,帮你按工作流判断是否值得迁移。2026年11月6日Build
订阅通讯

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

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