Plan 模式

Plan 模式让 Claude 在动手之前先深度思考和规划，只读分析代码库，输出可审查的执行计划。

什么时候用 Plan 模式？

• 不熟悉的代码库 — 先让 Claude 调研理解，再决定怎么改
• 大规模重构 — 涉及多个文件的变更，需要先理清依赖关系
• 复杂功能开发 — 需要考虑架构设计、接口兼容性
• 跨团队评审 — 生成计划文档给团队其他成员审查

如何进入 Plan 模式

快捷键切换

按 Shift+Tab 在模式之间循环：

default → acceptEdits → plan → auto → default

启动时指定

claude --permission-mode plan

Plan 模式的行为

在 Plan 模式下，Claude：

典型工作流

第一步：进入 Plan 模式，描述任务

帮我重构用户认证模块，从 session-based 改为 JWT

第二步：Claude 深度分析

Claude 会：

1. 搜索所有认证相关的文件
2. 阅读关键代码（路由、中间件、模型）
3. 理解现有的认证流程
4. 识别所有需要修改的文件

第三步：Claude 输出计划

## 重构计划

### 需要修改的文件
1. src/middleware/auth.ts — 替换 session 验证为 JWT 验证
2. src/routes/login.ts — 登录成功后返回 JWT token
3. src/routes/register.ts — 注册后同时返回 token
4. src/lib/jwt.ts — 新建，JWT 工具函数
5. src/types/auth.ts — 更新类型定义

### 执行顺序
1. 先创建 JWT 工具库
2. 修改登录/注册路由
3. 替换认证中间件
4. 更新所有受保护路由的类型
5. 删除 session 相关依赖

### 注意事项
- 需要安装 jsonwebtoken 包
- 前端需要同步修改 token 存储方式
- 现有登录用户需要重新登录

第四步：审查和调整

你可以对计划提出修改意见：

还需要考虑 refresh token 机制，以及 token 过期后的自动续签

Claude 会更新计划。

第五步：切换回普通模式执行

按 Shift+Tab 切换回 default 或 acceptEdits 模式：

按照刚才的计划开始执行

Claude 会按照计划逐步修改代码。

Plan 模式 + Subagent

Plan 模式下，Claude 会使用 Plan subagent（继承当前模型）来进行深度研究。这个 subagent 可以并行搜索多个方向，汇总后提供全面的分析结果。

最佳实践

1. 先 Plan 后执行 — 对于复杂任务，永远先 Plan
2. 要求具体 — 不要只说"帮我重构"，要说清楚重构的目标和约束
3. 迭代计划 — 第一版计划不满意？继续对话调整
4. 保存计划 — 好的计划可以要求 Claude 写入文件，留作文档