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

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

10 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 đội agent AI 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 meta-harness: lớp công cụ đặt quanh Claude Code và Codex để thêm nhiều agent chuyên biệt, bộ nhớ qua các phiên làm việc, swarm phối hợp và máy chủ MCP. Cài khá dễ: chạy một lệnh npx trong thư mục dự án, cần Node từ 20 trở lên. Bạn vẫn dùng Claude Code như bình thường, ruflo lo phần điều phối ở phía sau.

ruflo là một "agent meta-harness" cho Claude Code và Codex. Hiểu đơn giản: mô hình AI lo phần viết, còn ruflo là bộ khung bao quanh để nó có công cụ, bộ nhớ, vòng lặp và các giới hạn kiểm soát. Repo này trước đây tên Claude Flow, nay đổi thành ruflo, viết chủ yếu bằng TypeScript, giấy phép MIT.

Nếu bạn đã dùng Claude Code và thấy một mình nó làm việc hơi "đơn độc", ruflo giải quyết đúng chỗ đó. Sau khi cài, bạn có nhiều agent chuyên biệt cùng làm một việc (gọi là swarm), có bộ nhớ giữa các phiên, và có một bảng điều khiển để xem agent đang làm gì, tốn bao nhiêu token. Người nên thử là lập trình viên mới muốn có "đội AI" hỗ trợ, và người làm kinh doanh, văn phòng đã quen Claude Code muốn giao những việc nhiều bước hơn.

Điểm đáng giá nhất theo README: bạn không phải học hết hàng trăm công cụ. Sau khi chạy init, bạn cứ dùng Claude Code bình thường, phần định tuyến tác vụ và phối hợp agent chạy ngầm. Repo hiện có khoảng 81.582 sao và 9.607 fork, và vẫn được cập nhật trong vài tháng gần đây.

Framework

ruvnet/ruflo

ruflo là bộ khung (harness) bọc quanh Claude Code và Codex, thêm agent chuyên biệt, bộ nhớ, swarm và máy chủ MCP chỉ với một lệnh init.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những tính năng chính, theo cách hiểu thực tế cho người dùng.

A.Thêm đội agent chuyên biệt

README nói ruflo mang tới hơn 100 agent chuyên biệt (bảng so sánh cài đặt ghi 98 agent). Lợi ích: thay vì một AI làm mọi thứ, bạn có thể giao cho "người rà soát", "người viết test"… mỗi bên một vai.

B.Swarm: nhiều agent tự phối hợp

Các agent tự tổ chức thành swarm để cùng xử lý một nhiệm vụ. Ví dụ README đưa ra là bảo ruflo rà soát repo, tìm module rủi ro nhất, viết test cho nó rồi tóm tắt những gì đã đổi.

C.Bộ nhớ và tự học

ruflo nhớ qua các phiên làm việc và đưa kinh nghiệm từ tác vụ thành công quay lại để định tuyến tốt hơn. README ghi rõ đây là mô hình học khái niệm; phần truy xuất vector cục bộ có thể chạy không cần LLM, nhưng vẫn cần embedding và các module học đã cấu hình.

D.Máy chủ MCP và hooks

init thêm agent, hooks, bộ nhớ và máy chủ MCP vào dự án. Nhờ vậy Codex hay bất kỳ client MCP nào khác cũng nối vào được.

E.Bảng điều khiển trong Claude Code

Gói console là một "buồng lái": theo dõi workflow, agent, model, token và chi phí cạnh Claude Code, xem lại log và kết quả từng lần chạy, tìm kiếm, so sánh. Có thể mở bằng lệnh /ruflo.

F.Cho Claude điều khiển, nhưng bạn đặt giới hạn

Trong phần Settings → Claude control, 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 hành động liên quan mạng, chi tiêu hoặc phá huỷ vẫn phải xác nhận kể cả ở chế độ auto. Bạn có thể bấm Take back control để dừng ngay.

G.Hệ plugin lớn

README liệt kê 48 plugin (cộng 3 plugin bên ngoài): swarm, bộ nhớ RAG, tạo test tự động, quét bảo mật, theo dõi chi phí token, workflow dùng lại được, liên kết agent giữa các máy (federation)… Bạn chỉ cài cái mình cần.

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

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

  • Node.js từ 20.0.0 trở lên (đây là yêu cầu trong file package.json của repo).
  • Claude Code đã cài. Riêng cách cài bằng plugin cần Claude Code 2.1.287 trở lên; lệnh cài từ terminal cần 2.1.292 trở lên.
  • Một thư mục dự án để chạy lệnh trong đó.

