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

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 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: lớp công cụ bao quanh Claude Code và Codex để thêm nhiều agent chuyên biệt, swarm phối hợp, bộ nhớ qua nhiều phiên và máy chủ MCP. Bạn dùng nó để giao việc lớn như review repo, viết test, theo dõi chi phí. Cài khá dễ: chỉ cần Node 20 trở lên và chạy một lệnh npx trong thư mục dự án.

ruflo là một agent harness (bộ khung điều khiển) bao quanh Claude Code và Codex. Hiểu đơn giản: mô hình AI chỉ biết viết, còn ruflo cho nó thêm công cụ, bộ nhớ, vòng lặp và các giới hạn an toàn để làm việc thật. Repo này trước đây tên Claude Flow, giờ đổi thành ruflo.

Bạn nên quan tâm nếu đang dùng Claude Code (hoặc Codex) và muốn giao những việc dài hơn một câu lệnh: review cả repo, viết test cho module rủi ro nhất, theo dõi chi phí token. Chủ repo mô tả ruflo cho Claude Code một “hệ thần kinh”: các agent tự chia việc thành swarm, học từ các task đã làm và nhớ lại giữa các phiên làm việc.

Điểm đáng giá nhất là cách cài: 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. 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, vì hệ thống hook tự định tuyến task và phối hợp agent ở phía sau. 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à bộ khung bao quanh Claude Code và Codex: thêm agent, nhóm agent phối hợp (swarm), bộ nhớ dài hạn và hook, cài bằng một lệnh npx.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Thêm cả đội agent vào Claude Code. README nói ruflo bổ sung hơn 100 agent chuyên biệt. Bạn không phải tự viết từng agent, chỉ cần nêu việc cần làm.

Swarm: nhiều agent phối hợp một việc. Thay vì một agent làm tất cả, ruflo chia việc cho nhiều agent rồi gom kết quả. Ví dụ bạn có thể yêu cầu một swarm tìm module rủi ro nhất, viết test rồi tóm tắt thay đổi.

Bộ nhớ qua các phiên. Agent nhớ những gì đã làm lần trước, dùng tìm kiếm vector (HNSW) để lấy lại kinh nghiệm cũ. Bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần mở Claude Code. README lưu ý đây là mô hình học dạng khái niệm: phần truy xuất vector cục bộ chạy được không cần LLM, nhưng vẫn cần embedding và các module học đã cấu hình.

Hook tự định tuyến. Sau init, hook tự chuyển task cho đúng agent và ghi nhận mẫu làm việc thành công. Bạn không phải gõ lệnh riêng.

Máy chủ MCP. init đăng ký sẵn máy chủ MCP của ruflo. Codex và các client MCP khác cũng dùng được bằng một lệnh khởi động riêng.

Bảng điều khiển (console) ngay cạnh Claude Code. Bạn xem được workflow, agent, model, token và chi phí; mở log của từng lần chạy, tìm kiếm, xử lý lỗi, phát lại và so sánh. Console cũng chạy độc lập trong terminal.

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. Hành động vượt quyền sẽ bị từ chối; hành động liên quan mạng, chi tiêu hoặc phá huỷ luôn cần bạn xác nhận, kể cả ở chế độ auto.

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. Vài ví dụ: ruflo-testgen tìm chỗ thiếu test và sinh test, ruflo-cost-tracker theo dõi token và đặt ngân sách, ruflo-security-audit quét lỗ hổng, ruflo-docs viết và duy trì tài liệu.

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

  • Node.js từ 20.0.0 trở lên. Đây là yêu cầu trong package.json của repo.
  • Claude Code hoặc Codex (hoặc một client MCP khác). ruflo là lớp bao quanh chúng, không thay thế chúng.
  • Nếu cài bằng plugin: Claude Code phiên bản 2.1.287 trở lên. Lệnh claude plugin install từ terminal cần Claude Code 2.1.292 trở lên.
  • Một thư mục dự án để chạy init.

Tư liệu mình có chưa nói rõ về hệ điều hành được hỗ trợ, yêu cầu phần cứng, hay API key riêng cho ruflo. Bạn nên đọc thêm README.md và thư mục docs/ trong repo nếu cần các chi tiết này. Gói npm tên là claude-flow và có lệnh CLI, còn lệnh khuyên dùng trong README là npx ruflo@latest.

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

  1. Kiểm tra NodeChạy node --version, cần 20 trở lên
  2. Mở terminal trong dự ánVào đúng thư mục bạn muốn dùng ruflo
  3. Chạy initnpx ruflo@latest init để thêm agent, hook, bộ nhớ, MCP
  4. Mở lại Claude CodeMở Claude Code trong cùng thư mục để nó nhận cấu hình mới
  5. Giao thử một việcDán câu lệnh mẫu để chạy swarm đầu tiên

A.Kiểm tra Node.js

Mở terminal (PowerShell, Terminal hoặc cmd đều được) và chạy lệnh dưới đây. Con số đầu tiên phải từ 20 trở lên.

Terminal
node --version

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

Đây là chỗ người mới hay vấp: init ghi file vào thư mục hiện tại, nên phải đứng đúng thư mục dự án trước khi chạy. Nếu chưa có dự án, tạo một thư mục trống để thử.

