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 agent harness mã nguồn mở. Nó thêm agent chuyên biệt, bộ nhớ, hook và máy chủ MCP vào Claude Code hoặc Codex để các agent phối hợp được với nhau. Cài khá dễ: chỉ cần Node 20 trở lên và chạy `npx ruflo@latest init` trong thư mục dự án.

Ruflo là một «agent meta-harness»: lớp công cụ bọc quanh Claude Code và Codex, giúp AI không chỉ trả lời từng câu mà còn làm việc theo nhóm, nhớ được việc cũ và có giới hạn rõ ràng. Repo này từng mang tên Claude Flow. Hiện nó có khoảng 81.600 sao và khoảng 9.600 fork trên GitHub, giấy phép MIT, viết chủ yếu bằng TypeScript.

Tác giả giải thích bằng một công thức ngắn: Agent = Model + Harness. Model là phần viết code hoặc viết chữ. Harness là phần đưa cho model công cụ, bộ nhớ, vòng lặp và cơ chế kiểm soát để nó làm việc thật. Ruflo đóng vai harness đó.

Bạn nên đọc bài này nếu đã dùng Claude Code hoặc Codex và muốn thử giao việc lớn hơn, ví dụ nhờ một nhóm agent rà soát cả dự án. Điểm đáng giá nhất là cách cài chỉ một lệnh. Sau đó bạn cứ dùng Claude Code như bình thường, các hook sẽ tự định tuyến việc ở phía sau.

Framework

ruvnet/ruflo

Ruflo là bộ khung điều phối bọc quanh Claude Code và Codex: thêm agent, bộ nhớ, hook và bảng điều khiển, cài chỉ với một lệnh npx.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Tư liệu liệt kê rất nhiều thứ, nhưng người mới chỉ cần nắm vài nhóm chính.

  • Nhóm agent phối hợp (swarm). Thay vì một AI làm hết, Ruflo cho nhiều agent chuyên biệt chia việc với nhau. README nói có hơn 100 agent chuyên biệt. Lợi ích: việc lớn như «review cả repo» được chia nhỏ và làm song song.
  • Bộ nhớ qua nhiều phiên. Agent nhớ lại những gì đã làm ở các lần trước. Bạn đỡ phải giải thích lại bối cảnh dự án mỗi khi mở phiên mới. Các plugin như ruflo-agentdb, ruflo-rag-memory và ruflo-rvf phục vụ phần này.
  • Tự học từ kết quả. README mô tả vòng học khái niệm: cách làm thành công được đưa ngược vào việc định tuyến lần sau. Tác giả cũng ghi chú rằng đây là sơ đồ khái niệm, không phải bản ghi một lần chạy thật.
  • Hook tự động. Sau init, hook sẽ định tuyến tác vụ và phối hợp agent ở nền. README nói bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI.
  • Bảng điều khiển (console). Đây là «buồng lái» đặt cạnh Claude Code. Bạn xem workflow, agent, model, token và chi phí, mở log của từng lần chạy, tìm kiếm, phát lại và so sánh.
  • Claude điều khiển console có giới hạn. Bạn chọn mức quyền read, write, manage hoặc full, cùng chế độ duyệt ask hoặc auto. Mặc định hiện là read + ask. Các thao tác liên quan đến mạng, tiền và xoá luôn cần bạn xác nhận, kể cả khi đang để auto.
  • Kho plugin. README ghi 48 plugin (cộng thêm 3 plugin bên ngoài) với nhiều nhóm: điều phối, bộ nhớ, kiểm thử, bảo mật, theo dõi chi phí, tài liệu và nhiều nhóm khác.
  • Liên kết giữa các máy (federation). Agent trên máy khác nhau có thể trao đổi với nhau. Bạn không cần dùng tính năng này ngay khi mới bắt đầu.
  • Nhiều môi trường. Ngoài Claude Code, README nhắc đến Codex, các MCP client khác và cả Grok Build (npx ruflo init --grok).

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

Theo tư liệu, bạn cần:

  • Node.js 20 trở lên. package.json của gói yêu cầu >=20.0.0. Bạn cần Node để chạy được lệnh npx.
  • Claude Code (hoặc Codex, hoặc một MCP client khác) đã cài sẵn và dùng được.
  • Nếu đi đường plugin trong Claude Code: Claude Code phiên bản 2.1.287 trở lên. Nếu muốn cài plugin từ terminal bằng lệnh claude plugin install, cần phiên bản 2.1.292 trở lên.
  • Một thư mục dự án để chạy init.