README chưa nói rõ về hệ điều hành, yêu cầu phần cứng hay API key riêng cho ruflo, nên mình không khẳng định. Bạn cần tài khoản/khoá để dùng Claude Code hoặc Codex như bình thường; chuyện đó nằm ngoài ruflo.

Các mod của ruflo chạy với quyền tài khoản của bạn và không bị cô lập (sandbox). README dặn hãy đọc code trước khi cài. Với ruflo-console, hãy để mức quyền Claude control ở read + ask cho tới khi bạn hiểu rõ nó làm gì.

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

README có ba đường chính. Cách dễ nhất cho người mới là đường thứ nhất.

  1. Mở terminal trong dự áncd vào thư mục dự án của bạn
  2. Chạy initnpx ruflo@latest init để thêm agent, hooks, bộ nhớ, MCP
  3. Mở lại Claude Codemở Claude Code trong cùng thư mục để nó nhận cấu hình
  4. Giao một việc thậtgõ yêu cầu dùng swarm của ruflo
  5. (Tuỳ chọn) Mở bảng điều khiểngõ /ruflo trong Claude Code

A.Mở terminal đúng thư mục

Chỗ người mới hay vấp nhất là chạy lệnh sai thư mục. Hãy mở terminal ngay trong thư mục dự án mà bạn muốn dùng ruflo. Trên Windows, bạn có thể dùng PowerShell. Ví dụ (đổi đường dẫn cho đúng máy bạn):

Terminal
cd ten-thu-muc-du-an

B.Chạy lệnh init

Đây là lệnh chính theo README. npx tải và chạy ruflo bản mới nhất, không cần cài sẵn:

Terminal
npx ruflo@latest init

Lệnh này thêm agent, hooks, bộ nhớ và máy chủ MCP vào dự án. Bảng so sánh trong README cho biết nó tạo các thư mục .claude/, .claude-flow/, tệp CLAUDE.md cùng một số tệp hỗ trợ và settings trong dự án. Nếu bạn muốn thiết lập có hỏi đáp từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

C.Khởi động lại Claude Code

Mở Claude Code trong cùng thư mục (hoặc khởi động lại nếu đang mở). README nói Claude Code sẽ nhận các thành phần mới ở lần khởi động kế tiếp.

D.Giao một việc thật

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.

E.Cách khác: chỉ cài plugin Claude Code (không thêm tệp vào dự án)

Đường này cho bạn công cụ lõi, bảng điều khiển và mod, nhưng không thêm tệp nào vào dự án. Gõ các lệnh sau bên trong Claude Code (cần bản 2.1.287 trở lên):

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, với Claude Code 2.1.292 trở lên, README ghi thêm lệnh:

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

Lưu ý: đường plugin chỉ là bản "lite" gồm lệnh slash, vài skill và định nghĩa agent. Theo README, nếu muốn vòng hoạt động đầy đủ (agent, hooks, daemon, MCP) thì dùng npx ruflo@latest init.

F.Cách khác: Codex hoặc client MCP khác

Cấu hình client của bạn với command là npx và arguments là:

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

Cũng có thể chạy trực tiếp lệnh npx -y ruflo@latest mcp start. Cách điền cấu hình cụ thể tuỳ từng client, README không hướng dẫn chi tiết cho từng loại.

G.Cách khác: chạy bảng điều khiển trong terminal thường

Bảng điều khiển chạy độ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

README không đưa ra một lệnh "kiểm tra" duy nhất, nên mình gợi ý các dấu hiệu bám đúng tư liệu:

  • Sau npx ruflo@latest init, thư mục dự án xuất hiện .claude/, .claude-flow/ và CLAUDE.md.
  • Mở Claude Code trong thư mục đó, gõ /ruflo thì bảng điều khiển hiện ra.
  • Nếu cài bằng plugin, mở /plugin và kiểm tra các mod xuất hiện ở dòng mod đang hoạt động (active mods).
  • Trong bảng điều khiển, lệnh /ruflo market mở Plugin Catalog, liệt kê plugin, mod và skill với nút cài, bật, tắt, cập nhật (mỗi thao tác đều hỏi lại bạn trước).

