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

Ruflo: điều phối nhiều AI agent làm việc cùng Claude Code — 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 làm việc cùng Claude Code — 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ó thêm agent chuyên biệt, swarm phối hợp, bộ nhớ qua các phiên làm việc và MCP server vào dự án của bạn. Bạn dùng nó để giao việc lớn cho nhiều agent cùng làm thay vì một agent đơn lẻ. Cài khá dễ: cần Node 20 trở lên và chạy một lệnh `npx ruflo@latest init` trong thư mục dự án.

Ruflo là một "agent harness" mã nguồn mở, bọc quanh Claude Code và Codex, để các AI agent không chỉ chạy một mình mà biết chia việc, nhớ việc và phối hợp với nhau. Tác giả mô tả đơn giản: mô hình AI là người viết, còn harness là bàn làm việc xung quanh, gồm công cụ, bộ nhớ, vòng lặp và các giới hạn kiểm soát. Ruflo chính là phần bàn làm việc đó.

Bạn nên xem repo này nếu đã dùng Claude Code (hoặc Codex) và thấy một agent làm việc đơn lẻ chưa đủ: muốn review cả repo, viết test, tóm tắt thay đổi trong một lần giao việc. Nó cũng hợp với lập trình viên mới muốn thử khái niệm "đội agent" mà không phải tự dựng hạ tầng.

Điểm đáng giá nhất là cách vào cuộc rất nhẹ. README nói rõ: sau khi chạy init, bạn cứ dùng Claude Code như bình thường, hệ thống hook sẽ tự định tuyến việc, học từ những lần làm tốt và điều phối agent ở phía sau. 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. Repo hiện có khoảng 81.582 sao và 9.607 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối bọc quanh Claude Code và Codex: thêm agent, bộ nhớ, hook và MCP server vào dự án chỉ với một lệnh npx.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Tư liệu mô tả Ruflo ở nhiều lớp. Dưới đây là những phần dễ hình dung nhất với người dùng thực tế.

Agent và swarm. Ruflo thêm các agent chuyên biệt (README ghi 98 agent ở đường cài bằng CLI) và cho chúng phối hợp thành "swarm". Lợi ích: một yêu cầu lớn như "review repo, viết test, tóm tắt" được chia cho nhiều agent thay vì dồn vào một cuộc trò chuyện dài.

Bộ nhớ qua nhiều phiên. Agent có thể nhớ lại kinh nghiệm giữa các lần làm việc. README có các plugin về bộ nhớ 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ớ). Lợi ích: bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần mở phiên mới.

Hook tự động. Sau init, hook sẽ định tuyến công việc và ghi lại mẫu làm việc thành công. Bạn không phải gọi từng công cụ.

Bảng điều khiển trong Claude Code. Plugin ruflo-console là một "cockpit" để theo dõi workflow, agent, mô hình, token và chi phí ngay bên cạnh Claude Code. 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 lái, bạn đặt giới hạn. Trong Settings → Claude control, bạn chọn mức quyền read, write, manage hoặc full, và 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 và phá huỷ vẫn phải xác nhận kể cả ở chế độ auto. Có nút Take back control để dừng ngay.

Hệ plugin lớn. README liệt kê 48 plugin (cộng thêm 3 plugin bên ngoài): kiểm thử (ruflo-testgen), bảo mật (ruflo-security-audit, ruflo-aidefence), theo dõi chi phí (ruflo-cost-tracker), tài liệu (ruflo-docs), liên kết agent giữa nhiều máy (ruflo-federation)… Bạn chỉ cài cái mình cần.

Nhiều client. Ngoài Claude Code, README nói Codex và các MCP client khác dùng được, kèm một tuỳ chọn --grok cho Grok Build.

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

Tư liệu chỉ nêu một số yêu cầu rõ ràng:

  • Node.js từ 20.0.0 trở lên (theo package.json). Lệnh npx đi kèm Node.
  • Claude Code nếu bạn đi đường chính. README không ghi yêu cầu phiên bản cho đường init.
  • Claude Code 2.1.287 trở lên nếu cài bằng plugin. Lệnh claude plugin install ngoài terminal cần 2.1.292 trở lên.
  • Một thư mục dự án để chạy init.

