Bỏ qua tới nội dung
Ông T.vn

Ruflo: điều phối nhiều AI agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

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 →

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" bao quanh Claude Code và Codex. Nó thêm agent chuyên biệt, bộ nhớ, hook và MCP server để AI phối hợp theo nhóm. Cài chỉ cần một lệnh `npx ruflo@latest init` trong thư mục dự án, yêu cầu Node từ 20 trở lên.

Ruflo là một lớp "harness" (bộ khung điều khiển) bao quanh Claude Code và Codex. Nó thêm cho AI các agent chuyên biệt, bộ nhớ, hook và một MCP server, để AI không chỉ trả lời từng câu mà còn phối hợp theo nhóm, nhớ việc đã làm và học từ các lần trước. Tác giả mô tả nó là "agent meta-harness", tức bộ khung điều phối đặt lên trên các công cụ AI viết code.

Tác giả giải thích rất gọn: Agent = Model + Harness. Model là phần viết ra chữ và code. Harness là phần đưa cho model công cụ, bộ nhớ, vòng lặp và các giới hạn an toàn để nó làm việc thật. Ruflo chính là phần harness đó. Repo này từng có tên Claude Flow, giờ đổi tên thành Ruflo, hiện có khoảng 81.600 sao và 9.600 fork trên GitHub, giấy phép MIT.

Bạn nên đọc bài này nếu đang dùng Claude Code (hoặc Codex) và muốn giao cho AI những việc lớn hơn một câu hỏi: rà soát cả repo, viết test, theo dõi chi phí. Điểm đáng giá nhất là cách cài rất ngắn: một lệnh npx ruflo@latest init trong thư mục dự án, sau đó bạn cứ dùng Claude Code như bình thường, phần điều phối chạy ngầm bên dưới.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối quanh Claude Code và Codex: thêm agent, bộ nhớ, hook và MCP server để AI làm việc theo nhóm, nhớ qua nhiều phiên.

★ 82kTypeScriptMIT
Xem repo trên GitHub

I.Ruflo làm được gì

README nói thẳng: bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI. Sau khi init, bạn dùng Claude Code như cũ, hệ thống hook sẽ tự định tuyến tác vụ, học từ những mẫu làm việc thành công và điều phối agent ngầm. Dưới đây là các nhóm tính năng đáng chú ý.

Nhiều agent làm việc như một nhóm (swarm). Thay vì một AI làm tất cả, Ruflo cho các agent tự tổ chức thành nhóm. Theo README, bản cài bằng CLI có 98 agent, hơn 60 lệnh và 30 skill. Lợi ích thực tế: bạn giao một việc lớn như "rà soát repo" và các agent chia nhau tìm chỗ rủi ro, viết test, tóm tắt.

Bộ nhớ qua nhiều phiên. Agent có thể nhớ việc đã làm giữa các lần mở Claude Code. Các plugin như ruflo-agentdb (cơ sở dữ liệu vector cho bộ nhớ agent), ruflo-rag-memory (tìm kiếm thông minh) và ruflo-rvf (lưu và khôi phục bộ nhớ giữa các phiên) phục vụ phần này. Bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần.

Học từ kinh nghiệm. Kết quả các tác vụ trước được đưa ngược lại vào việc định tuyến. README ghi rõ đây là luồng khái niệm: việc tìm kiếm vector cục bộ và cập nhật đối chiếu có thể chạy không cần LLM, nhưng vẫn cần embedding và các module học đã được cấu hình.

Bảng điều khiển (console) cạnh Claude Code. Plugin ruflo-console cho bạn một "buồng lái" để theo dõi workflow, agent, model, token và chi phí. Bạn có thể mở log và kết quả của từng agent, tìm kiếm, phân loại lỗi, phát lại và so sánh các lần chạy.