Phần README mà mình có không nói rõ về hệ điều hành, GPU hay cách nhập API key. Mình sẽ không đoán thay tác giả. Ruflo dùng Claude Code và Codex làm nền, nên bạn cần tài khoản và đăng nhập cho công cụ đó theo hướng dẫn của chính nó. Phần còn lại hãy xem trong README và thư mục docs/ của repo.

Các mod của Ruflo chạy với quyền tài khoản của bạn và không bị đóng khung (sandbox). README dặn rõ: hãy đọc code trước khi cài. Hãy giữ quyền điều khiển console ở mức thấp, tăng dần khi đã quen.

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

Có ba đường cài. Người mới nên chọn đường thứ nhất, vì README gọi đây là cách dùng đầy đủ nhất.

  1. Kiểm tra NodeĐảm bảo máy có Node 20 trở lên
  2. Chạy initGõ một lệnh npx trong thư mục dự án
  3. Mở lại Claude CodeMở Claude Code ở cùng thư mục để nó nhận cấu hình
  4. Giao việc thửDán một câu lệnh mẫu để xem Ruflo hoạt động
  5. (Tuỳ chọn) Cài plugin hoặc MCPChọn đường nhẹ nếu không muốn thêm file vào dự án

A.Kiểm tra Node

Mở terminal (PowerShell trên Windows, hoặc Terminal trên macOS/Linux) rồi gõ lệnh dưới đây. Lệnh node --version là lệnh phổ thông của Node, không nằm riêng trong README Ruflo.

Terminal
node --version

Nếu số phiên bản nhỏ hơn 20, bạn cần cập nhật Node trước khi làm tiếp.

B.Chạy init trong thư mục dự án

Đây là lệnh chính trong README. Bạn phải mở terminal đúng thư mục dự án cần dùng, vì Ruflo sẽ ghi file vào chính thư mục đó. Ví dụ:

Terminal
cd duong-dan-toi-du-an-cua-ban
npx ruflo@latest init

Lệnh init thêm agent, hook, bộ nhớ và máy chủ MCP của Ruflo vào dự án. Theo bảng so sánh trong README, bạn sẽ thấy các thư mục và file như .claude/, .claude-flow/, CLAUDE.md, cùng file trợ giúp và settings. Nếu muốn thiết lập có hướng dẫn từng câu hỏi, README có lệnh khác:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code

Mở Claude Code trong cùng thư mục. README nói Claude Code sẽ nhận agent, hook, bộ nhớ và MCP server ở lần khởi động kế tiếp. Nếu Claude Code đang mở sẵn, hãy thoát rồi mở lại. Nhiều người hay quên bước này rồi tưởng cài lỗi.

D.Giao việc thử

Dán câu mẫu của chính README vào Claude Code:

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

Câu này nhờ một nhóm agent tìm module rủi ro nhất trong dự án, viết test cho nó và tóm tắt những gì đã đổi.

E.Đường nhẹ: chỉ cài plugin Claude Code

Cách này không thêm file nào vào dự án. Bạn cần Claude Code 2.1.287 trở lên. Gõ từng dòng sau bên trong Claude Code (không phải trong terminal thường):

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

Ba plugin ở đây là gì? ruflo-core là phần nền, gồm máy chủ và kiểm tra tình trạng. ruflo-console là bảng điều khiển. ruflo-mods định tuyến prompt và áp dụng chính sách. Lệnh /reload-plugins nạp lại plugin, còn /ruflo mở bảng điều khiển.

Nếu Claude Code của bạn là 2.1.292 trở lên, bạn có thể cài từ terminal bằng lệnh này:

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

Bạn cũng có thể cài thêm từng plugin lẻ theo nhu cầu, cùng kiểu lệnh /plugin install <tên>@ruflo. Ví dụ README ghi ruflo-swarm, ruflo-rag-memory và ruflo-neural-trader.

F.Đường cho Codex hoặc MCP client khác

Không cần cài vào dự án. Bạn khai báo trong phần cấu hình MCP của công cụ đó:

  • commandnpx
  • arguments["-y", "ruflo@latest", "mcp", "start"]

Cũng có thể viết gộp thành một dòng là npx -y ruflo@latest mcp start. Mỗi công cụ nhập cấu hình MCP ở một chỗ khác nhau. README chưa chỉ chỗ cụ thể cho từng công cụ, nên bạn xem tài liệu của công cụ bạn dùng.

G.Chạy bảng điều khiển trong terminal thường

Bảng điều khiển còn chạy được riêng, không cần Claude Code:

Terminal
npx ruflo tui

Thêm --plain nếu bạn chỉ muốn in ra một khung hình, tiện cho script.

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

