Claude Code Plan Mode：权限边界与审批机制

Mon, 13 Jul 2026 00:00:00 +0800

Plan Mode 最容易被误解为一段“先分析、再执行”的提示词。这个解释描述了模型表面的行为，却回避了一个更重要的工程问题：如果模型在规划阶段仍然发起了写文件或执行命令的 Tool Call，谁负责阻止它？

答案不能只是另一段 Prompt。Prompt 可以约束模型的倾向，不能构成可验证的权限边界。Claude Code 的 Plan Mode 本质上是 Agent Runtime 中的一种权限模式：它在原有 Agent Loop 之上叠加会话状态、运行时提醒、本地权限检查、Plan 文件和人工审批链路。

本文把证据分成两类。用户可见的行为以 Claude Code 官方 Plan Mode 文档为准；消息构造、内部状态和审批后的上下文转换，则来自本机 Claude Code 2.1.207 源码快照，对应构建提交 bc512d56332530b2be3f5079e29ec17aa20b8553。后者是特定版本的逆向观察，不应视为稳定 API。

Plan Mode 没有替换 Agent Loop

进入 Plan Mode 后，Claude Code 仍然运行同一套模型与工具循环：

构造模型请求
→ 模型返回文本或 tool_use
→ Claude Code 在本地处理工具调用
→ tool_result 回到对话
→ 模型继续推理，或结束当前轮次

变化发生在循环外围。可以把它拆成六个相互独立的部分：

Plan Mode
= 会话模式状态
+ 持续的规划指令
+ 工具执行前的权限检查
+ 独立的 Plan 文件
+ 用户审批边界
+ 审批后的上下文转换

这也解释了 Plan Mode 与 ReAct 类循环的关系：ReAct 描述 Agent 如何在推理和动作之间迭代，Plan Mode 描述这套循环当前处于什么权限状态，以及何时允许从调查进入有副作用的执行。

Claude Code 工具并发机制：依赖与安全边界

Mon, 13 Jul 2026 00:00:00 +0800

当模型在一条回复中返回多个 tool_use 时，客户端应该并行执行，还是严格按数组顺序串行执行？

只看 Anthropic API 的消息结构，很难得到完整答案。API 负责表达模型已经提交了哪些调用，却没有提供 depends_on、sequence 或 parallel 之类的调度字段。真正执行这些调用的 Agent Runtime，还需要结合工具副作用、输入参数和当前执行状态做第二次判断。

Claude Code 的处理方式可以概括为两层：模型负责表达语义依赖，Runtime 负责约束运行时安全。两层共同决定一次 Tool Call 最终以并发、串行还是动态交错的方式执行。

本文涉及两类信息，适用范围需要先说明：

Anthropic API 的 tool_use / tool_result 消息结构以官方 Parallel tool use 文档为准；
Claude Code 的调度细节来自本机 Claude Code 2.1.207 源码快照，基线构建提交前缀为 bc512d563325，完整哈希见文末。内部函数、调用关系和默认值都属于特定版本的实现观察，不是 Anthropic API 的长期兼容协议，后续版本可能调整。

API 表达调用，Runtime 决定执行方式

按照 Claude Code 的系统提示约定，两个互不依赖的文件读取可以出现在同一条 Assistant Message 中：

{
  "role": "assistant",
  "content": [
    {
      "type": "tool_use",
      "id": "toolu_01",
      "name": "Read",
      "input": { "file_path": "src/a.ts" }
    },
    {
      "type": "tool_use",
      "id": "toolu_02",
      "name": "Read",
      "input": { "file_path": "src/b.ts" }
    }
  ]
}

在 Claude Code 的提示约定下，这条消息表示模型认为两个调用在当前时点都已经具备提交条件。它没有进一步声明客户端必须并发执行，也没有声明二者存在先后关系。

Agent Runtime on niuzj

Claude Code Plan Mode：权限边界与审批机制

Plan Mode 没有替换 Agent Loop

Claude Code 工具并发机制：依赖与安全边界

API 表达调用，Runtime 决定执行方式