Cho Claude điều khiển, nhưng bạn đặt giới hạn. Trong Settings có mục Claude control với bốn mức quyền: read, write, manage, full, và hai kiểu duyệt: ask (hỏi bạn) hoặc auto (tự làm). Mặc định hiện là read + ask. Hành động vượt quyền bị từ chối, còn các hành động liên quan mạng, chi tiêu và phá huỷ vẫn phải xác nhận kể cả ở chế độ auto. Có nút Take back control để lấy lại quyền ngay.

Hệ plugin lớn. Có 48 plugin chia theo nhóm: điều phối (swarm, autopilot, workflows), bộ nhớ, học máy, chất lượng code (ruflo-testgen tìm chỗ thiếu test và tạo test, ruflo-browser kiểm thử trình duyệt bằng Playwright, ruflo-docs tạo tài liệu), bảo mật (ruflo-security-audit, ruflo-aidefence chặn prompt injection và phát hiện dữ liệu cá nhân), vận hành (ruflo-cost-tracker theo dõi token, đặt ngân sách, cảnh báo chi phí). Bạn chọn cái cần, không bắt buộc cài hết.

Liên kết nhiều máy (federation). Agent trên các máy khác nhau có thể trao đổi với nhau một cách an toàn mà không làm lộ dữ liệu, theo mô tả của tác giả. Với người mới, phần này chưa cần đụng tới.

II.Cần chuẩn bị gì

Tư liệu chỉ nêu một số yêu cầu rõ ràng, mình ghi lại đúng như vậy:

  • Node.js từ phiên bản 20.0.0 trở lên (theo package.json). Lệnh npx đi kèm Node nên bạn không cần cài thêm gì cho lệnh đó.
  • Claude Code nếu bạn đi theo đường chính. Riêng đường cài bằng plugin cần Claude Code 2.1.287 trở lên. Lệnh claude plugin install ... từ terminal cần 2.1.292 trở lên.
  • Codex hoặc client MCP khác cũng dùng được, bạn trỏ nó tới lệnh npx -y ruflo@latest mcp start.
  • Một thư mục dự án để chạy init.

README phần mình có không nói rõ yêu cầu về hệ điều hành, GPU hay API key riêng cho Ruflo. Nếu bạn dùng thêm tính năng nào cần key hoặc dịch vụ ngoài (ví dụ model của nhà cung cấp khác), hãy xem tài liệu trong thư mục docs/ của repo.

Các "mod" cài qua marketplace chạy với quyền của tài khoản bạn và không được sandbox. README khuyên đọc mã nguồn trước khi cài. Hãy giữ Claude control ở mức mặc định read + ask cho đến khi bạn hiểu rõ mình đang cho phép gì.

III.Cài đặt từng bước

Có hai đường cài khác nhau. Đường CLI (npx ruflo init) cho đầy đủ nhất: README ghi là cho "Full Ruflo loop", gồm 98 agent, hơn 60 lệnh, 30 skill, MCP server, hook và daemon, và hợp với dùng thật. Đường plugin nhẹ hơn, không thêm file nào vào dự án, hợp để thử từng plugin. Bài này đi đường CLI làm chính, rồi nói thêm đường plugin và MCP.

  1. Mở terminal đúng thư mụcVào thư mục dự án mà bạn muốn dùng Ruflo
  2. Chạy initMột lệnh để thêm agent, hook, bộ nhớ và MCP server vào dự án
  3. Mở lại Claude CodeMở Claude Code trong cùng thư mục để nó nhận cấu hình mới
  4. Giao thử một việcDán câu lệnh mẫu để thử swarm
  5. Tuỳ chọn: plugin, MCP hoặc terminal UIChọn đường khác nếu không muốn thêm file vào dự án

A.Mở terminal ở thư mục dự án

Chỗ người mới hay vấp nhất là chạy lệnh sai thư mục. Ruflo ghi file vào đúng nơi bạn đang đứng, nên hãy cd vào thư mục dự án trước. Ví dụ trên Windows PowerShell hoặc macOS/Linux terminal:

