· 8 分钟 · 开发者指南

Claude Code 计划模式:如何使用,以及何时能节省时间和 token

Claude Code 计划模式:如何使用,以及何时能节省时间和 token

Claude Code 计划模式让你有机会在实施开始前审核方案。本指南说明如何进入和退出 Claude Code 计划模式、将其设为默认模式,以及判断何时可以通过规划减少不必要的搜索和修改轮次,从而节省时间与 token。

Claude Code 计划模式的作用

计划模式将提出变更与实施变更分开。Claude 会调查任务、提出方案,并等待批准,让你能够在继续之前审核和调整计划。

该 Claude Code 用户常见问题的日期为 2026 年八月 7 日,其中将 plan 描述为等待批准的只读规划模式。因此,当你希望在允许实施之前确认 Claude 对任务的理解时,它会很有用。

只读并不意味着不能使用工具。Claude 可以在规划期间读取文件并使用只读工具。截至 2026 年 8 月 14 日可查的版本发布历史中,包含一项针对以 Plan Mode 启动的会话中只读工具调用的修复。因此,说规划会阻止所有命令或所有仓库检查,会造成误导。

Plan Mode 与其他权限模式

规划决定 Claude 是在提出工作方案,还是在执行工作。实施时使用的权限模式决定哪些操作需要批准。

模式 文档中说明的行为 需要考虑的事项
plan 只读规划;等待批准 用于在实施前审查方案。
手动 在进行有风险的编辑或执行命令前询问 实施期间,执行这些操作时会请求批准。
acceptEdits 自动接受文件编辑;命令仍可能需要批准 文件编辑权限与命令权限相互独立。
auto 通过后台安全检查自动批准操作 是否可用取决于受支持的模型和组织设置。

截至发布日期,原先的 default 权限模式的显示名称为 手动。版本 2.1.200 引入了这一显示名称变更,并在相关配置和命令行设置中接受 manual 以及 default 。

如何进入和退出 Plan Mode

有三种实用的进入方式:在会话期间循环切换权限模式、使用 /plan,或使用 Plan Mode 标志启动 Claude Code。

在会话期间使用 Shift+Tab

按下 Shift+Tab 可循环切换权限模式,直到选中 Plan Mode。从 Anthropic 的 15 年 4 月指南所述的常规初始状态开始,第一次按下会进入 acceptEdits ,第二次则会进入 Plan Mode。

应将“按两次”理解为对该初始状态的描述,而不是通用规则。你的会话可能已处于其他模式,因此请在循环切换时查看当前选中的模式。

要退出 Plan Mode,请使用 Shift+Tab 循环切换到你希望用于实施的权限模式。先审查计划,再在该模式下执行已商定的工作。

使用以下命令直接进入 /plan

在会话中使用:

/plan

你也可以直接附上任务:

/plan fix the auth bug

描述参数于 2026 年 3 月 10 日在 v2.1.72 中加入。它会进入 Plan Mode 并开始规划该任务,让你可以用一条命令同时指定模式和任务。

在 Plan Mode 下启动新会话

要以规划模式开始,请运行:

claude --permission-mode plan

如果你已经知道任务需要在实施前进行调查和审查,这种方式会很实用。有关命令行的相关用法,请参阅 Claude Code CLI 参考文档.

这些进入方式都会引导你进入相同的规划工作流程。对于正在进行的对话,可选择快捷键; /plan 适合需要使用明确命令的情况;如果希望将规划设为会话的初始模式,则使用启动标志。

制定可用于实施的计划

一份有用的 Claude Code 计划应让拟议变更易于评估。为 Claude 提供足够的上下文,以便识别相关代码;同时提供充分的验收标准,让它理解怎样的实施结果才算成功。

该 上下文与更优提示词指南 建议提供相关文件引用,并在切换模式和实施某个步骤前,在对话中审查计划。

提供已知路径和验收标准

使用以下方式引用文件 @path/to/file ,适用于你已经知道相关代码所在位置的情况。该指南指出,与让 Claude 自行定位文件相比,提供这些引用速度更快,消耗的 token 也更少。

在提供这些路径的同时,明确说明成功的标准。例如,对于身份验证错误,你可以描述出错时的行为、指出相关文件,并说明修复后期望的行为。这是一种建议的任务描述方式,并非对某个特定仓库的断言。

值得提供的信息包括:

  • 需要改变的行为。
  • 你已知的相关文件。
  • 对变更范围的限制。
  • 完成工作的验收标准。

目的是在实施前减少不确定性。详细描述期望结果,比只要求制定计划却不说明变更必须实现什么更有用。

批准前先审查计划

检查拟议方案是否解决了所要求的行为问题,并且没有超出预期范围。对于涉及多个文件的工作,在允许继续变更前,应审查各步骤如何衔接。

如果计划反映出理解偏差,请在对话中纠正。Anthropic 的指导明确支持在切换模式和实施某个步骤前审查并调整计划。

批准标志着从审查方案转向实施。所选的实施权限模式仍然很重要:批准计划并不会让 Manual、 acceptEdits,以及 auto 变得等同。

规划何时能节省时间和 token

如果提前消除不确定性可以避免不必要的实施工作,Claude Code 规划模式就最有用。涉及多个文件的变更很适合使用规划,因为一个错误假设可能影响拟议变更的多个部分。

有依据的节省机制很具体:在误解演变成大量差异之前发现它,通过预先定义成功标准减少修改轮次,以及通过提供已知路径避免不必要的文件搜索。

