写 Agent 工具链的人最近都在念叨一句口头禅:Agent = 模型 + Harness。模型负责动笔,Harness 负责给它工具、记忆、循环、沙箱和控制权。Claude Code、Codex 就是 Harness,模型换起来不用重写那几万行工程代码——这就是为什么 2026 年下半年,Agent 生态的重心从”造模型”往”造 Harness”移了一大截。
而 Ruflo(前身 Claude Flow)就是这条路上星数最猛的一个项目:73,761 星、8,761 fork、MIT 协议,2026 年 6 月 2 日建仓,10 月 3 日还在推代码。发布节奏排到第 1,662 个 release,最新版本 v3.51.1。npm 上 ruflo 包上月下载 20.7 万次,claude-flow 老名字还有 8 万。
它到底是什么
一句话:Ruflo 是给 Claude Code 和 Codex 套在外面的那一层执行层,你还是在 Claude Code 里写代码,但多出来的 100+ 个专职 Agent 替你并行干活。
架构链路很短:你的提示词 → Ruflo 路由器 → Swarm 集群 → 具体 Agent → 记忆层 → 模型提供方,跑完再把结果回灌给学习循环。
几个卖点是实打实的:
- 100+ 专业 Agent:编码、测试、安全审计、写文档、定架构,各有分工
- Swarm 集群:层级、网状、自适应三种拓扑,带共识机制;Queen 主导的层级拓扑默认 15 个 Agent 一起干活
- HNSW 向量记忆:官方自己的审计报告说 N=20k 时比暴力搜索快约 1.9 倍,N=5k 时快 3.2–4.7 倍,recall@10 约 0.99。注意人家写得很老实——小数据量下 ANN 不一定赢
- 跨机联邦(Federation):mTLS + ed25519 互相认证,出站消息过一遍 14 类 PII 检测管道,可 BLOCK / REDACT / HASH / PASS。信任分公式是
0.4×成功率 + 0.2×在线率 + 0.2×威胁 + 0.2×完整性,表现好慢慢升级,干坏事立刻降级 - 多模型路由:Claude、GPT、Gemini、Cohere、Ollama 五个源带故障转移
一句话概括它和 CrewAI、AutoGen 的区别:那两个是你写代码去调,Ruflo 是你在终端正常干活,它在后面自己协调。
上手:我真跑了一遍
安装只有一条命令,Node 环境直接 npx ruflo@latest init。我在一台 A7Z 上实测,过程如下。
装完落地的东西:.claude/ 目录 2.3 MB,里面 agents、commands、skills、helpers、settings.json 全套;还有 .claude-flow/ 92 KB、.swarm/、.agents/、.codex/、.mcp.json、AGENTS.md、CLAUDE.md,以及一个 ruvector.db 向量库文件。
.mcp.json 里已经自动写好了 claude-flow 这个 MCP server,CLAUDE_FLOW_TOPOLOGY 默认 hierarchical-mesh,CLAUDE_FLOW_MAX_AGENTS 写死 15。
然后 ruflo swarm init,回显给了一张表:Swarm ID、拓扑层级、上限 15、自动扩展开启、通信走 message-bus。ruflo status 也正常,Agent / Task / Memory / MCP Server 四个区块都出得来。
上手门槛说白了就三个命令:init → swarm init → start。装完你就继续正常用 Claude Code,hooks 会在后台悄悄路由任务、记录成功模式、协调 Agent——官方原话是”你不需要学 314 个 MCP 工具和 26 条 CLI 命令”。
实话:几个必须提前知道的坑
我得说几个实测出来的问题,不然就是不负责任。
第一,插件安装直接失败了。 init 阶段它自己去装 ruflo-console、ruflo-swarm、ruflo-mods 三个 Claude Code 插件,三个全部报错 invalid manifest file / Unrecognized key: "options"。这是它自带的 plugin.json 和当前 Claude Code 的 manifest 校验对不上,属于上游兼容性问题。更别扭的是它给出的修复提示是错的——README 里让跑 claude plugin marketplace update ruflo,但 ruflo plugin(单数)这条命令根本不存在,只有 plugins(复数),直接报 Unknown command: plugin。
第二,星数虚高得有点明显。 691 个 open issue、1,161 个 closed,最近的 open issue 名字相当诚实:[Dream Cycle] memory: HNSWIndex serialize/deserialize drops quantizer state、harness、ruflo-adr: edge keys use '->', which the memory key validator rejects, so no edges are stored。专门有个叫 “Dream Cycle” 的机器人每天开 issue 记录自己的 bug。项目 README 里那些”352 倍加速””SOTA 跑赢 LangGraph/AutoGen/CrewAI 1.3–1953 倍”的说法,都是自己发布的基准 gist,没有人复核。
第三,安装是侵入式的。 它会往你的项目里写 CLAUDE.md、AGENTS.md、改 .claude/settings.json、塞 267 个插件技能,还装了三个已经失败的 Claude Code 插件标记。装之前最好先 git 干净、单独开个分支。
第四,Node 依赖有 deprecated 警告。 [email protected] 已弃用,安装时满屏 npm warn。
第五,它不是给所有人准备的。 314 个 MCP 工具、1,662 个 release、267 个技能——这个体量对新手是灾难。它适合的是已经在 Claude Code 上跑生产、有明确痛点(记忆不跨会话、任务不会自动并行、跨机器不通信)的人。如果你就是想”写个 AI 应用发出去”,Dify、Flowise 那条线更顺。
顺带一提,它 1662 个 release 里带 alpha 版本滚动发布,还有个 ruflo verify 命令能用签名见证证明你装的字节没被篡改——这种细节挺有意思,说明作者在意信任,但同时 691 个 open issue 也是实打实的。
什么时候该考虑它
如果你已经在用 Claude Code 或 Codex,并且遇到了”每次开新会话记忆全丢””任务只能一个一个串行””想让家里几台机器的 Agent 互相搭把手”这三类问题,Ruflo 值得花一个下午试。反过来,你只是想要个漂亮的 Agent 界面或者拖拽式工作流,装这个是给自己找麻烦。
它 73.7K 星不是没有理由——把多 Agent 协调从”自己写调度代码”变成一条 init 命令,这个价值是真实的。但 1,662 个 release 和 691 个开着的 issue 也说明,它现在更像一个跑得飞快但还在颠簸的高速列车。上车之前,先 git commit。
by 数码罗记 · godsun.pro
数据核实时间:2026-10-03 16:33 CST。星数、fork 数、npm 下载量来自 GitHub API 与 npm registry 实测;安装过程与错误信息为本机 A7Z 上 npx ruflo@latest init 真实运行结果;issue 数据来自 GitHub Search API。文中所述 ruflo plugin 命令不存在、插件 manifest 校验失败等问题均为本次实测复现。