Về tài khoản, API key hay phần cứng (GPU…), README phần đã cung cấp chưa nói gì cụ thể. Bạn cần đăng nhập Claude Code như bình thường để dùng agent. Phần còn lại của README (bị cắt trong tư liệu) có thể có thêm, nên bạn xem trực tiếp trong repo nếu cần.

Các mod của Ruflo chạy với quyền tài khoản của bạn và không bị đặt trong sandbox. README khuyên đọc mã nguồn trước khi cài. Hãy giữ chế độ mặc định read + ask lúc mới thử, rồi mới nâng quyền khi đã hiểu nó làm gì.

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

README có nhiều đường cài. Cách đơn giản và đầy đủ nhất là npx ruflo@latest init. Bài này đi theo đường đó, rồi nêu hai cách thay thế.

  1. Kiểm tra NodeBảo đảm máy có Node 20 trở lên
  2. Vào thư mục dự ánMở terminal đúng thư mục bạn muốn dùng
  3. Chạy initThêm agent, hook, bộ nhớ và MCP server vào dự án
  4. Mở lại Claude CodeKhởi động Claude Code trong cùng thư mục để nó nhận cấu hình
  5. Giao việc đầu tiênGõ một yêu cầu thật để swarm làm việc

A.Kiểm tra Node

Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux) và xem phiên bản Node. Cần từ 20 trở lên.

Terminal
node --version

Nếu hiện số thấp hơn 20, bạn cần nâng Node trước khi tiếp tục.

B.Vào thư mục dự án

Lệnh init ghi file vào thư mục hiện tại, nên bạn phải đứng đúng chỗ. Ví dụ dùng thư mục dự án của bạn:

Terminal
cd đường-dẫn-tới-dự-án

Đây là chỗ người mới hay vấp: nếu chạy ở thư mục sai, các file .claude/ và CLAUDE.md sẽ xuất hiện sai nơi.

C.Chạy init

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

Terminal
npx ruflo@latest init

npx tải và chạy Ruflo bản mới nhất mà không cần cài toàn cục. Theo README, lệnh này thêm agent, hook, bộ nhớ và MCP server vào dự án. Bảng so sánh trong README cho biết đường này tạo các mục như .claude/, .claude-flow/, CLAUDE.md và file cấu hình trong workspace.

Muốn thiết lập theo kiểu hỏi đáp, README ghi lệnh:

Terminal
npx ruflo@latest init wizard

D.Mở lại Claude Code và giao việc

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. Rồi gõ yêu cầu thật, ví dụ 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 có thể viết bằng tiếng Việt, nhưng câu mẫu trên là nguyên văn README, nên chạy thử đúng như vậy trước.

E.Cách khác: chỉ cài plugin trong Claude Code

Nếu không muốn thêm file vào dự án, README có đường plugin (cần Claude Code 2.1.287 trở lên). Gõ các lệnh này 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

Đường này mang lại công cụ lõi, bảng điều khiển và các mod, nhưng README cũng nói rõ: đường plugin không cài hook và chỉ cho một phần chức năng. Muốn "chạy đúng như tài liệu" thì dùng npx ruflo@latest init.

Từ terminal (Claude Code 2.1.292 trở lên), README ghi:

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

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

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

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

Nghĩa là client sẽ tự chạy npx -y ruflo@latest mcp start để bật MCP server của Ruflo. Chỗ điền cấu hình tuỳ từng client, bạn xem tài liệu của client đó.

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

README không đưa một lệnh "kiểm tra" riêng cho đường init, nên bạn dùng các dấu hiệu sau, đều lấy từ tư liệu:

  1. Sau init, trong thư mục dự án xuất hiện các mục như .claude/, .claude-flow/ và CLAUDE.md.
  2. Mở lại Claude Code trong thư mục đó rồi gõ:
text
/ruflo

Nếu bảng điều khiển hiện ra, phần console đã hoạt động. README viết rõ trình tự npx ruflo init, khởi động lại Claude Code, rồi /ruflo.

  1. Với đường plugin, mở /plugin để xác nhận các mod đã cài xuất hiện trong dòng "active mods".
  2. Bạn cũng có thể chạy bảng điều khiển ngoài Claude Code:
Terminal
npx ruflo tui

Thêm --plain để in một khung hình ra, hữu ích khi dùng trong script.

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 README đã mô tả. Kết quả thật phụ thuộc vào dự án và mô hình bạn dùng.

A.Review nhanh một repo mới nhận

Bối cảnh: bạn là lập trình viên vừa nhận một dự án của người khác, chưa biết chỗ nào dễ hỏng. Sau khi init và mở lại Claude Code, bạn dùng đú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.

Kết quả mong đợi theo mô tả: agent tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã thay đổi. Hãy đọc kỹ tóm tắt và chạy test trước khi giữ lại thay đổi.

B.Tập giao việc cho Claude trong bảng điều khiển

Bối cảnh: bạn muốn thử cho Claude điều khiển console nhưng vẫn giữ quyền kiểm soát. README có một bài tập từng bước:

  1. Cài console bằng các lệnh plugin ở trên, mở /ruflo, vào Settings → Claude control → write + ask.
  2. Gõ yêu cầu: “Create a mission to add a dark mode toggle. Show me the mission and its status.”
  3. Claude mở mục Missions và đặt mục tiêu. Bạn xác nhận hành động tạo đang chờ.
  4. Kiểm tra Missions có mục tiêu mới và Overview đã ghi lại hành động.

Lưu ý README nhấn mạnh: tạo mission không có nghĩa là tính năng đã được viết xong.

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

Ông T

C.Theo dõi chi phí và quá trình chạy

Bối cảnh: bạn là chủ một nhóm nhỏ dùng Claude Code mỗi ngày và muốn biết token cùng chi phí đi đâu. Bảng điều khiển ruflo-console cho theo dõi workflow, agent, mô hình, token và chi phí cạnh Claude Code. Bạn mở /ruflo, xem log và kết quả từng lần chạy, tìm kiếm, phát lại và so sánh để biết lần nào thất bại. Nếu cần quản lý ngân sách, README còn liệt kê plugin ruflo-cost-tracker (theo dõi token, đặt ngân sách, cảnh báo chi phí).

D.Thêm đúng plugin mình cần

Bối cảnh: bạn chỉ muốn thử sinh test tự động, không muốn cài cả bộ. Theo README, đường plugin cho phép cài từng plugin riêng. Ví dụ cài lõi và plugin bộ nhớ truy xuất:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-rag-memory@ruflo

Trong console, lệnh /ruflo market mở Plugin Catalog để xem, cài, bật, tắt và cập nhật plugin; mỗi hành động đều hỏi xác nhận trước.

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

Tư liệu không có mục xử lý lỗi, nên dưới đây là các tình huống rất dễ xảy ra với loại công cụ này, kèm cách làm an toàn.

Node quá cũ, npx báo lỗi. package.json yêu cầu Node từ 20. Chạy node --version, nếu thấp hơn thì nâng Node rồi chạy lại npx ruflo@latest init.

Chạy init nhưng Claude Code không thấy gì. 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 đúng trong thư mục đã chạy init. Với plugin, dùng /reload-plugins.

Lệnh /plugin hoặc claude plugin install không chạy. Đường plugin cần Claude Code 2.1.287 trở lên (2.1.292 trở lên cho lệnh ngoài terminal). Hãy cập nhật Claude Code trước.

Gọi nhầm tên công cụ MCP. README giải thích plugin ruflo-core đăng ký công cụ với tên dạng mcp__plugin_ruflo-core_ruflo__*, khác tên ngắn như memory_store ở đường CLI. Nếu bạn cài cả hai đường, hãy nhớ tên khác nhau. Muốn dùng đúng như tài liệu thì chọn đường init.

Cài trùng plugin từ hai marketplace. README cảnh báo với các plugin bên ngoài như agentic-qe-fleet, agentdb, agentic-flow: chỉ cài từ một marketplace, vì bật cả hai thì mod và lệnh bị nạp hai lần.