Terminal
cd duong-dan/toi/du-an-cua-ban

Thay duong-dan/toi/du-an-cua-ban bằng đường dẫn thật của bạn.

B.Chạy lệnh init

Đây là lệnh chính theo README:

Terminal
npx ruflo@latest init

Lệnh này tải Ruflo bản mới nhất và thêm agent, hook, bộ nhớ và MCP server vào dự án. Theo bảng so sánh trong README, bạn sẽ thấy xuất hiện .claude/, .claude-flow/, CLAUDE.md, các file helper và settings trong thư mục dự án. Nếu dự án của bạn đã có CLAUDE.md, hãy sao lưu trước phòng khi cần so sánh (README phần mình có không nói rõ cách xử lý file cũ).

Muốn cài theo kiểu hỏi đáp từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

C.Mở Claude Code và giao việc thử

Mở Claude Code trong cùng thư mục. Claude Code sẽ nhận agent, hook, bộ nhớ và MCP server ở lần khởi động kế tiếp, nên nếu nó đang mở sẵn, hãy đóng và mở lại. Sau đó thử câu lệnh mẫu của README:

text
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.

D.Tuỳ chọn: chỉ cài plugin trong Claude Code

Nếu không muốn thêm file nào vào dự án, dùng đường plugin (cần Claude Code 2.1.287 trở lên). Gõ các lệnh sau bên trong Claude Code:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo

Từ terminal thường, với Claude Code 2.1.292 trở lên, README cho lệnh:

Terminal
claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo

Lưu ý: các lệnh bắt đầu bằng dấu / gõ trong khung chat của Claude Code, không gõ vào terminal. Đường plugin chỉ cho slash command, vài skill và định nghĩa agent. Hook không được cài, và MCP server chỉ có khi cài ruflo-core. Muốn đủ bộ thì dùng đường CLI.

E.Tuỳ chọn: Codex hoặc client MCP khác

Với Codex hay client MCP khác, bạn cấu hình command là npx và arguments như sau:

JSON
["-y", "ruflo@latest", "mcp", "start"]

Cũng có thể chạy trực tiếp lệnh tương đương:

Terminal
npx -y ruflo@latest mcp start

F.Tuỳ chọn: giao diện terminal riêng

Console chạy được độc lập, không cần Claude Code:

Terminal
npx ruflo tui

Thêm --plain để in ra một khung hình, tiện cho script.

IV.Kiểm tra đã chạy được chưa

Theo README, có vài dấu hiệu để biết cài thành công:

  • Với đường CLI: thư mục dự án có .claude/, .claude-flow/ và CLAUDE.md. Sau khi khởi động lại Claude Code, gõ /ruflo để mở console.
  • Với đường plugin: chạy /plugin và kiểm tra các plugin đã cài có hiện trong dòng "active mods". Sau đó gõ /ruflo.
  • Với terminal UI: npx ruflo tui mở được màn hình console.
  • Thử việc thật: giao câu lệnh review repo ở trên. Nếu Claude Code bắt đầu dùng swarm và báo cáo lại, tức là Ruflo đã hoạt động.

Trong console, lệnh /ruflo market mở Plugin Catalog. Đây là danh mục mọi plugin, mod và skill của Ruflo, có nút cài, bật, tắt, cập nhật (mỗi thao tác đều hỏi bạn trước).

V.Dùng vào việc thật

Dưới đây là các tình huống bám sát khả năng mà README mô tả.

A.Lập trình viên mới: rà soát một repo lạ

Bạn vừa nhận một dự án thừa kế và không biết bắt đầu từ đâu. Chạy npx ruflo@latest init trong thư mục dự án, mở lại Claude Code, rồi dán prompt mẫu:

text
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: các agent tìm module có rủi ro cao nhất, viết test cho nó và tóm tắt những gì đã đổi. Bạn đọc phần tóm tắt, rồi tự xem lại các file test trước khi giữ lại.