需要审查范围时使用规划

当任务涉及多个文件,或需要在开始编辑前确认方案时,可以考虑使用 Plan Mode。审查计划让你有机会缩小范围、纠正假设,或调整工作顺序。

对于规模较小、要求明确的变更,可以考虑单独进行一轮规划是否能消除有实际意义的不确定性。如果受影响的文件和所需行为已经明确,长时间的规划对话可能带来的收益较少。

这是对工作流程的判断,并非基准测试结论。研究简报没有确定任何经过测量的阈值,用来说明规划何时会更快。

准确表述 token 节省效果

规划会在实施前增加一轮工作。它的潜在收益来自避免那些原本可能需要重复或被舍弃的工作。

评估 token 用量时,这一区别很重要。文档明确支持通过提供已知文件路径来节省搜索所需的 token。计划审查也有助于减少误解和修改轮次,但现有证据并未量化 Plan Mode 的净节省效果。

尚无已确认的、在截止日期前发布的官方基准测试,能够支持时间或 token 用量会降低某个固定百分比的说法。所提供的证据也未确认 Plan Mode 存在单独的定价或使用额度。

使用规划来提高下一步实施的质量,并从避免的搜索和修改工作来评估节省效果。如需更广泛地了解这一目标,请参阅 如何减少 Claude 的 token 用量.

Plan Mode、 opusplan与上下文清除

权限模式和模型选择是两个独立的选择。进入 Plan Mode 会启用规划行为;Opus 规划配置则决定由哪个模型处理这项工作。

什么是 opusplan 意味着

版本 1.0.77 引入了 Opus 规划模式 在 /model中,规划时使用 Opus,其他时候使用 Sonnet。 截至 2026 年 8 月 14 日的更新日志 也记载了 opusplan 这一别名。

不要将 opusplan 视为 plan 权限模式的同义词。前者涉及规划和其他工作中的模型选择;后者涉及只读规划和批准。

具体的模型版本及由此产生的节省效果取决于配置。所提供的证据并未确认这种安排能节省固定的百分比。 Claude Code 模型指南 可帮助你独立于权限设置了解模型选择。

实施前是否应该清除上下文?

清除上下文是可选操作。2026 年 3 月 20 日发布的版本 2.1.81 默认隐藏了计划批准时的“清除上下文”选项。

要恢复该选项,请使用以下设置:

{
  "showClearContextOnPlanAccept": true
}

该 v2.1.81 发行说明 记录了这一变更。恢复该选项后,就可以在批准计划时使用它;现有证据并未证明清除上下文总能节省 token 或改善实施结果。

将规划设为默认模式

如果你经常希望在实施前审查方案,可以将 Plan Mode 配置为默认模式:

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

A 2025 年 7 月 28 日的仓库讨论 将此配置放在 ~/.claude/settings.json.

这里需要说明来源的性质:带有日期的示例来自 Anthropic 官方仓库中的一条社区评论。当前的官方权限模式文档也确认了这一配置,但其历史修订日期尚不确定。

如果只想为某个会话启用规划,请使用启动标志。如果先审查计划是你的常规工作流程,可以考虑使用默认设置。无论采用哪种方式,你都可以审查并调整拟议方案,然后切换模式进行实施。

要点

  • 规划模式是一种带有审批步骤的只读规划模式。 在制定方案时,它可以检查文件并使用只读工具。
  • 使用以下方式进入 Shift+Tab, /plan,或 claude --permission-mode plan;按快捷键的次数取决于起始模式。
  • 提供已知文件路径和验收标准,以减少搜索和修改轮次。
  • 规划尤其适合审查涉及多个文件的更改,但目前没有已确定的固定时间或 token 节省百分比。
  • opusplan 涉及模型选择,而清除上下文是计划审批时的一项可选设置。

常见问题

如何使用 Shift+Tab 进入和退出规划模式?

按 Shift+Tab 循环切换权限模式,直到选中规划模式。要退出该模式,请切换到你希望用于实施的模式;按键次数取决于会话的当前模式。

规划模式可以读取文件或运行 shell 命令吗?

规划模式在制定计划时可以读取文件并使用只读工具。说它会阻止所有命令并不准确,但文档说明的行为是进行只读规划,并在实施前等待审批。

如何让每个会话都以规划模式启动?

设置 permissions.defaultMode 变为 "plan" 在 ~/.claude/settings.json,如注明日期的仓库讨论所示。对于单个会话,启动 Claude Code 时使用 claude --permission-mode plan.

规划模式能节省 token 吗?

提供已知文件路径可以节省搜索所需的 token,定义验收标准可以减少修改轮次。规划本身也会增加工作量,因此净节省量取决于它帮助避免了哪些工作;所提供的证据并未确立固定百分比或官方净节省基准。

A

本博客由 AI Prime Tech 发布。文章借助 AI 辅助起草;在据此采取行动前,请对照官方文档核实模型 ID、价格和限额等特定版本的细节。

以更低价格接入 Claude API

一个 API 密钥即可使用 Claude Opus 5.5、Sonnet 5、Haiku 4.5 和 Fable 5.1,以及 GPT-6 个模型。按量付费,无需订阅。

获取 API 密钥 →
AI Prime Tech 是独立的第三方 API 网关。Claude™ 和 Anthropic® 是 Anthropic, PBC 的商标。此处不暗示任何关联或背书。