multi-agent-shogun

用武士层级指挥 Claude Code，并行跑任务效率翻倍

multi-agent-shogun 是一个受武士阶层启发的多智能体系统，专为 Claude Code 设计，通过 tmux 实现并行 AI 任务编排。项目采用 shogun（将军）→ karo（家臣）→ ashigaru（足轻）的层级结构，分别对应指挥官、任务分配者和执行者角色，能够将复杂任务分解为多个子任务并行处理，显著提升 AI 任务的执行效率。它解决了 Claude Code 单会话串行处理的瓶颈，让多个 AI 实例协同工作，适用于代码审查、批量重构、文档生成等场景。核心能力包括任务分解、并行执行、结果汇总和基于 tmux 的会话管理，全部由 Shell 脚本驱动，轻量且易于集成。项目目前处于成长阶段，社区活跃，为开发者提供了一种新颖的多智能体协作范式。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1425

维护状态维护中

是否开源是

定价模式 free

项目数据

分类智能体

开发团队yohey-w

所属国家

官网地址

GitHubhttps://github.com/yohey-w/multi-agent-shogun

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型ai-agent,anthropic,automation,claude-code,llm,multi-agent,parallel-processing,samurai,shogun,tmux

GitHub 星标★ 1425

30天Star增速

HF 下载量

上线时间2026-01-25 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：进阶约 15 分钟部署方式：命令行工具 8 步

环境要求

tmux（终端复用工具，用于并行会话管理）
bash 4 及以上版本
至少安装以下一种 AI CLI：Claude Code / Codex / Copilot / Kimi / OpenCode / Antigravity
Windows 用户需先安装 WSL2 与 Ubuntu，再在 WSL2 内执行安装
手机远程使用时需开启 SSH 服务（如 sudo service ssh start），且手机与服务器同网络（LAN 或 Tailscale）

安装与启动步骤

1克隆项目仓库

从 GitHub 拉取 multi-agent-shogun 源码到本地，建议放在 WSL2 或 Linux 的文件系统路径下。
```
git clone https://github.com/yohey-w/multi-agent-shogun
```
2进入项目目录

切换到克隆下来的项目根目录，后续脚本都在此目录执行。
```
cd multi-agent-shogun
```
3运行一次性初始化

first_setup.sh 会完成配置、依赖检查和 MCP 设置，只需执行一次。Windows 用户也可先运行 install.bat 检查 WSL2/Ubuntu。
```
bash first_setup.sh
```
4重新加载环境变量

让安装脚本写入的 PATH 在当前终端生效，否则可能找不到 shogun 相关命令。
```
source ~/.bashrc
```
5首次授权 Claude Code

仅首次运行需要：完成 OAuth 登录并接受 Bypass Permissions 提示，随后输入 /exit 退出该会话。
```
claude --dangerously-skip-permissions
```
6启动全部智能体

shutsujin_departure.sh 会创建 shogun 与 multiagent 两个 tmux 会话，并拉起 1 将军 + 1 家臣 + 7 足轻 + 1 军师共 10 个智能体。
```
bash shutsujin_departure.sh
```
7查看工作会话

当某个 worker 卡住时，可附加到 multiagent 会话直接观察或干预。
```
tmux attach-session -t multiagent
```
8验证 MCP 连接

列出已配置的 MCP 服务器，确认全部处于 Connected 状态。
```
claude mcp list
```

关键配置

配置项	必填	说明	示例
`SSH Host`	否	Android 手机端连接服务器用的 IP，例如 Tailscale 地址	`100.xxx.xxx.xxx`
`SSH Port`	否	服务器 SSH 端口，通常为 22	`22`
`SSH User`	否	SSH 登录用户名	`your_username`
`SSH Key Path`	否	手机端存放的私钥路径，无密钥时改用 SSH Password	`/data/data/.../id_ed25519`
`Project Path`	否	服务器端项目目录，需与克隆位置一致	`/mnt/c/tools/multi-agent-shogun`
`Shogun Session`	否	将军所在的 tmux 会话名，手机端需按此名连接	`shogun`

如何确认成功

执行 claude mcp list 所有服务器显示 Connected，且 tmux 中存在 shogun 与 multiagent 两个会话即启动成功。

常见问题

Q：MCP 工具没有加载怎么办？

A：MCP 工具是懒加载的，需要先搜索再调用。先执行 ToolSearch("select:mcp__memory__read_graph")，再调用 mcp__memory__read_graph()。

Q：智能体总在询问权限怎么办？

A：各 CLI 需以无人值守的权限模式启动，shutsujin_departure.sh 已自动处理该设置，一般无需手动配置。

Q：某个 worker 卡住不动怎么办？

A：执行 tmux attach-session -t multiagent 附加到 agent 会话，可在对应 pane 中直接运行 claude --model opus --dangerously-skip-permissions 恢复。

Q：Windows 上怎么安装？

A：运行 install.bat，它会自动检查并引导安装 WSL2 与 Ubuntu，之后在 WSL2 内执行 first_setup.sh 即可。

Q：想只配置会话不启动 CLI 怎么办？

A：使用 ./shutsujin_departure.sh -s 或 ./shutsujin_departure.sh --setup-only，仅创建 tmux 会话而不拉起 AI 进程。

注意事项

first_setup.sh 只需执行一次；需要重新配置时可再次运行该脚本。
项目会创建 shogun 与 multiagent 两个 tmux 会话，下达指令请进入 shogun 会话。
README 提到作者已转向后继项目 kagemusha，但 multi-agent-shogun 本身仍可正常使用。
需要 Claude Code 原生版本时，安装后可用 npm uninstall -g @anthropic-ai/claude-code 卸载 npm 版本。

核心亮点

基于 tmux 的并行执行，显著提升多任务处理速度
清晰的 shogun/karo/ashigaru 层级，任务分工明确
纯 Shell 实现，依赖少，易于定制和扩展

不足之处

文档/社区待观察
仅适配 Claude Code，生态绑定较紧

适用场景

大型代码库的批量重构与自动化修改
并行运行多个独立测试或代码审查任务
生成多模块文档或执行重复性开发工作

替代项目

Claude Code 内置的 subagent 功能、AutoGPT、MetaGPT

项目介绍

multi-agent-shogun 是智能体领域的开源项目，由 yohey-w 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,425）位列前 30%，在智能体分类中处于中上游。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：大型代码库的批量重构与自动化修改。同类可对比的替代方案包括 Claude Code 内置的 subagent 功能、AutoGPT、MetaGPT。

上一篇：harness-anything

下一篇：fim-one