Muốn xem trước khi ghi file. Với tuỳ chọn Grok, README có cờ --dry-run để xem trước. Với init thường, README phần đã có chưa nói cờ này áp dụng được không, nên hãy thử trong một thư mục thử nghiệm trước khi chạy vào dự án quan trọng.

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

Điểm mạnh. Cài nhanh bằng một lệnh. Giữ nguyên cách dùng Claude Code quen thuộc. Có bảng điều khiển để nhìn thấy agent đang làm gì, và có cơ chế giới hạn quyền, bắt xác nhận hành động nguy hiểm. Giấy phép MIT, dự án đông người theo dõi và vẫn đang được cập nhật.

Giới hạn. Hệ thống rất lớn: hàng chục plugin, hàng trăm công cụ, nhiều khái niệm (swarm, federation, bộ nhớ vector). Người mới dễ choáng nếu cố học hết. README tự nói phần minh hoạ dùng dữ liệu mẫu và các đoạn demo không chứng minh swarm đã làm xong việc thật hay bộ nhớ đã được gọi lại, nên đừng kỳ vọng quá khi mới thử. Mod chạy với quyền tài khoản của bạn, không sandbox. Đường init còn thêm nhiều file vào dự án, bạn nên dùng trong repo có quản lý phiên bản để dễ xem và hoàn tác.

Khi nên chọn cách khác. Nếu bạn chỉ cần một agent trả lời hoặc sửa file đơn giản, Claude Code thuần là đủ. Nếu chỉ muốn thử vài lệnh riêng lẻ mà không thêm file nào, hãy dùng đường plugin. Còn với việc nhiều bước, cần chia agent, nhớ ngữ cảnh và theo dõi chi phí, Ruflo đáng để thử trước trong một dự án nhỏ, sau đó mới mở rộng.

4.3/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 tự do sử dụng. Tuy vậy, agent vẫn chạy trên Claude Code hoặc Codex, và tư liệu không nói gì về chi phí của các dịch vụ đó. Bạn nên kiểm tra gói đang dùng của chính mình.

Cài Ruflo bằng lệnh nào?

Cách chính theo README là chạy `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code trong thư mục đó. Cần Node 20 trở lên. README còn có đường cài bằng plugin trong Claude Code và đường cấu hình MCP cho Codex.

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

Tư liệu không nêu rõ hệ điều hành nào được hỗ trợ hay không. Yêu cầu duy nhất được ghi là Node từ 20 trở lên. Bạn nên thử trong một thư mục thử nghiệm và xem phần hướng dẫn trong repo nếu gặp vấn đề.

Ruflo có cần GPU không?

Tư liệu phần đã có không nói cần GPU để chạy `init` hay dùng cơ bản. Một số plugin như `ruflo-ruvector` được mô tả có tìm kiếm tăng tốc GPU, nhưng đó là tuỳ chọn thuộc plugin riêng.

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

Claude Code thuần là một agent làm việc đơn lẻ. Ruflo thêm lớp điều phối bên ngoài: nhiều agent chuyên biệt, swarm, bộ nhớ giữa các phiên, hook tự định tuyến việc và bảng điều khiển theo dõi. README gọi đó là harness bọc quanh Claude Code và Codex.

Cho Claude điều khiển console thì có an toàn không?

Theo README, mặc định là read + ask, và bạn tự chọn nâng mức quyền. Hành động liên quan mạng, chi tiêu và phá huỷ vẫn cần xác nhận kể cả ở chế độ auto, và có nút Take back control để dừng. Tuy vậy các mod 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 MCP client khác chạy được: cấu hình lệnh `npx` với đối số `-y`, `ruflo@latest`, `mcp`, `start`. Ngoài ra còn có cờ `--grok` cho Grok Build.

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.Vào thư mục dự án
    3. C.Chạy init
    4. D.Mở lại Claude Code và giao việc
    5. E.Cách khác: chỉ cài plugin trong Claude Code
    6. F.Cách khác: Codex hoặc client MCP khác
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Review nhanh một repo mới nhận
    2. B.Tập giao việc cho Claude trong bảng điều khiển
    3. C.Theo dõi chi phí và quá trình chạy
    4. D.Thêm đúng plugin mình cần
  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ỏ.