--- title: "计划模式 - Plan Mode 先看后做的安全机制" description: "解析 Claude Code Plan Mode 设计:给 AI 一个只读探索阶段,先分析再执行,避免不可逆操作,让用户在 AI 行动前审查方案。" keywords: ["Plan Mode", "计划模式", "只读模式", "安全执行", "预览方案"] --- {/* 本章目标:解释 Plan Mode 的设计理念 */} ## 问题场景 你说"重构这个模块",AI 立刻开始改代码——但你还没搞清楚它打算怎么改。等改了一半发现方向不对,已经来不及了。 ## Plan Mode 的解决方案 计划模式给对话加了一个"只读阶段": AI 自主判断任务需要规划(或用户主动触发),进入计划模式 在这个阶段,AI 只能使用读取和搜索类工具——不能编辑文件、不能执行命令 AI 把理解和方案写入计划文件,提交给用户审阅 用户阅读计划,提出修改意见或直接批准 计划被批准后,AI 恢复全部工具权限,按计划执行 ## 权限的自动收窄与恢复 计划模式的精妙之处在于**自动改变权限上下文**: - 进入时:系统自动保存当前权限模式,切换为"只读" - 退出时:系统自动恢复之前的权限模式 AI 和用户都不需要手动调整权限设置。 ## 什么时候该用计划模式 | 场景 | 是否需要计划 | |------|-------------| | 修复一个明确的 typo | 不需要,直接修 | | 添加一个简单的函数 | 不需要 | | 重构一个大模块 | 需要——先搞清楚影响范围 | | 涉及多个文件的 feature | 需要——先统一方案 | | 不确定该怎么做 | 需要——让 AI 先调研 | ## 计划模式 + 任务系统 计划模式通常与任务系统配合使用: 1. 在计划模式中,AI 把实施步骤创建为任务列表 2. 用户审批计划(包含任务列表) 3. 退出计划模式后,AI 按任务列表逐项执行 4. 用户可以通过任务列表追踪进度