RuFlow (Ruflo): обзор и установка

Коротко

Первое, что экономит полчаса: проекта «RuFlow» с буквой w не существует. Репозиторий называется ruvnet/ruflo, npm-пакет — ruflo. Раньше проект звался Claude Flow, и следы старого имени до сих пор торчат в его же документации. Автор — Реувен Коэн (rUv). На 28 июля 2026 по данным GitHub API: 66 386 звёзд, 7 910 форков, 851 открытый issue, лицензия MIT, последний релиз v3.32.26 вышел в тот же день.

Что это: мета-обвязка поверх Claude Code и Codex. Она добавляет к одиночному агенту рой специализированных агентов, общую векторную память между сессиями, хуки-маршрутизаторы, MCP-сервер и федерацию агентов между машинами. Модель по-прежнему пишет код — Ruflo занимается координацией.

Установка идёт двумя разными путями, и разница между ними принципиальная. Плагин для Claude Code даёт только слэш-команды и не регистрирует MCP-сервер — половина примеров из документации в этом режиме не работает. Полный контур ставится одной командой npx ruflo@latest init wizard, но кладёт в проект .claude/, .claude-flow/, свой CLAUDE.md и настройки. Требуется Node.js 20+ и уже установленный Claude Code.

Что это и кому

Идея, вокруг которой всё построено, формулируется в README одной строкой: агент = модель + обвязка. Модель пишет, обвязка даёт ей инструменты, память, циклы и ограничители. Ruflo — это обвязка.

Практическая разница: обычный Claude Code держит один контекст — вы ставите задачу, он думает и правит файлы. Ruflo перехватывает задачу хуками, раскладывает её на роли (планировщик, кодер, тестировщик, ревьюер безопасности), запускает их параллельно и складывает результаты в векторную память, откуда достаёт похожие решения в следующей сессии.

Кому это реально нужно:

• Задачи, которые естественно распадаются на параллельные ветки: рефакторинг с одновременным написанием тестов, аудит безопасности поверх продолжающейся разработки.
• Долгие проекты, где ценно, чтобы агент помнил решения прошлой недели, а не начинал с нуля каждую сессию.
• Сценарии с несколькими провайдерами: простые шаги — локальной модели, сложные — Claude.

Кому не нужно: если задача одиночная и линейная, встроенных субагентов Claude Code хватает с запасом, и они не тащат в проект четыре служебных каталога. Если вы вообще только заходите в тему — сначала стоит понять, что такое агентный кодинг, а рой оставить на потом.

Как начать

Требования из USERGUIDE: Node.js 20+, npm 9+ (или pnpm/bun) и глобально установленный Claude Code (npm install -g @anthropic-ai/claude-code). Порядок важен: Ruflo при инициализации прописывается в конфиг Claude Code, поэтому Claude Code должен быть на месте раньше.

Дальше выбираете один из двух путей. Разница — не в удобстве, а в том, что вообще будет работать:

Таблица — из README проекта. Вывод простой: если после установки плагина swarm_init не вызывается, это не баг, а выбранный путь установки.

Путь A, плагины. Внутри сессии Claude Code:

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo

Путь B, полная установка. Интерактивный мастер, работает одинаково на macOS, Linux, WSL и в родном PowerShell:

npx ruflo@latest init wizard

Есть и однострочник через curl ... | bash, но он требует POSIX-шелла и означает запуск скачанного по сети скрипта. Вариант с npx делает то же самое, работает везде и проще откатывается.

Отдельно можно зарегистрировать MCP-сервер:

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

После установки ничего специально учить не надо: хуки перехватывают обычные запросы к Claude Code и раскидывают их сами. CLI нужен для того, что в диалог не укладывается — ruflo swarm init --topology hierarchical --max-agents 8, ruflo memory search --query "auth patterns", ruflo doctor --fix для диагностики установки.

Если после init ничего не изменилось, порядок проверки такой: node -v (должно быть 20+), наличие .claude-flow/ в корне проекта, регистрация MCP-сервера в claude mcp list, и только потом ruflo doctor --fix.

Что реально умеет

Здесь полезно сравнить две цифры из документации самого проекта — маркетинговую и инвентарную.

Инвентарь в STATUS.md собирается скриптом из репозитория — ему я верю больше. Нюанс: этот снимок зафиксирован на версии ruflo@3.10.2 от 25 мая 2026, а актуальная — 3.32.26. Даже автогенерируемый статус отстаёт на десятки версий: проект растёт быстрее, чем успевает себя описывать.

Что подтверждается кодом и работает:

• Векторная память. AgentDB с HNSW-индексом, живёт между сессиями. Заявленный прирост — около 1,9 раза к полному перебору при 20 тыс. записей и до 4,7 раза при 5 тыс., recall@10 порядка 0,99; авторы честно оговаривают, что на малых объёмах выигрыша нет.
• Мультипровайдерная маршрутизация. Claude, GPT, Gemini, Cohere, Ollama с переключением при отказе.
• Плагины под конкретные задачи: ruflo-cost-tracker (учёт токенов и бюджеты), ruflo-security-audit, ruflo-testgen, ruflo-observability.
• Федерация с mTLS и ed25519, вырезанием PII из исходящих сообщений и оценкой доверия к пирам.
• Веб-интерфейс flo.ruv.io — бета, работает без установки и без своего ключа.

Где не справляется

