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

Concurrency on niuzj

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

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