https://niuzj.org/tags/plan-mode/ Recent content in Plan Mode on niuzj Hugo zh-cn Mon, 13 Jul 2026 00:00:00 +0800 https://niuzj.org/posts/claude-code-plan-mode-runtime/ Mon, 13 Jul 2026 00:00:00 +0800 https://niuzj.org/posts/claude-code-plan-mode-runtime/ <p>Plan Mode 最容易被误解为一段“先分析、再执行”的提示词。这个解释描述了模型表面的行为，却回避了一个更重要的工程问题：如果模型在规划阶段仍然发起了写文件或执行命令的 Tool Call，谁负责阻止它？</p> <p>答案不能只是另一段 Prompt。Prompt 可以约束模型的倾向，不能构成可验证的权限边界。Claude Code 的 Plan Mode 本质上是 Agent Runtime 中的一种权限模式：它在原有 Agent Loop 之上叠加会话状态、运行时提醒、本地权限检查、Plan 文件和人工审批链路。</p> <p>本文把证据分成两类。用户可见的行为以 <a href="https://code.claude.com/docs/en/permission-modes#analyze-before-you-edit-with-plan-mode">Claude Code 官方 Plan Mode 文档</a> 为准；消息构造、内部状态和审批后的上下文转换，则来自本机 Claude Code <code>2.1.207</code> 源码快照，对应构建提交 <code>bc512d56332530b2be3f5079e29ec17aa20b8553</code>。后者是特定版本的逆向观察，不应视为稳定 API。</p> <h2 id="plan-mode-没有替换-agent-loop">Plan Mode 没有替换 Agent Loop</h2> <p>进入 Plan Mode 后，Claude Code 仍然运行同一套模型与工具循环：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>构造模型请求 </span></span><span style="display:flex;"><span>→ 模型返回文本或 tool_use </span></span><span style="display:flex;"><span>→ Claude Code 在本地处理工具调用 </span></span><span style="display:flex;"><span>→ tool_result 回到对话 </span></span><span style="display:flex;"><span>→ 模型继续推理，或结束当前轮次 </span></span></code></pre></div><p>变化发生在循环外围。可以把它拆成六个相互独立的部分：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>Plan Mode </span></span><span style="display:flex;"><span>= 会话模式状态 </span></span><span style="display:flex;"><span>+ 持续的规划指令 </span></span><span style="display:flex;"><span>+ 工具执行前的权限检查 </span></span><span style="display:flex;"><span>+ 独立的 Plan 文件 </span></span><span style="display:flex;"><span>+ 用户审批边界 </span></span><span style="display:flex;"><span>+ 审批后的上下文转换 </span></span></code></pre></div><p>这也解释了 Plan Mode 与 ReAct 类循环的关系：ReAct 描述 Agent 如何在推理和动作之间迭代，Plan Mode 描述这套循环当前处于什么权限状态，以及何时允许从调查进入有副作用的执行。</p>