Graphic tutorial: loading Ruflo into Claude Code, from an empty project to a team of collaborative agents图文教程:把 Ruflo 装进 Claude Code,从空项目到一支会协作的代理小队
Then do it again: add the plug-in market, → install the three-piece set, → initialize the project, and → send the first task to the → console to see what it is doing and how much it costs. About 10 minutes.
跟着做一遍:加插件市场 → 装三件套 → 初始化项目 → 派第一个任务 → 在控制台看它在干什么、花了多少钱。大约 10 分钟。

Step 1: Confirm the version and add the plugin market第一步:确认版本并加插件市场
Look at the Claude Code version: claude --version, which requires 2.1.287 or higher, and the lower version needs to be upgraded first.
Type/plugin marketplace add ruvnet/ruflo in the session to add Ruflo's plugin marketplace; then/plugin open the panel to see the ruflo entry in Marketplaces.
The plugin will run under your account privileges. Before installing it, it is recommended to look at the source code in the plugins directory, especially the routing and policy section in ruflo-mods.
先看 Claude Code 版本:claude --version,需要 2.1.287 或更高,低版本先升级。
在会话里输入 /plugin marketplace add ruvnet/ruflo,把 Ruflo 的插件市场加进来;随后 /plugin 打开面板,在 Marketplaces 里能看到 ruflo 这一项。
插件会在你的账号权限下运行,装之前建议先翻一眼 plugins 目录里的源码,尤其是 ruflo-mods 里的路由与策略部分。

Step 2: Install the three-piece set and reload第二步:装三件套并重载
Execute/plugin install ruflo-core @ ruflo,/plugin install ruflo-console @ ruflo,/plugin install ruflo-mods @ ruflo. core is the basic tool, console is the proxy cockpit, and mods provides routing and policy constraints.
After installing the/reload-plugins reload, the new command is immediately available without restarting the session.
Not Claude Code users can also play: run npx ruflo @ latest init wizard in the project directory to walk through the wizard, then open the terminal console with npx ruflo tui.
依次执行 /plugin install ruflo-core@ruflo、/plugin install ruflo-console@ruflo、/plugin install ruflo-mods@ruflo。core 是基础工具,console 是代理驾驶舱,mods 提供路由与策略约束。
装完 /reload-plugins 重载,新命令立刻可用,不用重启会话。
不是 Claude Code 用户也能玩:在项目目录跑 npx ruflo@latest init wizard 走一遍向导,之后用 npx ruflo tui 打开终端控制台。

Step 3: Initialize the project and send the first task第三步:初始化项目,派第一个任务
Execute/ruflo in the project root directory to enter the Ruflo session, which will first read the repository structure and establish the initial memory.
Give it a task that requires multi-role collaboration, such as “Add a set of integration tests to this module and easily fix obvious boundary problems.” It is automatically split into the implementation agent and the test agent, and is aggregated after parallel advancement.
After running the task, you can use the query command in/ruflo to see which agents were used for this task, which steps failed, and what the final conclusion was.
在项目根目录执行 /ruflo 进入 Ruflo 会话,它会先读一遍仓库结构,建立初始记忆。
给它一个需要多角色协作的任务,例如「给这个模块补一组集成测试并顺手修掉明显的边界问题」。它会自动拆给实现代理与测试代理,并行推进后汇总。
任务跑完可以用 /ruflo 里的查询命令回看这次任务用了哪些代理、哪些步骤失败过、最终结论是什么。

Step 4: Understand the console and costs第四步:看懂控制台与成本
ruflo-console opens the cockpit, Overview looks at the overall status, Swarm looks at the agent topology and the progress of each node, Cost accumulates the cost of this task in real time, and Events is the complete event flow.
The terminal party uses npx ruflo tui, four panels are also available, and -plain can print single-frame snapshots, which is convenient to cram into scripts or logs.
I want Codex and Cursor to be connected to the same set of memories: configure the MCP server as npx -y ruflo @ latest mcp start, and share the map and task record on both sides.
ruflo-console 打开驾驶舱,Overview 看整体状态,Swarm 看代理拓扑与各节点进度,Cost 实时累计本次任务开销,Events 是完整事件流。
终端党用 npx ruflo tui,四个面板同样都有,加 --plain 可打印单帧快照,方便塞进脚本或日志。
想让 Codex、Cursor 也接上同一套记忆:把 MCP 服务器配成 npx -y ruflo@latest mcp start,两边共享图谱与任务记录。

Step 5: Add modules as needed第五步:按需加装模块
Install ruflo-rag-memory if you need cross-session memory; install ruflo-ruvllm for model routing and cost optimization; and install ruflo-security-audit for security review.
It comes with 33 native plugins and 21 npm plugins, and the principle is "add one on demand" - each additional plugin increases the contextual overhead of each round of conversations.
The team uses suggestions to write the plugin list into the repository's .claude/settings.json, locked version, reproducible.
需要跨会话记忆就再装 ruflo-rag-memory;要模型路由与成本优化装 ruflo-ruvllm;做安全审查装 ruflo-security-audit。
自带 33 个原生插件与 21 个 npm 插件,原则是「按需加一个」——每多一个插件,每轮对话的上下文开销都会涨。
团队用建议把插件清单写进仓库的 .claude/settings.json,锁版本、可复现。

Use reminder使用提醒
This article is compiled from public sources and ships with the matching resource. Product features and pricing are subject to the official page. Resources are for learning and exchange only — please respect the original license.
本文整理自公开资料并附上配套资源;涉及产品的功能与价格以官方页面为准。资源仅供学习交流,请遵循来源许可。
⬇ Download · 点击下载:教程配套:Ruflo v3.59.17 npm 包(4.39MB)
官方 npm 包,可离线查看全部插件源码,或 npm install -g 后直接使用 CLI 与 MCP 服务器。
阅读与点赞数据保存在你的浏览器本地,欢迎留下你的想法。
今日正能量学一点,用一点;今天种下的种子,会长成明天的能力。去免费下载专区 →广告
评论 文明发言,让讨论更有价值