claude-code/docs/safety/plan-mode.mdx

---
title: "计划模式"
description: "先看后做——给 AI 一个只读的探索阶段"
---

{/* 本章目标：解释 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. 用户可以通过任务列表追踪进度