claude-code/docs/safety/plan-mode.mdx
2026-04-01 15:21:46 +08:00

62 lines
2.2 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: "计划模式 - Plan Mode 先看后做的安全机制"
description: "解析 Claude Code Plan Mode 设计:给 AI 一个只读探索阶段,先分析再执行,避免不可逆操作,让用户在 AI 行动前审查方案。"
keywords: ["Plan Mode", "计划模式", "只读模式", "安全执行", "预览方案"]
---
{/* 本章目标:解释 Plan Mode 的设计理念 */}
## 问题场景
你说"重构这个模块"AI 立刻开始改代码——但你还没搞清楚它打算怎么改。等改了一半发现方向不对,已经来不及了。
## Plan Mode 的解决方案
计划模式给对话加了一个"只读阶段"
<Steps>
<Step title="进入计划模式">
AI 自主判断任务需要规划(或用户主动触发),进入计划模式
</Step>
<Step title="探索阶段">
在这个阶段AI 只能使用读取和搜索类工具——不能编辑文件、不能执行命令
</Step>
<Step title="形成计划">
AI 把理解和方案写入计划文件,提交给用户审阅
</Step>
<Step title="用户审批">
用户阅读计划,提出修改意见或直接批准
</Step>
<Step title="退出计划模式">
计划被批准后AI 恢复全部工具权限,按计划执行
</Step>
</Steps>
## 权限的自动收窄与恢复
计划模式的精妙之处在于**自动改变权限上下文**
- 进入时:系统自动保存当前权限模式,切换为"只读"
- 退出时:系统自动恢复之前的权限模式
AI 和用户都不需要手动调整权限设置。
## 什么时候该用计划模式
| 场景 | 是否需要计划 |
|------|-------------|
| 修复一个明确的 typo | 不需要,直接修 |
| 添加一个简单的函数 | 不需要 |
| 重构一个大模块 | 需要——先搞清楚影响范围 |
| 涉及多个文件的 feature | 需要——先统一方案 |
| 不确定该怎么做 | 需要——让 AI 先调研 |
## 计划模式 + 任务系统
计划模式通常与任务系统配合使用:
1. 在计划模式中AI 把实施步骤创建为任务列表
2. 用户审批计划(包含任务列表)
3. 退出计划模式后AI 按任务列表逐项执行
4. 用户可以通过任务列表追踪进度