Ruflo：给 Claude Code 与 Codex 套一层多智能体协作的 harness

Claude Code 和 Codex 各自能把一件事做完，但「让一组 Agent 分工、互相交接、记住上次的结论」通常要自己搭脚手架。Ruflo（原名 Claude Flow）就是这层脚手架：它把自己定位成 agent harness，在编码工具之外补上任务编排、swarm 协作、跨会话记忆、联邦通信和成本追踪。仓库截至 2026-10-18 有 76,279 颗星，采用 MIT 许可，主要语言 TypeScript。

核心功能

• 两种安装路径，面积差别很大：Claude Code 插件路线只装斜杠命令与 Agent 定义，工作区几乎不留文件；npx ruflo init 的 CLI 路线会写入 .claude/、.claude-flow/、CLAUDE.md，注册 MCP server 并安装 hooks，功能完整但侵入性更强。README 明确让使用者按需要选，而不是默认全装。
• swarm 与路由：支持层级、网状和自适应拓扑，配共识机制；ruflo-mods 在进程内做提示路由与策略执行。官方也说明插件以你的账号权限运行、没有沙箱，安装前应自己读代码。
• 跨会话记忆：ruflo-rag-memory 走混合检索、图跳转与多样性排序，ruflo-rvf 负责保存与恢复会话记忆，ruflo-agentdb 提供向量库。README 里的 HNSW 数字标注了测法与条件（N=20k 约 1.9×、N=5k 约 3.2–4.7× 对比暴力检索，recall@10 约 0.99），并写明小规模下可能持平或更差。
• 联邦通信：不同机器上的 Agent 可跨安装协作，用 mTLS 加 ed25519 做身份校验，出站前剥离 PII，未受信节点只能看到发现信息而非记忆。
• 可观测与审计：控制台并排显示工作流、Agent、模型、token 与成本；ruflo-metaharness 给现有 Agent 配置打分、扫描工具配置风险并跟踪回归；ruflo eject 可把项目导出成独立的 agent toolkit。

典型使用场景

• 需要多个 Agent 分工的复杂改造：把审计、实现、测试拆给不同 Agent，由 swarm 协调并汇总，而不是在一个会话里串行推进。
• 跨会话的长任务：靠持久记忆把上一次的结论带入下一次，避免每次重述背景。
• 多台机器或多人协作：联邦层让不同环境中的 Agent 交换工作结果，同时对数据出站做过滤。
• 想先量成本再决定：控制台与 cost tracker 能按模型统计 token 和费用，适合先测一轮再决定是否长期使用。

安装前值得先量三件事：插件会往工作区写什么、hooks 拦截哪些动作、以及你实际要开几个 Agent。功能清单越长，越容易装上用不到的部分，而每一项都在扩大权限面。

边界也要一并看清：官方在多处标注演示动画「不是 swarm 已完成工作或记忆召回的证据」，实际效果取决于你配置的记忆、学习组件与反馈质量；插件无沙箱、以账号权限运行；CLI 路线会改动工作区文件与 hooks，接入前应在分支或副本上试。它不替代 Claude Code 或 Codex，而是包在它们外面的执行层。和 XERJ 只做检索与记忆不同，Ruflo 管的是任务编排与协作；两者可以叠加使用。

快速上手

最轻的方式是只装插件：

/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo

需要完整能力时走 CLI：

npx ruflo@latest init wizard
npx -y ruflo@latest mcp start

支持本地 stdio MCP 的客户端，把命令配成 npx、参数配成 ["-y", "ruflo@latest", "mcp", "start"] 即可。只想在终端看状态，可以跑 npx ruflo tui。

小结

Ruflo 适合已经在用 Claude Code 或 Codex、想把单 Agent 工作流升级成多 Agent 协作并保留可观测性的团队。它把编排、记忆、联邦和成本追踪放在同一套 harness 里，安装路径可选、迁移路径（eject）也留了出口；代价是功能面很大，插件与 hooks 会实际介入你的工作区和权限边界，需要先读代码再决定装哪几个。项目采用 MIT 许可，主要语言 TypeScript，截至 2026-10-18 有 76,279 颗星。