claude-flow (ruflo)

★ 64.160

面向 Claude Code、Codex 等的多智能体编排：集群（swarm）、自适应记忆、RAG 集成。

claude-flow（仓库已改名为 ruflo；npm 包 claude-flow 与 ruflo 并行存在，目前两者都是 3.25.6 版本）是一个面向 Claude Code、Codex 及其他编程智能体的多智能体编排框架。核心是「Queen-led」蜂群协调机制：多个智能体分工处理子任务，通过共识机制（Raft、Byzantine、Gossip）同步，并共享同一个内存。

这个共享内存（AgentDB）采用 HNSW 索引进行向量搜索，根据项目文档，在较小数据量下比朴素暴力搜索快数倍；此外还支持混合搜索和图遍历。通过 SONA 神经模式和「ReasoningBank」，智能体可以从过去的任务轨迹中学习，并在未来类似任务中复用成功的策略。

该框架与模型无关（支持 Claude、GPT、Gemini、Cohere，以及通过 Ollama 本地运行），带有自动路由功能，通过五组服务器（Core、Intelligence、Agents、Memory、DevTools）提供约 210 个 MCP 工具，也可作为一组 Claude Code 插件安装（如 ruflo-core、ruflo-swarm、ruflo-rag-memory）。其联邦（Federation）功能允许跨团队或组织边界通过 WebSocket 连接多个 claude-flow 实例，并在它们之间传递任务。

🔧 SETUP

交互式设置：`npx ruflo@latest init wizard`（不使用向导：`npx ruflo@latest init`）
也可全局安装：`npm install -g ruflo@latest`
在 Claude Code 中注册为 MCP 服务器：`claude mcp add ruflo -- npx ruflo@latest mcp start`
可选作为 Claude Code 插件安装：`/plugin install ruflo-core@ruflo`、`/plugin install ruflo-swarm@ruflo`、`/plugin install ruflo-rag-memory@ruflo`
如需跨团队联网：`npx claude-flow@latest federation init`，或加入：`federation join wss://...`

✅ 什么时候用？

并行协调多个智能体

将一个复杂功能拆分为多个子任务，多个智能体以蜂群拓扑同时协作，共享同一个内存。

希望智能体从经验中学习

SONA/ReasoningBank 会记住成功的任务轨迹，并在未来类似任务中重新应用。

⛔ 什么时候不该用？

单个简单任务

对于一个单个智能体就能独立完成的、边界清晰的简单任务来说，蜂群、内存和共识机制带来的开销并不划算。

更好的选择: 直接使用 Claude Code，无需编排层。

没有基础设施时的跨团队联邦

Federation 需要一个可访问的 WebSocket 端点（wss://）——没有自建服务器基础设施就无法真正发挥作用。

更好的选择: 只用本地单实例部署，不使用 federation 相关命令。