Bạn vẫn viết code như cũ. Ruflo lo phần phối hợp.

Ông T

B.Chủ dự án nhỏ: thử console mà không rủi ro

Bạn muốn xem Claude điều khiển console ra sao nhưng ngại nó làm quá tay. Cài console bằng các lệnh plugin ở trên, mở /ruflo, vào Settings, chọn Claude control, đặt mức write với duyệt ask. Sau đó nhờ:

text
Create a mission to add a dark mode toggle. Show me the mission and its status.

Claude mở trang Missions và đặt mục tiêu, còn bạn xác nhận thao tác tạo. Kiểm tra: Missions có mục tiêu mới và Overview ghi lại hành động. README lưu ý rõ: tạo mission không có nghĩa là tính năng đã được viết. Nếu muốn dừng, bấm Take back control, và các lệnh sau đó của Claude sẽ bị từ chối cho tới khi bạn trả quyền lại.

C.Nhân viên dùng Codex hoặc công cụ MCP khác

Nếu công ty bạn dùng Codex hoặc một client MCP khác, bạn không cần cài vào dự án. Chỉ cần khai báo command npx với arguments ["-y", "ruflo@latest", "mcp", "start"]. Client đó sẽ thấy các công cụ của Ruflo qua MCP. Đây là cách gọn để thử trước khi quyết định có init hay không.

D.Người quản lý: theo dõi chi phí và chất lượng

Trong danh mục plugin có ruflo-cost-tracker (theo dõi token, đặt ngân sách, cảnh báo chi phí) và ruflo-testgen (tìm chỗ thiếu test và tạo test tự động). Bạn cài hai plugin này bằng lệnh /plugin install ten-plugin@ruflo, ví dụ /plugin install ruflo-testgen@ruflo. README phần mình có chưa mô tả chi tiết cách dùng từng lệnh của hai plugin này, nên hãy xem hướng dẫn trong thư mục plugins/ hoặc docs/ của repo.

VI.Lỗi hay gặp và cách xử lý

Lệnh npx báo lỗi hoặc không chạy. Kiểm tra phiên bản Node bằng node --version. package.json yêu cầu từ 20.0.0 trở lên. Nếu thấp hơn, nâng Node lên rồi chạy lại.

Claude Code không thấy agent hay MCP sau khi init. README nói Claude Code nhận cấu hình ở lần khởi động kế tiếp. Hãy đóng hẳn rồi mở lại Claude Code, và chắc chắn bạn mở nó trong đúng thư mục đã chạy init.

Lệnh /plugin install không nhận hoặc không có. Đường plugin cần Claude Code 2.1.287 trở lên, còn lệnh claude plugin install từ terminal cần 2.1.292 trở lên. Cập nhật Claude Code, rồi chạy /reload-plugins.

Claude từ chối thao tác trong console. Có thể mức quyền Claude control đang quá thấp. Mặc định là read + ask, nên các hành động ghi sẽ bị từ chối. Bạn có thể nâng lên write, nhưng nên giữ ask để tự duyệt. Hành động liên quan mạng, chi tiêu, phá huỷ luôn cần xác nhận, kể cả ở chế độ auto.

Plugin chạy hai lần hoặc lệnh bị trùng. Với các plugin ngoài như agentdb, agentic-flow, agentic-qe-fleet, README dặn chỉ cài từ một marketplace. Nếu bật từ cả hai nơi, mod và lệnh sẽ tải hai lần. Hãy gỡ một bên.

VII.Có nên dùng không

Điểm mạnh. Cài rất nhanh bằng một lệnh. Có thể bắt đầu nhẹ bằng plugin rồi lên bản đầy đủ sau. Hệ sinh thái rộng (agent, bộ nhớ, bảo mật, theo dõi chi phí). Giấy phép MIT, repo vẫn được cập nhật trong vài tháng gần đây. Cơ chế phân quyền cho Claude control khá rõ ràng, giúp bạn giữ được quyền kiểm soát.

