计划模式 (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 才开始修改。
Claude Code Plan Mode 是什么?
英文资料里说的 “Claude Code Plan Mode” 就是本页的计划模式:一种只读的 permission mode——Claude 先探索代码库并提出计划,你批准之前它不改任何代码。进入方式是 /plan、Shift+Tab 或 claude --permission-mode plan;批准计划即退出 Plan Mode 并开始执行。
如何进入 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 前缀。
怎么退出 Plan Mode
两条路径:不批准直接离开——再按 Shift+Tab 把模式切回 default / acceptEdits / Auto,当前计划不生效;批准后离开——接受计划并选择执行模式,Plan Mode 自动结束,Claude 开始修改代码。之后想重新规划,可再按 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 吗?
不会把它当作可依赖的自动机制。请通过 /plan、Shift+Tab、启动参数或 permissions.defaultMode 明确选择模式。
在聊天中说“请使用计划模式”可以切换吗?
这可以表达你希望先规划,但不等于修改 permission mode。要获得 Plan Mode 的只读约束,请使用正式入口,并检查状态栏模式。
批准计划后还在 Plan Mode 吗?
不在。批准会退出 Plan Mode,并按你选择的权限模式开始执行。