Nếu /ruflo không phản hồi, xem phần lỗi hay gặp bên dưới.

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

Các tình huống dưới đây bám đúng khả năng README mô tả. Kết quả thật còn tuỳ dự án và mô hình bạn dùng.

A.Lập trình viên mới rà soát một dự án thừa kế

Bạn vừa nhận một repo lạ, không biết chỗ nào dễ hỏng. Sau khi init và mở lại Claude Code, bạn gõ đúng câu 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.

Bạn nhận được: module được đánh giá rủi ro nhất, các bài test viết cho nó và bản tóm tắt thay đổi. Hãy đọc kỹ test trước khi giữ lại, đừng tin hoàn toàn.

Agent = Model + Harness: mô hình viết, còn bộ khung cho nó công cụ, bộ nhớ và giới hạn để làm việc thật.

Ông T

B.Người làm sản phẩm muốn xem agent đang tốn bao nhiêu

Bạn không biết code nhưng cần biết AI đang làm gì và tốn bao nhiêu token. Cài ruflo-console bằng đường plugin, mở /ruflo, xem workflow, agent, model, token và chi phí ngay cạnh Claude Code. Khi có việc chạy lỗi, mở log và kết quả từng agent để xem chuyện gì xảy ra. Plugin ruflo-cost-tracker trong danh sách cũng được mô tả là theo dõi token, đặt ngân sách và báo động chi phí.

C.Cho Claude thao tác bảng điều khiển có kiểm soát

README mô tả một kịch bản thử an toàn. Bạn vào Settings → Claude control và chọn write + ask, rồi yêu cầu:

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

Claude mở mục Missions và điền mục tiêu; bạn xác nhận hành động tạo trong console. Sau đó kiểm tra mục Missions và trang Overview có ghi lại hành động. README nhấn mạnh: tạo mission không có nghĩa tính năng đã được làm xong. Nếu thấy không ổn, bấm Take back control để các lệnh của Claude bị từ chối cho đến khi bạn mở lại.

D.Dùng ruflo từ Codex hoặc công cụ MCP khác

Bạn không dùng Claude Code mà dùng Codex. Bạn cấu hình client với command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Khi đó các công cụ MCP của ruflo (bộ nhớ, swarm…) có thể dùng được từ client đó. Nếu muốn thiết lập theo dự án, chạy npx ruflo@latest init wizard.

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

A.Chạy lệnh bị lỗi vì Node quá cũ

repo yêu cầu Node từ 20.0.0. Nếu máy bạn đang dùng bản cũ hơn, npx có thể báo lỗi hoặc chạy hỏng. Cách xử lý: nâng Node lên bản 20 trở lên rồi chạy lại.

B.Claude Code chưa thấy gì 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 và mở lại Claude Code đúng trong thư mục đã chạy init. Nếu bạn mở ở thư mục khác thì dĩ nhiên nó không thấy.

C.Lệnh /plugin không nhận hoặc cài plugin thất bại

Đường plugin cần Claude Code 2.1.287 trở lên (lệnh claude plugin install ở terminal cần 2.1.292 trở lên). Hãy cập nhật Claude Code trước. Cài xong, gõ /reload-plugins, rồi mở /plugin để xem plugin đã hiện chưa.

D.Plugin bị nạp hai lần

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

E.Lo ngại về quyền của mod

Mod chạy với quyền tài khoản của bạn và không bị sandbox. Đây không hẳn là lỗi, nhưng là rủi ro dễ bỏ qua. Hãy đọc code trước khi cài, giữ Claude control ở mức read + ask khi mới dùng, và chỉ nâng quyền khi thật sự cần.

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

Điểm mạnh: cài chỉ bằng một lệnh; giấy phép MIT; hỗ trợ cả Claude Code lẫn Codex và client MCP khác; có bảng điều khiển để nhìn thấy agent đang làm gì; có cơ chế giới hạn quyền rõ ràng (read, write, manage, full cùng ask hoặc auto); hệ plugin lớn và repo còn được cập nhật.

Giới hạn: số lượng tính năng rất lớn (README nhắc đến 406 công cụ MCP và 61 lệnh CLI), nên người mới dễ choáng, dù README bảo bạn không cần học hết. Phần học và bộ nhớ có ghi chú là mô hình khái niệm, cần embedding và module cấu hình. Các bản demo trong README dùng dữ liệu mẫu, không phải bằng chứng cho việc swarm đã hoàn thành công việc thật. Bản init thêm nhiều tệp vào dự án, còn bản plugin thì nhẹ hơn nhưng ít chức năng hơn.