Giới hạn. Số lượng tính năng rất lớn (406 công cụ MCP, 61 lệnh CLI, 48 plugin), người mới dễ choáng. Cài đầy đủ sẽ thêm nhiều file vào dự án (.claude/, .claude-flow/, CLAUDE.md, hook, daemon), nên hãy thử trên dự án nhỏ hoặc nhánh riêng trước. Các mod không được sandbox. Chính README cũng thừa nhận video minh hoạ dùng dữ liệu mẫu và chưa chứng minh việc swarm hay bộ nhớ hoàn thành công việc thật, và luồng học là khái niệm. Chi phí gọi model vẫn do nhà cung cấp AI bạn dùng tính. Mình chưa thấy tư liệu nói Ruflo giảm chi phí đó.

Khi nào chọn cách khác. Nếu bạn chỉ cần Claude Code trả lời câu hỏi nhỏ, sửa vài dòng code, thì cứ dùng Claude Code thuần, không cần thêm một lớp điều phối. Ruflo đáng thử khi bạn có việc lớn, nhiều bước, muốn AI nhớ bối cảnh lâu dài và theo dõi được tiến độ.

4.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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 mã nguồn dùng tự do. Tuy nhiên chi phí gọi model AI (ví dụ qua Claude Code hay Codex) vẫn do tài khoản bạn dùng với nhà cung cấp tương ứng. Tư liệu chưa nêu chi tiết về chi phí này.

Ruflo cần phiên bản Node nào?

File package.json yêu cầu Node từ 20.0.0 trở lên. Bạn kiểm tra bằng lệnh node --version trước khi chạy npx ruflo@latest init.

Ruflo có chạy trên Windows không?

Tư liệu mình có không nêu rõ hệ điều hành được hỗ trợ. Lệnh cài dùng npx nên cần Node 20 trở lên. Nếu cần chắc chắn, hãy xem tài liệu trong thư mục docs/ của repo.

Có cần GPU không?

README phần mình có không nói Ruflo bắt buộc GPU. Một plugin (ruflo-ruvector) có nhắc tìm kiếm tăng tốc GPU, nhưng đó là tuỳ chọn. Chưa có thông tin rõ hơn về yêu cầu phần cứng.

Ruflo khác gì dùng Claude Code thuần?

Claude Code thuần là công cụ viết code. Ruflo là lớp bao quanh, thêm agent chuyên biệt, swarm, bộ nhớ qua nhiều phiên, hook, MCP server và bảng điều khiển theo dõi. Sau khi init bạn vẫn dùng Claude Code như bình thường, phần điều phối chạy ngầm.

Dùng Ruflo có an toàn không?

README nhấn mạnh phân quyền: Claude control mặc định read + ask, hành động mạng, chi tiêu, phá huỷ luôn cần xác nhận. Tuy nhiên các mod cài qua marketplace chạy với quyền tài khoản của bạn và không được sandbox, nên cần đọc mã trước khi cài.

Có dùng được với Codex hoặc công cụ khác ngoài Claude Code không?

Có. README nói Codex và các client MCP khác dùng được: cấu hình command là npx với arguments ["-y", "ruflo@latest", "mcp", "start"]. README cũng có lệnh riêng cho Grok Build là npx ruflo init --grok.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal ở thư mục dự án
    2. B.Chạy lệnh init
    3. C.Mở Claude Code và giao việc thử
    4. D.Tuỳ chọn: chỉ cài plugin trong Claude Code
    5. E.Tuỳ chọn: Codex hoặc client MCP khác
    6. F.Tuỳ chọn: giao diện terminal riêng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên mới: rà soát một repo lạ
    2. B.Chủ dự án nhỏ: thử console mà không rủi ro
    3. C.Nhân viên dùng Codex hoặc công cụ MCP khác
    4. D.Người quản lý: theo dõi chi phí và chất lượng
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.