Документация противоречит сама себе. В README живут команды npx claude-flow@latest federation init — под старым именем пакета. Ссылка «Issues & Bugs» в разделе поддержки ведёт на репозиторий ruvnet/claude-flow. Значок звёзд считает звёзды другого репозитория. Для новичка это минное поле: копируете команду из официального README и получаете не тот пакет.

851 открытый issue. Для проекта такого размера это не приговор, но и не «всё стабильно». Перед тем как ставить на боевой проект, стоит поискать в issues свой сценарий.

Бенчмарки авторские. Сравнение с LangGraph, AutoGen и CrewAI с выигрышем «в 1,3–1953 раза» опубликовано самим автором в gist. Независимого воспроизведения я не нашёл. Заявленная «точность маршрутизации 89%» приводится без методики измерения — на что именно 89%, не сказано.

Релиз каждый день. Версия 3.32.26 вышла 28 июля 2026, в тот же день, что и последний коммит в main. При такой частоте фиксируйте версию явно (npx ruflo@3.32.26), иначе поведение вашего проекта поменяется само по себе между двумя запусками.

Рой тратит больше токенов, чем один агент. Это следует из устройства: несколько агентов одновременно держат свои контексты и делают свои вызовы модели. Конкретного множителя я не приведу — он зависит от топологии, числа агентов и задачи, и любые «в N раз» без вашего собственного замера будут выдумкой. Практический совет: поставьте ruflo-cost-tracker в первый же день и замерьте на своей задаче, прежде чем разворачивать рой на восемь агентов.

Российский контекст. Всё это — надстройка над Claude Code, а не замена ему. Anthropic не обслуживает Россию, и оплата подписки российской картой не проходит; практические варианты разобраны в материалах про тарифы и оплату Claude Code и доступ к Claude API из России. Мультипровайдерная маршрутизация Ruflo частично спасает: часть нагрузки уводится на другие модели или локальную Ollama. Но базовый сценарий «рой поверх Claude Code» без рабочего доступа к Claude не запустится.

Данные уходят из проекта. Федерация, облачные провайдеры и внешняя память — дополнительные точки выхода содержимого репозитория за пределы машины. PII-фильтр в федерации есть, но единственным контуром защиты в проекте с персональными данными он быть не может.

Сколько стоит

Сам Ruflo бесплатен: MIT, весь код открыт, никаких платных тарифов у проекта нет. Веб-бета на flo.ruv.io тоже открыта без аккаунта и API-ключа.

Платите вы за токены — своим планом Claude Code или API-ключами провайдеров. И это главная статья расходов: рой из восьми агентов на одной и той же задаче стоит заметно дороже одиночного агента. Отсюда и практическое правило — начинать с двух-трёх агентов, а не с максимальной топологии, и держать cost-tracker включённым. Как вообще делится работа между ролями, разобрано в материале про агентов и роли в команде.

Альтернативы

Прежде чем ставить рой, честно проверьте более простые варианты.

Встроенные субагенты Claude Code. Бесплатно, ничего не устанавливается, нет служебных каталогов в проекте. Закрывают большинство задач, где нужно «отправь параллельно проверить тесты».

Ручная оркестрация. Два-три терминала с Claude Code на разных ветках — примитивно, зато прозрачно по токенам и не ломается при обновлении пакета.

Визуальные конструкторы (n8n, Dify, Flowise) — если вам нужна не разработка кода, а автоматизация процессов с наглядной схемой.

Ruflo выигрывает там, где нужны именно долгая память между сессиями, дисциплина ролей и учёт стоимости — то есть на длинных проектах, а не на разовых задачах. Краткую карточку с текущими версиями держим в арсенале.

Частые вопросы

Как правильно — RuFlow, RuFlo или Ruflo?

Официально — Ruflo, без w. Имя собрано из ника автора (rUv) и слова flow. Ищут его чаще всего как «ruflow», потому что так слышится, и по этому запросу поиск выдаёт всё подряд. Ставить нужно пакет ruflo, репозиторий — ruvnet/ruflo. Старое имя проекта, Claude Flow, всё ещё встречается в его же документации и в чужих статьях 2025 года.

Обязательно ли устанавливать полный контур?

Нет, но выбирайте осознанно. Плагин из маркетплейса ничего не пишет в проект и годится, чтобы посмотреть на слэш-команды. Однако MCP-сервер он не регистрирует, поэтому инструменты вроде memory_store и swarm_init останутся недоступными — а это ровно то, ради чего Ruflo обычно и ставят. Полноценная работа — только через npx ruflo init.

Как откатиться, если не понравилось?

Каталоги, которые создаёт установка, известны: .claude/, .claude-flow/, CLAUDE.md, хелперы и файл настроек. Перед init сделайте коммит — тогда откат будет одной командой git. Отдельно проверьте claude mcp list и снимите регистрацию MCP-сервера, если она осталась.

Работает ли с Codex?

Да, проект позиционируется как мета-обвязка для Claude Code и Codex, для Codex есть отдельный npm-пакет. Но основная масса документации, примеров и плагинов написана под Claude Code, и путь через Codex объективно менее обкатан.

Стоит ли ставить на рабочий проект прямо сейчас?

Я бы сначала прогнал на отдельной ветке или на песочнице. Причины: 851 открытый issue, релизы каждый день, документация с командами под старым именем пакета и статус-док, отставший на два десятка версий. Проект живой и активно развивается — но «живой» здесь означает и «меняется под вами». На пет-проекте это интересно, на клиентском коде под дедлайном — риск, который нужно осознавать.