用 Plan Mode 先想清复杂改动

# 用 Plan Mode 先想清复杂改动

先探索项目和比较方案，再进入实现。

资料核实：2026-10-20

## 学习目标

审阅一个包含修改范围、未知点和验证方法的计划。

## 图示：Plan Mode 前后各做什么

1. **目标与约束**：说明要改变的结果、涉及的页面和不能改动的行为。
2. **Plan Mode**：先研究真实代码，列出文件、依赖、未知点与验证方法。
3. **计划审阅**：检查范围是否最小，失败、加载和输入边界是否覆盖。
4. **实现与验收**：按实际差异和测试结果判断完成，权限问题另行确认。

计划模式负责调查与方案；进入实现和对外发布仍需分别确认。

## 适用场景

需要调整登录或设置流程，涉及多个文件；你希望先理解影响范围，避免边写边改需求。

## 准备条件

- 已在本地项目中打开可用版本的 Claude Code。
- 能描述本轮目标和希望保留的行为。

## 操作步骤

### 1. 从一个明确目标开始

告诉它要改变的结果与现有约束。对于已经明确的小修复，不必强制增加一次完整计划流程。

**任务说明**

```text
给设置页增加必填校验，保留现有 API 与布局。
请先分析空值、提交中和接口失败这几种状态。
```

### 2. 切换到计划模式

Claude Code 交互界面可通过 Shift\+Tab 切换模式。先确认当前界面显示 Plan Mode，再要求调查相关实现；不同版本的入口以实际界面为准。

### 3. 检查计划是否引用真实上下文

好的计划会指出实际组件和依赖，也会承认未确定的规则。检查是否无故增加服务、重构不相关模块或遗漏失败路径。

**计划检查提示词**

```text
请基于已有代码给出最小方案，并列出：
1. 涉及的文件与原因
2. 保留不变的行为
3. 需要明确的业务规则
4. 成功、失败和边界情况的验证方法
本轮保持计划模式。
```

### 4. 进入实现后仍按结果判断完成

计划清楚后再进入实现。执行结束检查差异和实际测试结果；计划模式与后续操作的权限是不同问题，不能从计划推导出发布授权。

## 常见误区

### 让计划模式代替需求描述

先写清目标和约束，再让工具调查实现。

### 只检查主流程是否写进计划

补上失败、加载与输入边界，再判断覆盖是否足够。

## 验收清单

- 当前界面确实处于 Plan Mode。
- 计划中的文件和依赖来自实际项目。
- 计划解释了如何验证主流程与失败情况。

## 资料与版本

本文为原创整理，示例需按项目调整；工具界面与功能以当前版本为准。

- [Claude Code：交互模式](https://code.claude.com/docs/en/interactive-mode)