C.Chạy lệnh init

Terminal
npx ruflo@latest init

npx tải ruflo về và chạy luôn, không cần cài toàn cục. Theo README, lệnh này thêm agent, hook, bộ nhớ và máy chủ MCP của ruflo vào dự án. README cũng ghi lệnh này tạo các mục như .claude/, .claude-flow/, CLAUDE.md và file settings trong thư mục làm việc của bạn. Nếu muốn thiết lập từng phần theo hướng dẫn trên màn hình, README có lệnh thay thế:

Terminal
npx ruflo@latest init wizard

D.Mở lại Claude Code trong cùng thư mục

Claude Code nhận cấu hình mới ở lần khởi động kế tiếp. Nếu đang mở sẵn, hãy thoát rồi mở lại trong đúng thư mục vừa chạy init.

E.Giao thử một việc

Dán câu này vào Claude Code (README dùng chính câu này làm ví dụ đầu tiên):

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

F.Cách khác: cài chỉ bằng plugin (không thêm file vào dự án)

Cách này cho bạn công cụ lõi, bảng điều khiển và các mod, mà không thêm file nào vào dự án. Chạy các lệnh 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

Nếu dùng Claude Code 2.1.292 trở lên, bạn có thể cài plugin từ terminal:

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

Các mod chạy với quyền của tài khoản bạn và README nói rõ chúng không bị sandbox. Hãy đọc mã của mod trước khi cài.

G.Cách khác: dùng với Codex hoặc client MCP khác

Cấu hình command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Cách này không cần thiết lập dự án. Lệnh tương đương khi gõ tay:

Terminal
npx -y ruflo@latest mcp start

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

Terminal
npx ruflo tui

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

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

Với cách init: sau khi mở lại Claude Code trong thư mục dự án, gõ /ruflo. README nói đây là lệnh mở bảng điều khiển. Nếu bảng điều khiển hiện ra, cài đặt đã ổn. Bạn cũng nên nhìn vào thư mục dự án xem đã có .claude/, .claude-flow/ và CLAUDE.md chưa.

Với cách plugin: mở /plugin để xem các plugin có xuất hiện ở dòng mod đang hoạt động hay không, rồi gõ /ruflo.

Với terminal: npx ruflo tui phải hiện giao diện bảng điều khiển ngay trong cửa sổ terminal.

Tư liệu mình có không ghi chuỗi chữ cụ thể nào để coi là “thành công”, nên bạn dựa vào các dấu hiệu trên.

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

A.Dev mới nhận một dự án lạ

Bạn vừa nhận repo của đồng nghiệp, chưa biết chỗ nào dễ hỏng. Chạy npx ruflo@latest init, mở lại Claude Code rồi dán 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.

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

B.Người làm kinh doanh muốn xem “đội agent” làm gì

Bạn không rành code nhưng muốn nhìn được tiến độ và chi phí. Cài phần console bằng plugin (ruflo-console@ruflo), mở /ruflo và theo dõi workflow, agent, model, token, chi phí ngay bên cạnh Claude Code. Muốn Claude thao tác trên console giúp, vào Settings → Claude control, chọn write + ask, rồi gõ:

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

Đặt giới hạn trước, rồi mới để agent chạy.

Ông T

Claude sẽ mở trang Missions và đặt mục tiêu; bạn xác nhận hành động tạo. Sau đó kiểm tra Missions đã có mục tiêu chưa và trang Overview đã ghi lại hành động chưa. README nhấn mạnh: tạo mission không có nghĩa tính năng đã được làm xong.

C.Nhóm nhỏ muốn dùng Codex hoặc công cụ MCP khác

Nếu nhóm bạn không dùng Claude Code, vẫn có thể trỏ client MCP vào ruflo. Đặt command là npx, arguments là ["-y", "ruflo@latest", "mcp", "start"]. Bạn có được các công cụ của ruflo mà không phải chạy init trong dự án.

D.Dev muốn thử từng plugin nhỏ

Bạn chỉ cần vài lệnh của một plugin và chưa muốn thêm file vào dự án. Thêm marketplace rồi cài đúng plugin cần dùng, ví dụ sinh test hoặc theo dõi chi phí:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-testgen@ruflo

Một lưu ý trong README: plugin cho bạn lệnh slash và định nghĩa agent, trong khi npx ruflo init mới cho đủ vòng lặp (agent, lệnh, skill, máy chủ MCP, hook, daemon). Cần dùng nghiêm túc thì chọn init.

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

A.Chạy npx báo lỗi hoặc không chạy được

Nguyên nhân hay gặp nhất là Node cũ. Chạy node --version; repo yêu cầu từ 20.0.0 trở lên. Nếu thấp hơn, hãy cập nhật Node rồi thử lại.

B.Claude Code không thấy agent hoặc lệnh của ruflo

Claude Code chỉ nhận cấu hình ở lần khởi động tiếp theo. Hãy thoát hẳn, mở lại đúng thư mục đã chạy init. Với cách plugin, gõ /reload-plugins.

