它到底是什么

/plan 是 Claude Code 的内置 slash 命令，用于触发 plan mode（计划模式）。在提示词前缀 /plan <描述> 后，Claude 进入只读研究状态：可读文件、执行探索性 shell 命令，但不修改任何源文件，直到生成一份结构化执行计划并获得你的批准。

Plan mode 是官方定义的六种权限模式之一（plan），与 default、acceptEdits、auto、dontAsk、bypassPermissions 并列。/plan 是进入该模式的文本触发方式，效果等同于按 Shift+Tab 切换到 plan mode。

怎么触发 / 怎么使用

1. 提示词前缀（最常见用法）

在消息开头输入 /plan，后跟任意描述：

/plan fix the auth bug
/plan migrate the payments module from REST to gRPC
/plan add OAuth support to src/auth/

描述文字作为参数传给命令，成为本次计划任务的目标。Claude 切入 plan mode，读遍相关代码，输出计划，然后呈现批准对话框。

2. Shift+Tab 循环切换（会话级）

在 CLI 中按 Shift+Tab 可在以下模式间循环：

default  →  acceptEdits  →  plan

切入后，状态栏显示当前模式。再按 Shift+Tab 一次可在不批准计划的情况下直接离开 plan mode。

3. 启动时指定

claude --permission-mode plan

整个会话从启动就处于 plan mode。

4. 批准计划时的选项

计划完成后，Claude 呈现批准对话框：

批准后，Claude Code 自动根据计划内容为当前会话命名（除非已用 --name 或 /rename 手动命名）。

按 Ctrl+G 可在系统默认编辑器中直接打开并编辑计划内容后再交还 Claude 执行。

保存 / 配置 / 集成

设为项目默认模式

在 .claude/settings.json 中配置：

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

批准计划后自动清除计划阶段上下文

启用 showClearContextOnPlanAccept 设置后，每个批准选项会额外提供"清除计划上下文后执行"的选项。

VS Code

点击提示框底部的模式指示器切换。Plan mode 的 UI 标签为 Plan mode。也可通过 claudeCode.initialPermissionMode 设置初始模式（或在扩展设置面板中操作）。

Desktop / Web

Desktop：使用发送按钮旁的模式选择器。 claude.ai/code（云端会话）：使用提示框旁的模式下拉菜单。

运行约束 / 限制

跟同类原语对比

/ultraplan 在本地计划的基础上增加了云端浏览器界面：可对计划的具体段落留内联评论、表情回应，最终选择在云端执行或"传送回"本地终端。

经典使用场景

• 大型重构前先探路：/plan refactor the auth module to use JWT，Claude 读遍相关文件并列出变更清单，你确认范围和顺序后再启动执行。
• 跨文件批量改动：涉及多模块的改动先在 plan mode 下理清依赖顺序，避免执行到一半发现前提条件不满足。
• 陌生代码库快速定位：/plan understand the payment flow，让 Claude 输出结构性分析文档，全程不触碰任何文件。
• 迭代细化计划：批准对话框选 "Keep planning with feedback" 可多轮对话修改计划（增删步骤、缩小范围），满意后再正式批准。

常见坑

1. plan mode 不是"只读 shell"：官方文档明确指出，plan mode 下 Claude 仍可运行 shell 命令探索代码库，这些命令依然受到权限提示约束（与 default mode 行为相同）。不要误以为 plan mode 完全屏蔽了 shell 执行。

2. /plan 会切换会话模式，批准后模式发生变化：选择批准选项后，会话立刻切换到对应的执行模式（auto / acceptEdits / default）。若想再次计划，需重新使用 /plan 前缀或按 Shift+Tab 切回 plan mode。

3. 别把 auto 的限制套到 plan 上：官方 permission-modes 文档明确写「To make plan mode the default for a project, set defaultMode in .claude/settings.json」——defaultMode: "plan" 可以放在项目级 .claude/settings.json,本节正文也是这么演示的。真正受限的是 auto:Claude Code v2.1.142+ 会忽略项目级或 local settings 里的 defaultMode: "auto"(防止仓库给自己授予 auto mode),要让 auto 成默认必须写在 ~/.claude/settings.json(用户级)或 managed settings。两者不要混为一谈。

4. Ultraplan 需要 GitHub 仓库且不支持私有云 provider：若通过 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 使用 Claude Code，批准对话框中的 Ultraplan 选项不可用。

来源

• Commands – Claude Code Docs
• Choose a permission mode – Claude Code Docs
• Plan in the cloud with ultraplan – Claude Code Docs
• How Claude Code works – Claude Code Docs