Plan Mode 是 Gemini CLI 的只读规划环境，让你在 AI 动手改代码之前先审查它的实现方案。核心流程：描述目标 → AI 研究代码库 → 生成 Markdown 计划文件 → 你审批 → 开始执行。按 Shift+Tab 即可切换模式。

Plan Mode 规划模式

Plan Mode 是一个只读的架构设计环境，让你在 AI 真正修改任何文件之前，先看到它打算怎么做。

适合用于：

• 探索代码库但不想意外改动文件
• 在实现前对齐架构思路
• 评估不同方案的利弊

进入 Plan Mode

方式一：启动时指定

gemini --approval-mode=plan

方式二：设为默认模式

在 /settings 中将 Default Approval Mode 设为 Plan。

方式三：会话中切换

按 Shift+Tab 循环切换模式：Default → Auto-Edit → Plan

也可以输入命令：

/plan 实现用户登录功能

/plan 后面可以带目标描述，会立即进入规划模式并开始分析。

Plan Mode 工作流

1. 描述目标 → AI 进入只读模式研究代码库
2. 双方讨论方案 → AI 提问、你回答、对齐思路
3. AI 生成 Markdown 计划文件
4. 你审阅（可直接编辑）→ 确认或提出修改意见
5. 批准 → 立即开始执行实现

第 1 步：提供目标

> /plan 帮我把用户认证模块重构成 JWT 无状态认证

AI 会在只读模式下分析你的代码库，不会修改任何文件。

第 2 步：讨论策略

AI 会汇报分析结果，可能问你：

• "现有的 session 数据要迁移还是废弃？"
• "JWT 过期时间用多少？需要 refresh token 吗？"

在生成正式计划之前，AI 会停下来等待你的确认。 双方需要就方向达成共识。

第 3 步：审阅计划文件

确认方向后，AI 会生成一份 Markdown 计划文件（存在 plans 目录）。

• 按 Ctrl+X 在外部编辑器中直接打开和编辑
• 也可以在对话框中告诉 AI 需要调整的地方

第 4 步：批准执行

选项	描述
Yes, automatically accept edits	批准并自动应用所有编辑
Yes, manually accept edits	批准但每个改动逐一确认
继续对话	提出修改意见，让 AI 调整方案
Esc	取消当前计划

Plan Mode 的好处

与"直接让 AI 改代码"相比，Plan Mode 的优势：

1. 不可逆操作前先看清楚 — 重构前知道会动哪些文件
2. 避免过度改动 — AI 有时会在修复 A 的同时悄悄改 B
3. 共享计划文件 — 可以把 Markdown 计划发给同事 review
4. 随时中途调整 — 发现方向不对可以在生成计划阶段就纠正

与 Claude Code 的比较

Gemini CLI 的 Plan Mode 和 Claude Code 的 Plan Mode 设计思路相似，但有差异：

特性	Gemini CLI Plan Mode	Claude Code Plan Mode
触发方式	Shift+Tab 或 --approval-mode=plan	/plan 命令
计划文件	生成独立 Markdown 文件	显示在对话中
协作编辑	Ctrl+X 打开外部编辑器	直接在对话中修改
只读保证	严格只读，不允许任何写操作	类似

常见问题

Q: Plan Mode 下可以读文件吗？

A: 可以。Plan Mode 只禁止写操作（创建/修改/删除文件、执行 Shell 命令），读文件、搜索代码、列目录均可正常进行。

Q: 计划文件保存在哪里？

A: 默认保存在系统临时目录。可以在 settings.json 中通过 general.plan.directory 自定义路径。

Q: Plan Mode 有性能优化吗？

A: 有。开启 general.plan.modelRouting: true 后，规划阶段用 Pro 模型（更强推理），执行阶段切换到 Flash 模型（更快），在质量和速度之间自动平衡。