文档基础理论计划模式

计划模式 (Plan Mode)

最后核验:2026-07-16。 本页依据 Claude Code 官方 permission modes 与 commands 文档。CLI 和各端界面会持续更新,请以当前版本的状态栏、/help 和官方文档为准。

Plan Mode 是 Claude Code 的一种 permission mode(权限模式)。它让 Claude 先研究代码库、说明方案并提出计划,但在你批准计划前不会编辑源码。

Plan Mode 的核心是“只读探索后提案”,不是“检测到复杂任务便自动进入”,也不是在聊天里说一句“请使用计划模式”就完成了权限切换。

Plan Mode 能做什么

在 Plan Mode 中,Claude 可以:

  • 读取文件、搜索代码和理解项目结构;
  • 运行用于探索的 shell 命令;
  • 分析依赖、影响范围和潜在风险;
  • 形成可审阅的实施计划;
  • 根据你的反馈继续修改计划。

它不会直接编辑源码。通常情况下,Plan Mode 的只读探索命令沿用常规权限检查;但当前有一个 Auto 例外:当 Auto Mode 可用且 useAutoModeDuringPlan 已启用时,Plan Mode 中的只读命令会按 Auto 分类器语义处理,源码编辑仍然被阻止。因此不能再把 Plan Mode 的命令权限绝对概括为“与 default 完全一致”。

计划准备好后,Claude 会让你选择下一步。你可以继续给反馈,也可以批准并切换到相应的执行模式,例如 Auto、acceptEdits,或逐项人工审核。批准计划会退出 Plan Mode,之后 Claude 才开始修改。

如何进入 Plan Mode

对单个任务使用 /plan

在 Claude Code 会话里输入:

/plan 重构登录流程,先确认影响的文件和测试

官方命令格式是 /plan [description]。它可以只让这次提示直接进入 Plan Mode,并附带任务描述。

Shift+Tab 切换

CLI 中按 Shift+Tab 会在常规权限模式间循环:

default → acceptEdits → plan

当前模式显示在状态栏。再次按 Shift+Tab 可以离开 Plan Mode,而不批准当前计划。若支持模型、提供商和组织策略满足条件,Auto 也会出现在循环中。

启动时直接进入

claude --permission-mode plan

把项目默认模式设为 Plan

在项目的 .claude/settings.json 中设置:

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

这会让该项目的新会话默认从 Plan Mode 开始。它不同于在 CLAUDE.md 里写“先计划”:后者是行为指令,前者才是实际的权限模式配置。

审阅和修改计划

当 Claude 提交计划时,你可以:

  • 直接用自然语言指出缺漏或约束,让它继续规划;
  • 选择批准后进入某个执行权限模式;
  • Ctrl+G,在默认文本编辑器中直接修改拟议计划,再返回 Claude Code。

批准后若还需要重新规划,可再次按 Shift+Tab 切回 Plan,或给下一条任务加 /plan 前缀。

与其他模式的区别

模式默认无需询问即可做什么适合场景
default只读操作刚上手、敏感任务、逐步审核
acceptEdits读取、工作目录内的文件编辑及常见文件系统命令方向已确认,希望减少逐次编辑确认
plan只读探索和提出计划改动前先理解代码库与审阅方案
auto在后台安全检查下执行更多工具调用符合条件的账户进行长任务、减少常规权限提示

Plan Mode 不等于 acceptEdits

acceptEdits 会自动批准工作目录内的文件修改;Plan Mode 不会编辑源码。一个常见流程是先用 Plan Mode 确定方案,再批准并切换到 acceptEdits 执行。

Plan Mode 不等于 Auto Mode

Plan Mode 先停在计划审阅点;Auto Mode 则通过后台分类器判断工具调用,减少常规权限提示。Auto Mode 不会自动先进入 Plan Mode,也不会保证每个任务都生成计划。详情见 Auto Mode 使用指南

适合使用 Plan Mode 的任务

  • 第一次进入陌生代码库,需要先摸清边界;
  • 跨文件重构、架构调整或复杂故障定位;
  • 需求仍有歧义,希望先对齐范围;
  • 变更涉及数据、认证、部署或其他高风险路径;
  • 希望在任何源码修改发生前明确审阅点。

一个有效的任务描述应包含目标、禁止触碰的范围、兼容性要求和验收方式。例如:

/plan 把认证状态迁移到服务端会话。不要修改公开 API;列出迁移步骤、回滚点和需要补充的测试。

常见误解

Claude 会检测复杂度并自动进入 Plan Mode 吗?

不会把它当作可依赖的自动机制。请通过 /planShift+Tab、启动参数或 permissions.defaultMode 明确选择模式。

在聊天中说“请使用计划模式”可以切换吗?

这可以表达你希望先规划,但不等于修改 permission mode。要获得 Plan Mode 的只读约束,请使用正式入口,并检查状态栏模式。

批准计划后还在 Plan Mode 吗?

不在。批准会退出 Plan Mode,并按你选择的权限模式开始执行。

官方来源

相关概念

关于我