---
title: "swarm"
url: "https://claudemods.dev/zh-cn/builds/swarm-b2ed59"
source: "https://github.com/OneWave-AI/claude-code-mods/tree/main/swarm"
source_type: "github"
repo: "https://github.com/OneWave-AI/claude-code-mods/tree/main/swarm"
author: "OneWave-AI"
author_handle: "OneWave-AI"
stars: 29
category: "多智能体与编排"
categories: ["agents"]
tags: ["Claude Code", "mod"]
permission_level: 2
scan_complete: false
install: "claude plugin marketplace add OneWave-AI/claude-code-mods\nclaude plugin install swarm@claude-code-mods"
added: "2026-10-04T10:40:34.373Z"
updated: "2026-10-03T08:35:11Z"
locale: "zh-cn"
content_locale: "zh-cn"
---

# swarm

swarm：子代理和代理团队的调度中心：谁在运行、每个在做什么、谁派生了谁、谁在与谁通信

## Description

# swarm

子代理和代理团队的调度中心：谁在运行、每个在做什么、谁派生了谁、谁在与谁通信，以及它们如何重叠。

![swarm](../screenshots/swarm.png)

`/swarm` 打开一个实时面板，包含编排树（主代理在顶部，每个子代理嵌套在其派生者下，显示类型、模型、当前操作和工具调用次数）、代理重叠的时间线、代理间消息的弧线和日志，以及活动流。运行代理时状态行显示实时数量，swarm 关闭时有提示汇总情况。

## 安装

在 Claude Code 会话中（2.1.287 或更高版本）：

```
/plugin marketplace add OneWave-AI/claude-code-mods
/plugin install swarm@claude-code-mods
```

或加载此文件夹用于一次会话：`claude --plugin-dir ./swarm`

## 它的访问范围

| 模块 | 网络 | 运行进程 | 文件 | 调用模型 | 发送数据到任何地方 |
| --- | --- | --- | --- | --- | --- |
| swarm | 否 | 否 | 否 | 否 | 否 |

它通过 `$.agent.list` 以及 `agent.spawn`、`tool.call`、`session.send` 和 `session.receive` 事件读取代理状态。运行 `claude plugin validate ./swarm` 可列出它挂钩的每个事件和它发出的每个调用。完整安全说明见[仓库 README](../README.md#security)。

由 [OneWave AI](https://www.onewave-ai.com) 开发的 [claude-code-mods](https://github.com/OneWave-AI/claude-code-mods) 的一部分。MIT 许可。

## Install

```
claude plugin marketplace add OneWave-AI/claude-code-mods
claude plugin install swarm@claude-code-mods
```

## Original README

# swarm

Mission control for subagents and agent teams: who is running, what each is doing, who spawned whom, who is talking to whom, and how they overlap.

![swarm](../screenshots/swarm.png)

`/swarm` opens a live pane with an orchestration tree (lead at the top, every subagent nested under whoever spawned it, with its type, model, current action and tool-call count), a timeline of how the agents overlap, arcs and a log for messages between agents, and an activity feed. A status line shows the live count while agents run, and a toast sums things up when the swarm stands down.

## Install

In a Claude Code session (2.1.287 or later):

```
/plugin marketplace add OneWave-AI/claude-code-mods
/plugin install swarm@claude-code-mods
```

Or load this folder for one session: `claude --plugin-dir ./swarm`

## What it reaches

| Mod | Network | Runs processes | Files | Calls a model | Sends data anywhere |
| --- | --- | --- | --- | --- | --- |
| swarm | No | No | No | No | No |

It reads agent state through `$.agent.list` and the `agent.spawn`, `tool.call`, `session.send` and `session.receive` events. Run `claude plugin validate ./swarm` to list every event it hooks and every call it makes. See the [repository README](../README.md#security) for the full security notes.

Part of [claude-code-mods](https://github.com/OneWave-AI/claude-code-mods) by [OneWave AI](https://www.onewave-ai.com). MIT licensed.
