cj-vana/claude-swarm

这是什么？

核心功能

• 01在 tmux 会话中并行运行 Claude Code 工作节点，每个节点使用独立的 git worktree。
• 02持久化会话状态和检查点，崩溃或重启后可继续执行。
• 03对复杂功能采用先规划、后实施的两阶段流程。
• 04功能标记完成前必须通过验证命令，失败可自动重试。
• 05通过行为协议约束工作节点，启动前校验并在执行中监控违规。
• 06提供实时网页面板，展示工作节点的终端输出。

适用场景

• 将包含认证和测试的 REST API 等大型功能集拆分给并行编码智能体。
• 运行需要中断后仍能恢复的数小时自主编码任务。
• 通过明确的协议限制自主编码智能体可访问或执行的内容。
• 在浏览器面板中同时监控多个智能体工作节点。

快速上手

1. 1

   安装前置依赖：Node.js 18+、tmux、Claude Code CLI

2. 2

   一键安装（克隆、构建、注册 MCP 服务并安装技能）

   按 README 中的官方说明安装
3. 3

   或手动安装：克隆、安装依赖、构建

   git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build
4. 4

   在 Claude Code 中注册 MCP 服务

   claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

使用前须知

• !需要同时安装 tmux、Claude Code CLI 和 Node.js 18+。
• !它编排的是 Claude Code 工作进程，因此依赖该工具及其使用成本。

标签

常见问题

claude-swarm 是什么？

一个 MCP 服务器，通过 tmux 和 git worktree 编排并行运行的 Claude Code 工作节点，并支持行为协议约束和实时监控面板。 Claude Swarm 是一个 MCP 服务器，让 Claude Code 会话充当编排者，协调多个 Claude Code 工作节点并行工作。每个工作节点运行在独立的 tmux 会话和隔离的 git worktree 中，负责实现一个功能并回报状态。服务器将会话状态持久化到磁盘，配合检查点和心跳检测，使工作在上下文压缩、崩溃或机器重启后仍可恢复。

claude-swarm 可以免费使用吗？用的什么许可证？

claude-swarm 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

claude-swarm 还在维护吗？

超过半年未提交。claude-swarm 最近一次提交是在 2026年2月11日。

claude-swarm 适合用来做什么？

将包含认证和测试的 REST API 等大型功能集拆分给并行编码智能体。 运行需要中断后仍能恢复的数小时自主编码任务。 通过明确的协议限制自主编码智能体可访问或执行的内容。 在浏览器面板中同时监控多个智能体工作节点。

claude-swarm 怎么安装和运行？

安装前置依赖：Node.js 18+、tmux、Claude Code CLI 一键安装（克隆、构建、注册 MCP 服务并安装技能） 或手动安装：克隆、安装依赖、构建: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build 在 Claude Code 中注册 MCP 服务: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

在哪里获取 claude-swarm？

源代码和安装说明在 GitHub 上：https://github.com/cj-vana/claude-swarm