多智能体系统

Claude Code 的 AgentTool 是最复杂的工具之一 — 它可以生成自主的子 Agent，每个 Agent 有独立的工具池、权限模式和系统提示。

Agent 系统架构

内置 Agent 类型

Agent 生成流程

隔离机制

Agent 可以在不同级别的隔离环境中运行：

// Worktree 隔离的创建过程
async function createAgentWorktree(agentId: string) {
  // 1. 创建新分支
  const branch = `agent-${agentId}`;
  await git.worktreeAdd(worktreePath, branch);

  // 2. 符号链接 node_modules (节省磁盘)
  await symlink(parentNodeModules, worktreeNodeModules);

  // 3. 返回隔离的工作目录
  return { path: worktreePath, branch };
}
    

Fork 子 Agent

Fork 是一种特殊的 Agent 生成模式 — 子 Agent 继承父 Agent 的完整对话上下文：

• 触发条件： isForkSubagentEnabled() 为 true 且未指定 subagent_type
• 上下文继承： buildForkedMessages() 创建合成用户消息，包含父级的工具结果 + 指令
• 防递归： 检测 FORK_BOILERPLATE_TAG，阻止 Fork 的 Fork
• 权限冒泡： permissionMode: 'bubble' — 权限提示冒泡到父会话终端
• Prompt 缓存： 字节精确传递父的渲染 System Prompt，利用缓存

Team Swarm 多 Agent 协作

Team 系统允许创建多个并行协作的 Agent：

// Team 创建流程
const team = await TeamCreateTool.call({
  team_name: "refactor-auth",
  description: "重构认证模块",
  agent_type: "lead"
});

// 团队结构
Team {
  name: "refactor-auth"
  lead: Agent           // Team Lead (协调者)
  teammates: Agent[]    // 工作 Agent 列表
  taskList: TaskList    // 隔离的任务列表
}

// Agent 间通信
SendMessageTool({
  to: "teammate-1",    // 点对点
  to: "*",              // 广播
  message: "完成后端 API 修改"
});
    

工具过滤策略