Khi nào 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 nó trực tiếp, không cần thêm lớp điều phối. Nếu bạn muốn thử nhẹ nhàng, hãy bắt đầu bằng một plugin riêng lẻ thay vì cài toàn bộ. Còn nếu bạn thật sự cần nhiều agent phối hợp, có bộ nhớ và có chỗ theo dõi chi phí, ruflo là một lựa chọn đáng thử trong một dự án nhỏ trước khi áp dụng rộng hơn.

4.2/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 ruflo bọc quanh Claude Code, Codex và các nhà cung cấp AI, nên chi phí dùng các dịch vụ đó vẫn tính riêng. README có plugin theo dõi token và đặt ngân sách để bạn kiểm soát.

ruflo khác gì dùng Claude Code trực tiếp?

Claude Code là công cụ để viết và sửa code. ruflo là lớp bọc thêm agent chuyên biệt, swarm phối hợp, bộ nhớ qua các phiên, hooks, máy chủ MCP và bảng điều khiển. Bạn vẫn dùng Claude Code như thường, ruflo điều phối ở phía sau.

Cần phiên bản Node nào?

File package.json của repo yêu cầu Node từ 20.0.0 trở lên. Với đường cài bằng plugin, bạn còn cần Claude Code từ 2.1.287 trở lê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 client MCP khác dùng được: cấu hình command là npx với arguments là -y, ruflo@latest, mcp, start. Ngoài ra README còn nhắc tới hỗ trợ Grok qua lệnh init có cờ --grok.

Cài có thêm tệp vào dự án của tôi không?

Nếu dùng npx ruflo@latest init thì có: README liệt kê .claude/, .claude-flow/, CLAUDE.md và các tệp hỗ trợ, settings. Nếu cài bằng plugin Claude Code thì README ghi là không thêm tệp nào vào workspace.

Có cần GPU hoặc cấu hình máy mạnh không?

Tư liệu chưa nêu yêu cầu phần cứng cho đường cài chính. Một số plugin nhắc đến tìm kiếm tăng tốc GPU hoặc chạy LLM cục bộ, nhưng đó là tuỳ chọn riêng, chưa có thông tin cụ thể về cấu hình tối thiểu.

Cho Claude điều khiển bảng điều khiển có an toàn không?

README mô tả cơ chế giới hạn: bạn chọn mức quyền read, write, manage hoặc full và chế độ ask hoặc auto; mặc định hiện là read + ask. Hành động liên quan mạng, chi tiêu hoặc phá huỷ vẫn cần xác nhận kể cả khi auto, và bạn có thể bấm Take back control để dừng. Riêng các mod thì không bị sandbox, nên cần đọc code trước khi cài.

Chuyển nhanh tới mục

  1. I.ruflo làm được gì
    1. A.Thêm đội agent chuyên biệt
    2. B.Swarm: nhiều agent tự phối hợp
    3. C.Bộ nhớ và tự học
    4. D.Máy chủ MCP và hooks
    5. E.Bảng điều khiển trong Claude Code
    6. F.Cho Claude điều khiển, nhưng bạn đặt giới hạn
    7. G.Hệ plugin lớn
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal đúng thư mục
    2. B.Chạy lệnh init
    3. C.Khởi động lại Claude Code
    4. D.Giao một việc thật
    5. E.Cách khác: chỉ cài plugin Claude Code (không thêm tệp vào dự án)
    6. F.Cách khác: Codex hoặc client MCP khác
    7. G.Cách khác: 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.Lập trình viên mới rà soát một dự án thừa kế
    2. B.Người làm sản phẩm muốn xem agent đang tốn bao nhiêu
    3. C.Cho Claude thao tác bảng điều khiển có kiểm soát
    4. D.Dùng ruflo từ Codex hoặc công cụ MCP khác
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy lệnh bị lỗi vì Node quá cũ
    2. B.Claude Code chưa thấy gì sau khi init
    3. C.Lệnh /plugin không nhận hoặc cài plugin thất bại
    4. D.Plugin bị nạp hai lần
    5. E.Lo ngại về quyền của mod
  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ỏ.