Ruflo: điều phối nhiều AI agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ruvnet/ruflo — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: ruflo: điều phối nhiều AI agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Ruflo (trước đây là Claude Flow) là một 'harness' cho Claude Code và Codex: nó bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên làm việc, hook và MCP server để các agent phối hợp với nhau. Bạn dùng nó để giao việc lớn cho cả một nhóm agent thay vì một agent đơn lẻ. Cài khá dễ: chạy một lệnh npx trong thư mục dự án, cần Node từ bản 20 trở lên.
Ruflo là một lớp điều phối (agent harness) đặt quanh Claude Code và Codex. Hiểu đơn giản: mô hình AI là người viết, còn Ruflo là cái bàn làm việc đầy đủ dụng cụ quanh người đó. Nó thêm công cụ, bộ nhớ, vòng lặp, kiểm soát quyền, và cho nhiều agent làm việc như một đội thay vì từng con chạy riêng lẻ.
Repo này do Reuven Cohen (rUv) tạo ra, trước đây mang tên Claude Flow. Hiện nó có khoảng 81.582 sao và 9.607 fork trên GitHub, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong vài tháng gần đây.
Bạn nên đọc bài này nếu đã dùng Claude Code (hoặc Codex) và thấy một agent đơn lẻ làm chưa đủ cho việc lớn: rà soát cả repo, viết test hàng loạt, nhớ lại bối cảnh của các phiên trước. Điểm đáng giá nhất là cách cài rất gọn: một lệnh npx ruflo@latest init, sau đó bạn cứ dùng Claude Code như bình thường, phần điều phối chạy ngầm phía sau.
ruvnet/ruflo
Ruflo là lớp điều phối bao quanh Claude Code và Codex: thêm agent chuyên biệt, bộ nhớ, hook và MCP server chỉ với một lệnh npx.
I.Ruflo làm được gì
Theo README, Ruflo gom nhiều thứ vào một bộ. Mình tóm lại theo lợi ích thực tế:
- Nhiều agent chuyên biệt làm việc theo nhóm (swarm). Thay vì một agent ôm hết, bạn có thể giao một việc như rà soát code cho cả nhóm. README nói bản cài bằng CLI có 98 agent, hơn 60 lệnh và 30 skill. Lợi ích: việc lớn được chia nhỏ và có người kiểm lại.
- Bộ nhớ qua các phiên. Agent có thể lưu và nhớ lại kinh nghiệm, nên hôm sau bạn không phải giải thích lại từ đầu. README mô tả phần học này gồm truy xuất vector cục bộ; embedding và các module học vẫn cần được cấu hình.
- Hook tự định tuyến việc. Sau khi
init, README nói bạn không cần học hết hàng trăm công cụ MCP hay hàng chục lệnh CLI. Hệ thống hook tự chuyển việc, học từ mẫu thành công và phối hợp agent ngầm. - Bảng điều khiển ngay cạnh Claude Code. Plugin
ruflo-consolecho bạn theo dõi workflow, agent, mô hình, token và chi phí. Bạn mở bằng lệnh/ruflo. Có thể xem log, tìm kiếm, phát lại và so sánh các lần chạy. - Cho Claude điều khiển bảng điều khiển trong giới hạn bạn đặt. Bạn chọn mức quyền
read,write,managehoặcfull, cùng chế độ duyệtaskhoặcauto. Mặc định hiện tại là read + ask, tức Claude chỉ đọc và hỏi bạn trước khi làm. - Hệ plugin lớn. README liệt kê 48 plugin (cộng thêm 3 plugin bên ngoài), chia theo nhóm: điều phối, bộ nhớ, học máy, kiểm thử, bảo mật, DevOps, theo dõi chi phí... Ví dụ
ruflo-testgentìm chỗ thiếu test và tự sinh test,ruflo-cost-trackertheo dõi token và đặt ngân sách,ruflo-aidefencechặn prompt injection và phát hiện thông tin cá nhân. - Dùng được ngoài Claude Code. Codex hoặc client MCP khác cũng kết nối được. README còn có chế độ giao diện terminal chạy độc lập và tùy chọn
--grok.
II.Cần chuẩn bị gì
Chỉ những điều tư liệu nói rõ:
- Node.js từ bản 20.0.0 trở lên (theo package.json). Lệnh
npxđi kèm Node. - Claude Code đã cài, nếu bạn đi theo đường chính. Nếu đi đường chỉ cài plugin, README yêu cầu Claude Code 2.1.287 trở lên. Lệnh
claude plugin installngoài terminal cần bản 2.1.292 trở lên. - Một thư mục dự án để chạy lệnh init (README bảo chạy trong thư mục dự án của bạn).
- Hệ điều hành, dung lượng ổ đĩa, GPU hay API key riêng: README đoạn mình có chưa nói rõ. Việc dùng mô hình thì đi qua Claude Code hoặc Codex mà bạn đã có sẵn.
Chi phí: Ruflo điều phối nhiều agent, nên một việc có thể tiêu nhiều token hơn so với chạy một agent. Hãy theo dõi qua bảng điều khiển hoặc plugin ruflo-cost-tracker. Ngoài ra, các mod chạy với quyền tài khoản của bạn và không bị cô lập (sandbox), nên hãy đọc mã trước khi cài.
III.Cài đặt từng bước
- Mở terminal trong dự ánVào đúng thư mục dự án bạn muốn dùng
- Chạy initChạy npx ruflo@latest init để thêm agent, hook, bộ nhớ và MCP server
- Mở Claude CodeMở lại Claude Code ở cùng thư mục để nó nhận cấu hình
- Giao một việc thậtGõ yêu cầu dùng swarm của Ruflo
- (Tùy chọn) Cài bảng điều khiểnCài plugin ruflo-console rồi gõ /ruflo
A.Mở terminal đúng thư mục
Lệnh init ghi file vào thư mục hiện tại, nên chỗ này người mới hay vấp nhất. Hãy mở terminal rồi chuyển vào thư mục dự án của bạn trước khi chạy. Nếu bạn chưa có dự án, tạo một thư mục thử nghiệm riêng.
cd duong-dan/toi/du-an-cua-banĐây chỉ là lệnh chuyển thư mục phổ thông; thay phần đường dẫn bằng thư mục thật của bạn.
B.Chạy lệnh init
Đây là lệnh chính theo README:
npx ruflo@latest initinit thêm agent, hook, bộ nhớ và MCP server của Ruflo vào dự án. Theo bảng so sánh trong README, đường này đặt các thư mục và file như .claude/, .claude-flow/, CLAUDE.md, các helper và settings vào dự án của bạn. Nếu muốn thiết lập có hướng dẫn từng câu hỏi, README có thêm:
npx ruflo@latest init wizardNếu bạn dùng Grok, README ghi npx ruflo init --grok chỉ ghi vào trong dự án, và thêm --dry-run để xem trước.
C.Mở lại Claude Code
Claude Code nhận cấu hình mới ở lần khởi động kế tiếp. Vì vậy hãy thoát và mở lại Claude Code trong cùng thư mục. Rồi giao một việc thật, ví dụ câu README gợi ý:
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.Bạn có thể viết bằng tiếng Việt, nhưng câu mẫu trên là nguyên văn của README nên mình giữ lại.
D.Nối với Codex hoặc client MCP khác
Nếu bạn không dùng Claude Code, hãy cấu hình client với command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Lệnh đầy đủ tương đương là:
npx -y ruflo@latest mcp startE.Đường nhẹ hơn: chỉ cài plugin
Đường này không thêm file nào vào dự án. Bạn gõ các lệnh sau bên trong Claude Code (không phải terminal thường):
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/rufloNếu dùng Claude Code 2.1.292 trở lên, bạn cũng có thể cài từ terminal:
claude plugin install ruflo-core@ruflo --marketplace ruvnet/rufloLưu ý README nói rõ: đường plugin chỉ cho slash command, vài skill và định nghĩa agent. Chỉ ruflo-core đăng ký MCP server riêng, và không có hook. Muốn chạy đủ vòng lặp như tài liệu mô tả, README khuyên dùng đường npx ruflo init.
F.Chạy giao diện terminal riêng (tùy chọn)
Bảng điều khiển cũng chạy độc lập, không cần Claude Code:
npx ruflo tuiThêm --plain để in ra một khung hình, tiện cho script.
IV.Kiểm tra đã chạy được chưa
README không đưa ra một lệnh kiểm tra duy nhất, nhưng có mấy dấu hiệu bạn có thể dựa vào:
- Sau
npx ruflo@latest init, trong thư mục dự án có các mục như.claude/,.claude-flow/vàCLAUDE.md(theo bảng so sánh của README). - Mở lại Claude Code rồi gõ
/ruflo. Nếu bảng điều khiển hiện ra, phần console đã hoạt động. - Với đường plugin, gõ
/pluginvà xem các plugin có xuất hiện trong dòng mod đang hoạt động hay không. - Thử bài kiểm tra an toàn mà README đưa ra: vào Settings → Claude control, chọn write + ask, rồi bảo Claude tạo một nhiệm vụ (mission). Bạn xác nhận hành động tạo trong bảng điều khiển, sau đó kiểm tra mục Missions có mục tiêu đó và mục Overview ghi lại hành động.
README cũng nhắc: tạo mission không có nghĩa là tính năng đã được viết xong. Nó chỉ chứng minh Claude điều khiển được bảng điều khiển trong giới hạn bạn đặt.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo khả năng được mô tả trong README. Mình không hứa kết quả cụ thể, vì nó phụ thuộc dự án và mô hình bạn dùng.
A.Lập trình viên mới tiếp quản một repo lạ
Bạn vừa nhận một dự án chưa quen và không biết đâu là chỗ dễ hỏng. Sau khi init và mở lại Claude Code, bạn gõ đúng câu mẫu của README:
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.Kết quả mong đợi: nhóm agent tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã thay đổi. Bạn đọc phần tóm tắt trước, rồi xem lại từng thay đổi trước khi giữ.
Agent = Mô hình + Harness. Mô hình viết, còn harness cho nó công cụ, bộ nhớ và giới hạn để làm việc thật.
Ông T
B.Chủ dự án muốn nhìn rõ agent đang làm gì và tốn bao nhiêu
Bạn không code nhiều nhưng thuê hoặc nhờ AI làm việc, và muốn biết token cùng chi phí đang đi đâu. Cài console bằng các lệnh plugin ở trên, mở /ruflo để xem workflow, agent, mô hình, token và chi phí ngay cạnh Claude Code. Muốn giữ kỷ luật chi tiêu, README còn liệt kê plugin ruflo-cost-tracker để theo dõi token, đặt ngân sách và nhận cảnh báo. Kết quả là bạn có một chỗ nhìn chung thay vì đoán mò.
C.Giao quyền cho Claude nhưng vẫn giữ tay lái
Bạn muốn Claude tự thao tác trên bảng điều khiển nhưng sợ nó làm quá tay. Vào Settings → Claude control, chọn mức write + ask rồi nhờ:
Create a mission to add a dark mode toggle. Show me the mission and its status.Claude mở mục Missions, đặt mục tiêu, rồi chờ bạn xác nhận. README nói các hành động vượt quá mức quyền bị từ chối, và hành động liên quan mạng, chi tiêu hay phá hủy luôn cần xác nhận kể cả ở chế độ auto. Bạn có nút Take back control để dừng ngay.
D.Nhóm nhỏ dùng nhiều máy hoặc nhiều công cụ AI
Bạn dùng Claude Code cho việc này, Codex cho việc kia. README cho biết Codex và client MCP khác dùng chung bằng lệnh npx -y ruflo@latest mcp start. Ngoài ra có plugin federation để agent trên các máy khác nhau phối hợp. Phần này nâng cao, và README đoạn mình có chưa hướng dẫn chi tiết cách thiết lập, nên bạn nên xem thư mục docs/ trong repo trước khi thử.
VI.Lỗi hay gặp và cách xử lý
Đã chạy init nhưng Claude Code không thấy gì mới. README nói Claude Code nhận cấu hình ở lần khởi động kế tiếp. Hãy thoát hẳn và mở lại trong đúng thư mục bạn đã chạy init. Với plugin, thử /reload-plugins.
Lệnh npx báo lỗi hoặc phiên bản Node cũ. package.json yêu cầu Node từ 20.0.0. Kiểm tra bằng node --version và nâng cấp nếu thấp hơn.
Gõ lệnh /plugin không chạy trong terminal thường. Các dòng bắt đầu bằng /plugin phải gõ bên trong Claude Code. Ngoài terminal, dùng lệnh claude plugin install ... (cần Claude Code 2.1.292 trở lên). Nếu báo thiếu lệnh, kiểm tra phiên bản Claude Code của bạn.
Cài plugin nhưng thiếu công cụ như tài liệu mô tả. Đường plugin chỉ cho một phần: không có hook, và chỉ ruflo-core đăng ký MCP server. Tên công cụ cũng khác (có dạng mcp__plugin_ruflo-core_ruflo__...). Muốn đủ chức năng, dùng đường npx ruflo@latest init.
Cài trùng một plugin từ hai nơi. README cảnh báo với các plugin bên ngoài như agentic-qe-fleet, agentdb, agentic-flow: nên cài từ một marketplace duy nhất, nếu không mod và lệnh có thể bị tải hai lần.
Lo Claude làm quá quyền. Đặt mức quyền thấp nhất đủ dùng (mặc định là read + ask), và dùng nút Take back control khi cần dừng.
VII.Có nên dùng không
Điểm mạnh. Cài rất nhanh bằng một lệnh. Cấu trúc rõ ràng: agent, bộ nhớ, hook, bảng điều khiển, plugin. Có cơ chế giới hạn quyền cho Claude, và giấy phép MIT dễ dùng. Repo đông người quan tâm và vẫn được cập nhật.
Giới hạn. Bộ này rất lớn (README nhắc tới 406 công cụ MCP, 61 lệnh CLI, 48 plugin), nên với việc nhỏ bạn sẽ thấy hơi thừa. Đường init thêm khá nhiều file vào dự án. Một số phần của README tự nói rõ chỉ là minh họa: video demo dùng dữ liệu mẫu, sơ đồ học là luồng khái niệm, chứ không phải bằng chứng agent đã hoàn thành việc thật. Mod chạy không sandbox với quyền tài khoản của bạn. Ngoài ra, chi phí token khi chạy nhiều agent cần bạn tự theo dõi.
Khi nào nên chọn cách khác. Nếu bạn chỉ cần Claude Code làm vài việc đơn giản, cứ dùng Claude Code thuần là đủ. Nếu bạn chỉ muốn thử một lệnh đơn lẻ, hãy cài từng plugin thay vì cả bộ. Còn nếu bạn thường xuyên giao việc lớn, nhiều bước, và muốn có bộ nhớ cùng chỗ theo dõi chung, Ruflo đáng để bạn thử trên một dự án nhỏ trước.
Câu hỏi thường gặp
Ruflo có miễn phí không?
Repo dùng giấy phép MIT nên bạn dùng và sửa mã được. Tuy nhiên Ruflo chạy trên Claude Code hoặc Codex, nên chi phí dùng mô hình phụ thuộc gói của bạn ở các công cụ đó. README đoạn mình có chưa nói về giá.
Ruflo khác gì Claude Flow?
Theo README, Claude Flow là tên cũ của dự án, nay đã đổi thành Ruflo. Tên gói npm trong tư liệu vẫn ghi là claude-flow, còn lệnh cài trong README dùng ruflo.
Cài Ruflo có khó không?
Không khó: chạy `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code. Bạn cần Node từ bản 20 trở lên. Nếu không muốn thêm file vào dự án, bạn có thể chỉ cài plugin bên trong Claude Code.
Ruflo có dùng được với Codex hoặc công cụ ngoài Claude Code không?
Có. README nói Codex và các client MCP khác dùng được bằng cách cấu hình command là npx với arguments ["-y", "ruflo@latest", "mcp", "start"]. Cũng có chế độ giao diện terminal chạy riêng bằng `npx ruflo tui`.
Cần GPU hay chạy được trên Windows không?
README đoạn mình có chưa nói rõ về GPU hay hệ điều hành cụ thể. Điều chắc chắn là cần Node từ bản 20 trở lên. Bạn nên xem README đầy đủ và thư mục docs/ trong repo để chắc về cấu hình máy.
Claude có thể tự ý làm bậy trong bảng điều khiển không?
README cho biết bạn tự đặt mức quyền (read, write, manage, full) và chế độ duyệt (ask hoặc auto). Mặc định là read + ask. Hành động liên quan mạng, chi tiêu hay phá hủy vẫn cần xác nhận kể cả ở chế độ auto, và có nút Take back control để dừng.
Dữ liệu của tôi có an toàn không?
README nói mod chạy với quyền tài khoản của bạn và không bị sandbox, nên cần đọc mã trước khi cài. Repo có kèm plugin bảo mật như ruflo-aidefence để phát hiện thông tin cá nhân và chặn prompt injection. Chi tiết về nơi lưu dữ liệu chưa có trong tư liệu mình đọc.


