Ruflo 使用教程

📖 项目简介

Ruflo（前身为大名鼎鼎的 claude-flow）是 GitHub 上超过 64K Star 的开源多智能体编排平台（agent meta-harness）。它给 Codex、Claude Code 等 AI 编程助手装上一支「AI 分身蜂群」：内置 100+ 个专业智能体（写代码、跑测试、安全审计、架构设计……），你只需要提一句需求，它就自动拆解任务、派工协作、并行开发，最后测试全绿、整个项目直接交付。

Ruflo 还带自我学习记忆（踩过的坑跨会话记住，越用越聪明）、独立工作区隔离（多个分身同时改代码互不打架）、RAG 集成和企业级安全护栏，采用 MIT 协议完全开源免费。

📎 相关链接与下载地址（点击展开）

GitHub 项目： github.com/ruvnet/ruflo
快速开始文档： github.com/ruvnet/ruflo/wiki/Quick-Start
在线体验（免安装）： flo.ruv.io
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🐝

100+ AI 分身蜂群

写码、测试、审计、架构各司其职，自组织成蜂群并行开工

🧠

自我学习记忆

跨会话记忆，从每次任务中学习，踩过的坑下次自动绕开

🧪

自动写码自动测试

一句话拆任务、写代码、跑测试，测试全绿才交付

🔌

原生接入 Codex

一行命令接入 Codex / Claude Code，注册 314 个 MCP 工具

🚀 如何使用

准备环境

安装 Node.js 20+（自带 npm 9+）和 Git，Windows / macOS / Linux 全平台支持。

一行命令初始化

在你的项目根目录运行交互式向导，自动生成配置、智能体定义和 hooks：

bashnpx ruflo@latest init wizard

初始化后可以运行 npx ruflo@latest doctor --fix 自检环境是否就绪。

接入 Codex / Claude Code（MCP）

把 Ruflo 注册成 MCP 服务器，AI 助手就能直接调用蜂群、记忆、安全扫描等 314 个工具。以 Claude Code 为例：

bashclaude mcp add ruflo -- npx ruflo@latest mcp start

Codex 等其他支持 MCP 的助手，把同样的启动命令 npx ruflo@latest mcp start 填进各自的 MCP 配置即可。

启动蜂群，一句话交付项目

可选启动后台守护进程，开启自主任务循环：

bashnpx ruflo@latest daemon start

然后正常使用 Codex / Claude Code，直接丢一句需求（比如「帮我做一个电商网站」）。hooks 系统会在后台自动拆任务、派发给合适的智能体、并行写码跑测试，你也可以手动开一个 8 人蜂群：

bashnpx ruflo@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized

❓ 常见问题

Q: Ruflo 和 claude-flow 是什么关系？

同一个项目。2026 年初因商标原因从 Claude Flow 改名为 Ruflo，npm 包与部分 CLI 命令仍保留 claude-flow 以向后兼容。v3 版本用 TypeScript + WASM 内核重写了 25 万行以上代码。

Q: 只用 Codex，不用 Claude Code 能用吗？

可以。Ruflo 是通用的 MCP 服务器，Codex、Cursor、Cline 等任何支持 MCP 的 AI 助手都能接入；README 也明确标注原生支持 Claude Code / Codex / Hermes。

Q: 插件安装和 CLI 完整安装选哪个？

想快速尝鲜可以用 Claude Code 插件（只有斜杠命令，没有 MCP 工具）；生产使用推荐 CLI 完整安装（npx ruflo@latest init），才有完整的 98 个智能体、记忆系统、蜂群协调和 hooks。

Q: 收费吗？对硬件有要求吗？

MIT 协议完全开源免费。Ruflo 本身只是编排层，不跑大模型，普通电脑即可；实际写码消耗的是你接入的 AI 助手（Codex / Claude Code）的额度。