计划模式

在只读环境里先研究、设计、对齐方案，再动手实现：进入方式、使用流程、协作编辑计划与模型路由。

计划模式是在实现之前架构稳健方案的只读环境。用它可以：研究（在只读状态下探索项目，防止意外改动）、设计（理解问题、评估权衡、选择方案）、计划（在任何代码被修改之前对齐执行策略）。计划模式默认启用，可以用 /settings 命令管理这个设置。

如何进入

你可以配置 Gemini CLI 默认以计划模式启动，也可以在会话中手动进入：

默认启动：用 /settings，把 Default Approval Mode 设为 Plan；只启动一次用 gemini --approval-mode=plan
键盘快捷键：按 Shift+Tab 在审批模式之间循环（Default → Auto-Edit → Plan）；Gemini CLI 正在处理或显示确认对话框时，计划模式会自动从循环里移除
命令：在输入框里输入 /plan [goal]，[goal] 可选，例如 /plan implement authentication 会切换到计划模式并立即把提示提交给模型
自然语言：让 Gemini CLI「start a plan for...」，它会调用 enter_plan_mode 工具切换模式（YOLO 模式下该工具不可用）

使用流程

给出目标：先描述你想达成什么；Gemini CLI 随后进入计划模式（如果还没进入）研究任务
讨论并达成策略：分析代码库时，它会与你讨论发现和建议的策略以确保一致，可能用 ask_user 向你提问或给出不同的实现选项。Gemini CLI 会停下来等你确认，再起草正式计划；在继续之前你们应当对方案达成非正式的一致
审阅计划：一旦你们对策略达成一致，Gemini CLI 会在计划目录里创建一个详细的实现计划 Markdown 文件。可以打开阅读，也可以按 Ctrl+X 在你配置的外部编辑器里直接打开它
批准或迭代：Gemini CLI 会把最终计划呈给你正式批准。满意就批准以立即开始实现：Yes, automatically accept edits 或 Yes, manually accept edits；需要调整就在输入框里提供反馈或直接编辑计划文件，Gemini CLI 会细化策略并更新计划；用 Esc 取消计划

对更复杂或专门的规划任务，可以用 skills 自定义规划工作流。

协作编辑计划

通过直接修改或在实现计划里留下注释与 Gemini CLI 协作，通常比用自然语言描述复杂改动更快更精确：当 Gemini CLI 呈上计划供审阅时按 Ctrl+X，计划会在你配置的外部编辑器里打开，在那里编辑或评论，保存关闭后 Gemini CLI 读取你的改动。

相关设置

general.plan.enabled 启用计划模式；general.plan.directory 指定存放计划产物的目录（未指定时默认为系统临时目录，自定义目录需要策略允许在计划模式下写入）；general.plan.modelRouting 根据是否处于计划模式在 Pro 和 Flash 模型之间自动切换（计划阶段用 Pro，实现阶段用 Flash）。