C.Lệnh /plugin hoặc claude plugin install không hoạt động

Cài bằng plugin cần Claude Code 2.1.287 trở lên (và 2.1.292 trở lên nếu cài từ terminal). Cập nhật Claude Code trước.

D.Plugin bị tải 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. Nếu bật từ cả hai nơi, lệnh và mod sẽ nạp hai lần. Hãy gỡ một bản.

E.Claude từ chối thao tác trên console

Thường là hành động vượt mức quyền bạn đã đặt (mặc định read + ask). Nâng mức quyền trong Settings → Claude control nếu bạn thật sự muốn. Việc liên quan mạng, chi tiêu hoặc phá huỷ vẫn luôn cần bạn xác nhận. Nếu cần dừng ngay, bấm Take back control.

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

Điểm mạnh: cài nhanh bằng một lệnh; có nhiều cách tích hợp (init, plugin, MCP, terminal); có bảng điều khiển để nhìn thấy agent đang làm gì; có các mức quyền và bước xác nhận để bạn giữ kiểm soát; giấy phép MIT; cộng đồng lớn và repo còn cập nhật.

Giới hạn: hệ thống rất lớn (48 plugin, hàng trăm công cụ MCP theo README), dễ khiến người mới choáng. README cũng tự nói rõ một số bản demo dùng dữ liệu mẫu và không chứng minh swarm hay bộ nhớ đã hoàn thành việc thật. Mod không bị sandbox. Chi phí token khi nhiều agent chạy cùng lúc là thứ bạn cần tự theo dõi, và tư liệu mình có chưa nêu rõ chi phí cụ thể.

Nên chọn cách khác khi: bạn chỉ cần Claude Code làm vài việc nhỏ, rời rạc, thì Claude Code thuần là đủ. Nếu muốn thử nhẹ nhàng, hãy bắt đầu bằng một hai plugin thay vì cài đủ bộ.

Lời khuyên của mình: thử trên một dự án nhỏ hoặc bản sao, giữ mức quyền ở read + ask, đọc kết quả kỹ rồi mới mở rộng.

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?

Repo dùng giấy phép MIT nên mã nguồn mở và dùng tự do. Tuy nhiên, ruflo chạy bao quanh Claude Code hoặc Codex, nên chi phí của các dịch vụ AI đó vẫn thuộc về bạn. Tư liệu mình có chưa nêu bảng giá cụ thể.

Cài ruflo cần những gì?

Cần Node.js từ 20.0.0 trở lên, và Claude Code hoặc Codex (hay client MCP khác). Nếu cài bằng plugin thì cần Claude Code 2.1.287 trở lên. Lệnh cài chính là npx ruflo@latest init chạy trong thư mục dự án.

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

Tư liệu mình có chưa nói rõ về hệ điều hành được hỗ trợ. Điều chắc chắn là repo yêu cầu Node 20 trở lên và chạy bằng npx. Bạn nên xem README.md và thư mục docs/ trong repo để biết chi tiết cho Windows.

Có cần GPU không?

Tư liệu chưa nêu yêu cầu GPU cho ruflo. README chỉ nhắc một plugin riêng là ruflo-ruvector có tìm kiếm tăng tốc GPU, nhưng đó là plugin tuỳ chọn, không phải điều kiện để cài.

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

Có nếu dùng npx ruflo init: README ghi sẽ thêm các mục như .claude/, .claude-flow/, CLAUDE.md và file settings. Nếu cài chỉ bằng plugin Claude Code thì không có file nào được thêm vào dự án.

Claude có tự ý làm việc nguy hiểm trên bảng điều khiển không?

README nói bạn đặ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 vượt quyền bị từ chối, và việc liên quan mạng, chi tiêu, phá huỷ luôn cần xác nhận kể cả ở chế độ auto. Bạn cũng có nút Take back control để dừng ngay.

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

Claude Code thuần là mô hình cùng bộ công cụ cơ bản. ruflo thêm lớp harness: nhiều agent chuyên biệt, swarm phối hợp, bộ nhớ qua các phiên, hook tự định tuyến, bảng điều khiển và hệ plugin. Nếu việc của bạn nhỏ và rời rạc, Claude Code thuần có thể là đủ.

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.js
    2. B.Mở terminal trong thư mục dự án
    3. C.Chạy lệnh init
    4. D.Mở lại Claude Code trong cùng thư mục
    5. E.Giao thử một việc
    6. F.Cách khác: cài chỉ bằng plugin (không thêm file vào dự án)
    7. G.Cách khác: dùng với Codex hoặc client MCP khác
    8. H.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.Dev mới nhận một dự án lạ
    2. B.Người làm kinh doanh muốn xem “đội agent” làm gì
    3. C.Nhóm nhỏ muốn dùng Codex hoặc công cụ MCP khác
    4. D.Dev muốn thử từng plugin nhỏ
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy npx báo lỗi hoặc không chạy được
    2. B.Claude Code không thấy agent hoặc lệnh của ruflo
    3. C.Lệnh /plugin hoặc claude plugin install không hoạt động
    4. D.Plugin bị tải hai lần
    5. E.Claude từ chối thao tác trên console
  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ỏ.