Tùy đường cài mà cách kiểm tra khác nhau.

  • Đường init: Sau khi chạy lệnh, xem trong thư mục dự án đã có .claude/, .claude-flow/ và CLAUDE.md chưa. Mở lại Claude Code, giao câu mẫu ở trên và xem Claude có nhắc đến swarm hoặc agent của Ruflo không.
  • Đường plugin: Gõ /plugin trong Claude Code. README nói bạn sẽ thấy các plugin trong dòng «active mods». Gõ /ruflo để mở bảng điều khiển.
  • Đường console độc lập: npx ruflo tui nên hiện giao diện bảng điều khiển ngay trong terminal.
  • Kiểm tra sâu hơn: Trong console, vào mục Missions và Overview sau khi thử tạo một nhiệm vụ (xem tình huống bên dưới).

Một lưu ý trung thực từ chính README: các bản demo động trong repo dùng dữ liệu mẫu hoặc phát lại khung hình. Chúng không chứng minh swarm đã làm xong việc thật. Bạn hãy tự kiểm tra kết quả trên dự án của mình.

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

A.Dev rà soát một dự án vừa nhận bàn giao

Bạn là lập trình viên mới nhận một repo lạ, không biết chỗ nào dễ hỏng. Bạn chạy npx ruflo@latest init trong thư mục repo, mở lại Claude Code rồi dán đúng câu 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ả bạn mong đợi, theo mô tả của README, là Claude tìm module rủi ro nhất, viết test cho nó và tóm tắt thay đổi. Hãy đọc kỹ các file test được thêm và tự chạy lại trước khi tin.

Bạn vẫn viết code như cũ, còn việc điều phối giữa các agent là phần của công cụ.

Ông T

B.Theo dõi nhiệm vụ trên bảng điều khiển

Bạn muốn xem agent đang làm gì thay vì đoán mò. Cài ruflo-console bằng các lệnh /plugin ở trên, mở /ruflo, rồi làm theo kịch bản của README:

  1. Vào Settings → Claude control và chọn write + ask.
  2. Nhờ Claude: «Create a mission to add a dark mode toggle. Show me the mission and its status.»
  3. Khi console hỏi, bạn xác nhận hành động tạo mission.
  4. Kiểm tra mục Missions có mục tiêu mới chưa, và mục Overview có ghi lại hành động chưa.

Lưu ý: tạo mission chỉ ghi nhận mục tiêu, không có nghĩa tính năng đã được làm. Nếu thấy Claude làm quá tay, bấm Take back control để dừng ngay.

C.Người làm kinh doanh muốn kiểm soát chi phí AI

Bạn là chủ shop hoặc nhân viên văn phòng đã bắt đầu dùng Claude Code cho vài việc tự động hoá. Điều bạn lo là tốn token mà không biết. README liệt kê plugin ruflo-cost-tracker với mô tả «theo dõi token, đặt ngân sách, cảnh báo chi phí». Bạn cài nó theo cùng kiểu lệnh:

text
/plugin install ruflo-cost-tracker@ruflo
/reload-plugins

Bảng điều khiển ruflo-console cũng hiện token và chi phí cạnh Claude Code. Tư liệu mình có chưa ghi các bước cấu hình ngân sách cụ thể, nên bạn xem thêm tài liệu của plugin trong thư mục plugins/ hoặc docs/.

D.Dùng với Codex hoặc công cụ MCP khác

Nếu bạn không dùng Claude Code mà dùng Codex, hãy khai báo máy chủ MCP của Ruflo với command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Sau đó công cụ của bạn có thể gọi các tool của Ruflo như bộ nhớ hay điều phối swarm. Danh sách tên tool cụ thể nằm trong tài liệu của repo.

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

1. Lệnh npx báo lỗi hoặc gói không chạy. Nguyên nhân thường gặp là Node cũ. Gói yêu cầu Node 20 trở lên. Chạy node --version, cập nhật Node rồi thử lại.

2. Cài xong 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 tiếp theo. Hãy thoát hẳn rồi mở lại ở đúng thư mục dự án. Với đường plugin, chạy /reload-plugins rồi /plugin để xem danh sách.

3. Lệnh /plugin không có hoặc báo phiên bản không hỗ trợ. Đường plugin cần Claude Code 2.1.287 trở lên (2.1.292 trở lên nếu cài bằng claude plugin install từ terminal). Hãy cập nhật Claude Code trước.

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

5. Claude làm những việc bạn không muốn. Kiểm tra lại mức quyền trong Settings → Claude control. Mặc định là read + ask. Nếu bạn đã nâng quyền, hạ xuống và bấm Take back control để dừng. Cài plugin hoặc mod lạ cũng nên đọc code trước, vì chúng chạy với quyền tài khoản của bạn.

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

