Source: https://aiprimetech.io/zh/blog/claude-code-plan-mode/ 2026 年八月 14 日 · 8 分钟 · 开发者指南 # Claude Code 计划模式:如何使用,以及何时能节省时间和 token A 作者 [AI Prime Tech](https://aiprimetech.io/zh/) · AI 辅助撰写 Claude Code 计划模式让你有机会在实施开始前审核方案。本指南说明如何进入和退出 Claude Code 计划模式、将其设为默认模式,以及判断何时可以通过规划减少不必要的搜索和修改轮次,从而节省时间与 token。 ## Claude Code 计划模式的作用 计划模式将提出变更与实施变更分开。Claude 会调查任务、提出方案,并等待批准,让你能够在继续之前审核和调整计划。 该 [Claude Code 用户常见问题](https://support.claude.com/en/articles/14554922-claude-code-user-faq)的日期为 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 参考文档](/zh/claude-code/cli/). 这些进入方式都会引导你进入相同的规划工作流程。对于正在进行的对话,可选择快捷键; /plan 适合需要使用明确命令的情况;如果希望将规划设为会话的初始模式,则使用启动标志。 ## 制定可用于实施的计划 一份有用的 Claude Code 计划应让拟议变更易于评估。为 Claude 提供足够的上下文,以便识别相关代码;同时提供充分的验收标准,让它理解怎样的实施结果才算成功。 该 [上下文与更优提示词指南](https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts) 建议提供相关文件引用,并在切换模式和实施某个步骤前,在对话中审查计划。 ### 提供已知路径和验收标准 使用以下方式引用文件 @path/to/file ,适用于你已经知道相关代码所在位置的情况。该指南指出,与让 Claude 自行定位文件相比,提供这些引用速度更快,消耗的 token 也更少。 在提供这些路径的同时,明确说明成功的标准。例如,对于身份验证错误,你可以描述出错时的行为、指出相关文件,并说明修复后期望的行为。这是一种建议的任务描述方式,并非对某个特定仓库的断言。 值得提供的信息包括: - 需要改变的行为。 - 你已知的相关文件。 - 对变更范围的限制。 - 完成工作的验收标准。 目的是在实施前减少不确定性。详细描述期望结果,比只要求制定计划却不说明变更必须实现什么更有用。 ### 批准前先审查计划 检查拟议方案是否解决了所要求的行为问题,并且没有超出预期范围。对于涉及多个文件的工作,在允许继续变更前,应审查各步骤如何衔接。 如果计划反映出理解偏差,请在对话中纠正。Anthropic 的指导明确支持在切换模式和实施某个步骤前审查并调整计划。 批准标志着从审查方案转向实施。所选的实施权限模式仍然很重要:批准计划并不会让 Manual、 acceptEdits,以及 auto 变得等同。 ## 规划何时能节省时间和 token 如果提前消除不确定性可以避免不必要的实施工作,Claude Code 规划模式就最有用。涉及多个文件的变更很适合使用规划,因为一个错误假设可能影响拟议变更的多个部分。 有依据的节省机制很具体:在误解演变成大量差异之前发现它,通过预先定义成功标准减少修改轮次,以及通过提供已知路径避免不必要的文件搜索。 ### 需要审查范围时使用规划 当任务涉及多个文件,或需要在开始编辑前确认方案时,可以考虑使用 Plan Mode。审查计划让你有机会缩小范围、纠正假设,或调整工作顺序。 对于规模较小、要求明确的变更,可以考虑单独进行一轮规划是否能消除有实际意义的不确定性。如果受影响的文件和所需行为已经明确,长时间的规划对话可能带来的收益较少。 这是对工作流程的判断,并非基准测试结论。研究简报没有确定任何经过测量的阈值,用来说明规划何时会更快。 ### 准确表述 token 节省效果 规划会在实施前增加一轮工作。它的潜在收益来自避免那些原本可能需要重复或被舍弃的工作。 评估 token 用量时,这一区别很重要。文档明确支持通过提供已知文件路径来节省搜索所需的 token。计划审查也有助于减少误解和修改轮次,但现有证据并未量化 Plan Mode 的净节省效果。 尚无已确认的、在截止日期前发布的官方基准测试,能够支持时间或 token 用量会降低某个固定百分比的说法。所提供的证据也未确认 Plan Mode 存在单独的定价或使用额度。 使用规划来提高下一步实施的质量,并从避免的搜索和修改工作来评估节省效果。如需更广泛地了解这一目标,请参阅 [如何减少 Claude 的 token 用量](/zh/learn/how-to-reduce-claude-token-usage/). ## Plan Mode、 opusplan与上下文清除 权限模式和模型选择是两个独立的选择。进入 Plan Mode 会启用规划行为;Opus 规划配置则决定由哪个模型处理这项工作。 ### 什么是 opusplan 意味着 版本 1.0.77 引入了 Opus 规划模式 在 /model中,规划时使用 Opus,其他时候使用 Sonnet。 [截至 2026 年 8 月 14 日的更新日志](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.233/CHANGELOG.md) 也记载了 opusplan 这一别名。 不要将 opusplan 视为 plan 权限模式的同义词。前者涉及规划和其他工作中的模型选择;后者涉及只读规划和批准。 具体的模型版本及由此产生的节省效果取决于配置。所提供的证据并未确认这种安排能节省固定的百分比。 [Claude Code 模型指南](/zh/claude-code/models/) 可帮助你独立于权限设置了解模型选择。 ### 实施前是否应该清除上下文? 清除上下文是可选操作。2026 年 3 月 20 日发布的版本 2.1.81 默认隐藏了计划批准时的“清除上下文”选项。 要恢复该选项,请使用以下设置: ``` { "showClearContextOnPlanAccept": true } ``` 该 [v2.1.81 发行说明](https://github.com/anthropics/claude-code/releases/tag/v2.1.81) 记录了这一变更。恢复该选项后,就可以在批准计划时使用它;现有证据并未证明清除上下文总能节省 token 或改善实施结果。 ## 将规划设为默认模式 如果你经常希望在实施前审查方案,可以将 Plan Mode 配置为默认模式: ``` { "permissions": { "defaultMode": "plan" } } ``` A [2025 年 7 月 28 日的仓库讨论](https://github.com/anthropics/claude-code/issues/2798) 将此配置放在 ~/.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,定义验收标准可以减少修改轮次。规划本身也会增加工作量,因此净节省量取决于它帮助避免了哪些工作;所提供的证据并未确立固定百分比或官方净节省基准。 [Claude](/zh/blog/tag/claude/)[编程](/zh/blog/tag/coding/)[智能体](/zh/blog/tag/agents/) A [AI Prime Tech](https://aiprimetech.io/zh/) 本博客由 AI Prime Tech 发布。文章借助 AI 辅助起草;在据此采取行动前,请对照官方文档核实模型 ID、价格和限额等特定版本的细节。 以更低价格接入 Claude API 一个 API 密钥即可使用 Claude Opus 5.5、Sonnet 5、Haiku 4.5 和 Fable 5.1,以及 GPT-6 个模型。按量付费,无需订阅。 [获取 API 密钥 →](/register) AI Prime Tech 是独立的第三方 API 网关。Claude™ 和 Anthropic® 是 Anthropic, PBC 的商标。此处不暗示任何关联或背书。