Điểm mạnh. Cài đặt chỉ một lệnh. Mã nguồn mở, giấy phép MIT, repo còn được cập nhật trong ba tháng gần đây. Có nhiều đường vào (init, plugin, MCP, terminal), nên bạn thử nhẹ rồi tăng dần được. Cơ chế quyền read / write / manage / full với bước xác nhận cho thao tác nhạy cảm là thiết kế đáng tin.

Giới hạn. Hệ thống rất lớn: hàng trăm công cụ MCP, hàng chục lệnh, gần năm chục plugin. Người mới dễ choáng, nên hãy bắt đầu với một câu lệnh mẫu và ruflo-console. Lệnh init thêm nhiều file vào dự án, nên bạn nên thử trên bản sao hoặc nhánh riêng trước. Các bản demo trong repo là dữ liệu mẫu, không phải bằng chứng về kết quả thật. Tư liệu mình có cũng chưa nói rõ chi phí API khi chạy nhiều agent cùng lúc, nên bạn nên theo dõi chi phí từ đầu.

Khi nên chọn cách khác. Nếu bạn chỉ cần Claude Code trả lời vài câu hoặc sửa vài file nhỏ, bản thân Claude Code đã đủ, không cần thêm lớp điều phối. Nếu bạn chỉ muốn thử một tính năng đơn lẻ, hãy cài đúng một plugin thay vì cả bộ. Ruflo đáng thử khi bạn có việc đủ lớn để chia cho nhiều agent, hoặc cần bộ nhớ lâu dài giữa các phiên.

4.5/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?

Mã nguồn Ruflo theo giấy phép MIT, tức là dùng tự do. Tuy vậy, Ruflo chạy trên Claude Code, Codex hoặc các nhà cung cấp AI khác. Phí của các dịch vụ đó nằm ngoài repo và tư liệu mình có chưa nêu chi tiết, nên bạn xem điều khoản của nhà cung cấp bạn dùng.

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

Tệp package.json yêu cầu Node từ 20.0.0 trở lên. Bạn cần Node để chạy lệnh npx cài và khởi động Ruflo.

Ruflo khác gì dùng Claude Code thông thường?

Claude Code vẫn là nơi bạn làm việc. Ruflo thêm lớp bao quanh gồm agent chuyên biệt, swarm, bộ nhớ qua nhiều phiên, hook, máy chủ MCP và bảng điều khiển. Sau khi chạy init, README nói bạn cứ dùng Claude Code bình thường, còn hook sẽ tự định tuyến việc ở phía sau.

Có cần cài vào dự án không, hay có cách nhẹ hơn?

Có hai cách. Lệnh npx ruflo@latest init thêm file như .claude/, .claude-flow/ và CLAUDE.md vào dự án, cho đầy đủ tính năng nhất. Cách thứ hai là cài plugin trong Claude Code, không thêm file nào vào dự án nhưng chỉ có phần tính năng nhẹ hơn.

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 MCP client khác dùng được, bằng cách khai báo command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Repo cũng có lệnh init riêng cho Grok Build.

Claude có thể tự ý làm hỏng gì khi điều khiển bảng điều khiển không?

Mặc định là read + ask. README nói Claude bị từ chối nếu vượt mức quyền bạn đặt, và các thao tác liên quan đến mạng, chi tiêu hoặc xoá luôn cần xác nhận, kể cả ở chế độ auto. Bạn có thể bấm Take back control để dừng ngay.

Dữ liệu của tôi có an toàn không, có cần GPU không?

Tư liệu mình có chưa nói rõ về chỗ lưu dữ liệu hay yêu cầu GPU, nên mình không khẳng định. Repo có tệp SECURITY.md và các plugin bảo mật riêng, bạn nên đọc trước khi dùng với dữ liệu nhạy cảm. Các mod chạy với quyền tài khoản của bạn và không bị sandbox, nên hãy đọc code trước khi cài.

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.Kiểm tra Node
    2. B.Chạy init trong thư mục dự án
    3. C.Mở lại Claude Code
    4. D.Giao việc thử
    5. E.Đường nhẹ: chỉ cài plugin Claude Code
    6. F.Đường cho Codex hoặc MCP client khác
    7. G.Chạy bảng điều khiển trong terminal thường
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev rà soát một dự án vừa nhận bàn giao
    2. B.Theo dõi nhiệm vụ trên bảng điều khiển
    3. C.Người làm kinh doanh muốn kiểm soát chi phí AI
    4. D.Dùng với Codex hoặc công cụ MCP khác
  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ỏ.