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

ruflo: điều phối nhóm 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 nhóm agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

ruflo (tiền thân là Claude Flow) là một agent harness: lớp công cụ bọc quanh Claude Code và Codex để chạy nhiều agent phối hợp, có bộ nhớ và hook tự động. Bạn dùng nó để Claude Code làm việc có tổ chức hơn trên dự án thật. Cài khá dễ: một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên.

ruflo là một "agent meta-harness" cho Claude Code và Codex. Nói đơn giản: mô hình AI chỉ biết viết, còn ruflo là bộ đồ nghề xung quanh để AI làm việc được. Nó cho AI công cụ, bộ nhớ, vòng lặp, hook và các lớp kiểm soát. Repo này trước đây có tên Claude Flow, của tác giả Reuven Cohen (rUv).

Bạn nên xem ruflo nếu đang dùng Claude Code hoặc Codex cho dự án thật và muốn AI chia việc cho nhiều agent, nhớ lại kinh nghiệm giữa các phiên làm việc, và có một bảng điều khiển để theo dõi. Người mới cũng dùng được, vì README nói rõ: bạn không cần học hết hàng trăm công cụ MCP hay lệnh CLI. Sau khi chạy init, bạn cứ dùng Claude Code như bình thường, phần định tuyến và phối hợp agent chạy ngầm bằng hook.

Điểm đáng giá nhất là cài chỉ bằng một lệnh, nhưng khi cài xong bạn có cả một hệ: agent, hook, bộ nhớ, máy chủ MCP, và một "cockpit" (bảng điều khiển) ngay cạnh Claude Code. Repo hiện có khoảng 81.600 sao và 9.600 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 (harness) bọc quanh Claude Code và Codex: thêm agent, bộ nhớ, hook và máy chủ MCP vào dự án chỉ bằng một lệnh npx.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những phần chính, theo cách dễ hình dung nhất.

Nhiều agent làm việc như một đội (swarm). Thay vì một AI làm tuần tự, ruflo cho các agent tự chia việc. README nhắc đến hơn 100 agent chuyên biệt. Với bạn, lợi ích là các việc lớn như "rà soát cả repo" được chia nhỏ và xử lý có tổ chức.

Bộ nhớ qua nhiều phiên. Agent có thể nhớ lại kinh nghiệm từ các task trước, nên lần sau không phải bắt đầu từ con số không. README ghi chú đây là mô hình học theo vòng lặp ở mức khái niệm. Việc truy xuất vector cục bộ chạy được mà không cần LLM, nhưng vẫn cần embedding và các module học đã được cấu hình.

Hook tự động. Sau init, hook sẽ tự định tuyến task và học từ các mẫu thành công. Bạn không phải gọi từng công cụ bằng tay.

Bảng điều khiển ruflo-console. Đây là cockpit để theo dõi workflow, agent, model, token và chi phí cạnh Claude Code. Bạn mở log của từng agent, tìm kiếm, xem lỗi, phát lại và so sánh các lần chạy.

Cho Claude điều khiển console trong giới hạn bạn đặt. Trong 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 tại là read + ask. Các hành động động đến mạng, chi tiền 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 thông minh, kiểm thử, bảo mật, DevOps và các nhóm khác. Ví dụ ruflo-testgen tìm test còn thiếu và sinh test, ruflo-cost-tracker theo dõi token và đặt ngân sách, ruflo-security-audit quét lỗ hổng.

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à README nói là không làm lộ dữ liệu. Phần này dành cho người dùng nâng cao.

Dùng được với client khác. Ngoài Claude Code, Codex và các client MCP khác cũng kết nối được. README còn có tuỳ chọn --grok cho Grok Build.

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

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

  • Node.js bản 20.0.0 trở lên. Đây là yêu cầu trong package.json. Bạn cần Node để chạy được lệnh npx.
  • Claude Code nếu muốn dùng theo cách chính. Riêng đường cài "chỉ plugin" thì cần Claude Code bản 2.1.287 trở lên. Lệnh claude plugin install từ terminal cần bản 2.1.292 trở lên.
  • Một thư mục dự án để chạy lệnh init bên trong.

Tư liệu không nói rõ về hệ điều hành, phần cứng hay API key riêng cho ruflo. Vì vậy mình không khẳng định gì thêm. Nếu bạn dùng mô hình qua Claude Code hay Codex thì tài khoản của các công cụ đó vẫn áp dụng như bình thường. Phần "chưa rõ" nên xem thêm trong README và thư mục docs/ của repo.

Các mod (ruflo-mods…) 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 rõ: hãy đọc code trước khi cài. Hãy để Claude control ở mức thấp (read + ask) cho đến khi bạn quen.

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

README có nhiều đường cài. Đường nhanh nhất và được khuyên dùng là chạy init trong dự án. Mình tóm tắt trước:

  1. Mở terminal đúng thư mụcĐứng trong thư mục dự án của bạn
  2. Chạy initMột lệnh npx thêm agent, hook, bộ nhớ, MCP server vào dự án
  3. Khởi động 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ệc thậtDán câu lệnh mẫu của README cho Claude Code
  5. (Tuỳ chọn) Mở consoleGõ /ruflo trong Claude Code để thấy cockpit

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

Đây là chỗ người mới hay vấp nhất: lệnh init ghi file vào thư mục hiện tại, nên bạn phải đứng đúng thư mục dự án. Nếu chưa chắc đường dẫn, bạn có thể cd vào trước. Ví dụ (thay bằng đường dẫn của bạn):

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

B.Chạy lệnh init

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

Terminal
npx ruflo@latest init

npx tải bản mới nhất của ruflo rồi chạy luôn, bạn không phải cài toàn cục. 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, cách này tạo các thư mục như .claude/, .claude-flow/ và file CLAUDE.md trong dự án của bạn, và là đường cài đầy đủ nhất.

Nếu muốn thiết lập tương tác từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

Nếu muốn xem trước ruflo sẽ ghi gì khi dùng với Grok Build, README cho phép thêm --dry-run:

Terminal
npx ruflo init --grok

C.Khởi động 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 tiếp theo. Nếu bạn đang mở sẵn Claude Code lúc chạy init, hãy đóng và mở lại.

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

Nếu bạn không muốn ruflo thêm file nào vào dự án, dùng đường plugin. Đường này cài công cụ lõi, console và mod, và không thêm file vào thư mục dự án. Gõ các 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

Từ terminal, trên Claude Code 2.1.292 trở lên, README ghi lệnh:

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

Lưu ý README so sánh: cách plugin gọn nhẹ, không có hook và chỉ có MCP server khi cài ruflo-core. Còn npx ruflo init mới là "vòng lặp đầy đủ", gồm 98 agent, hơn 60 lệnh, 30 skill, MCP server, hook và daemon.

E.Dùng với Codex hoặc client MCP khác

Với Codex hay client MCP khác, bạn không cần thiết lập dự án. Hãy cấu hình command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Tương đương dòng lệnh:

Terminal
npx -y ruflo@latest mcp start

F.Chạy console trong terminal thường

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

Terminal
npx ruflo tui

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

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

Có vài dấu hiệu theo tư liệu:

  1. Sau npx ruflo@latest init: lệnh chạy xong không báo lỗi, và trong thư mục dự án xuất hiện các mục như .claude/, .claude-flow/ và CLAUDE.md.
  2. Trong Claude Code: mở lại ở cùng thư mục rồi gõ /ruflo. Nếu console hiện ra thì ổn.
  3. Với đường plugin: mở /plugin và xem plugin có xuất hiện trong dòng "active mods" hay không.
  4. Với terminal: npx ruflo tui mở được giao diện console.

Sau đó thử giao một việc thật (xem phần dưới) và quan sát xem Claude Code có dùng các agent của ruflo không.

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

README nhấn mạnh một ý: bạn không cần học cách điều khiển từng công cụ. Đưa cho Claude Code một việc cụ thể là đủ.

A.Tình huống 1: Nhờ cả đội agent rà soát một repo

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

Claude Code sẽ tìm module rủi ro nhất, viết test cho nó và tóm tắt phần đã thay đổi. Kết quả là một báo cáo ngắn kèm test mới, để bạn xem lại trước khi giữ.

Đưa cho agent một việc cụ thể, còn việc chia nhóm cứ để harness lo.

Ông T

B.Tình huống 2: Theo dõi tiến độ trong console

Bạn quản lý nhiều việc song song và muốn thấy agent đang làm gì, tốn bao nhiêu token. Bạn mở /ruflo, vào Settings → Claude control và chọn write + ask. Rồi bạn nhờ Claude: "Create a mission to add a dark mode toggle. Show me the mission and its status." (đây là câu mẫu trong README).

Claude mở trang Missions và đặt mục tiêu; bạn xác nhận hành động tạo đang chờ. Kết quả: mục tiêu xuất hiện trong Missions, và trang Overview ghi lại hành động. README nhắc rõ: tạo mission không có nghĩa tính năng đã được làm xong. Muốn dừng, bấm Take back control.

C.Tình huống 3: Dùng ruflo với Codex hoặc công cụ MCP khác

Bạn là nhân viên kỹ thuật dùng Codex thay cho Claude Code. Trong phần cấu hình MCP của client, bạn khai báo command npx với arguments ["-y", "ruflo@latest", "mcp", "start"]. Client sẽ gọi các công cụ của ruflo qua MCP mà không cần thêm file nào vào dự án.

D.Tình huống 4: Thử một plugin cụ thể trước khi cam kết

Bạn chỉ muốn thử riêng phần tạo test hoặc theo dõi chi phí. README gợi ý đường plugin: thêm marketplace rồi cài từng plugin như ruflo-rag-memory hay ruflo-swarm. Bạn thử vài lệnh gạch chéo, thấy hợp rồi mới tính chuyện chạy init cho đầy đủ. Trong console, lệnh /ruflo market mở Plugin Catalog, mỗi lần cài hay bật/tắt đều hỏi xác nhận trước.

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

Lệnh npx không nhận hoặc báo lỗi phiên bản. Nguyên nhân thường là chưa cài Node hoặc Node quá cũ. package.json yêu cầu Node 20.0.0 trở lên. Hãy kiểm tra bằng node --version, rồi cập nhật Node nếu cần.

Chạy init xong nhưng Claude Code không thấy gì. Claude Code chỉ nhận cấu hình mới ở lần khởi động tiếp theo. Hãy đóng hẳn và mở lại ở đúng thư mục bạn vừa chạy init. Nếu mở sai thư mục thì sẽ không có agent hay hook nào.

Lệnh /plugin hoặc claude plugin install không chạy. Đường plugin cần Claude Code từ 2.1.287 trở lên (và 2.1.292 cho lệnh cài từ terminal). Hãy cập nhật Claude Code. Cũng nhớ gõ các lệnh /plugin ... bên trong Claude Code, không gõ trong terminal.

Claude báo hành động bị từ chối trong console. Đây là thiết kế chứ không phải lỗi: hành động vượt mức quyền bạn đặt sẽ bị từ chối, và các hành động liên quan mạng, chi tiền hay phá huỷ luôn cần xác nhận. Nếu bạn thật sự muốn cho phép, hãy nâng mức ở Settings → Claude control, và nên làm từng bước một.

Plugin ngoài bị tải hai lần. README cảnh báo với các plugin như agentic-qe-fleet, agentdb, agentic-flow: chỉ cài từ một marketplace. 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.

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

Điểm mạnh:

  • Cài nhanh, chỉ một lệnh, và có đường cài nhẹ (plugin) nếu bạn không muốn file mới trong dự án.
  • Gom nhiều thứ vào một chỗ: agent, bộ nhớ, hook, console, plugin.
  • Có lớp kiểm soát rõ ràng: mức quyền, xác nhận, nút lấy lại quyền điều khiển.
  • Giấy phép MIT, repo đông người dùng và vẫn được cập nhật.

Giới hạn cần biết:

  • Hệ thống rất lớn (hàng chục plugin, hàng trăm công cụ MCP). Người mới dễ choáng, nên bắt đầu từ init và một việc cụ thể.
  • README tự nói phần học và bộ nhớ chỉ là mô hình khái niệm, và các video demo dùng dữ liệu mẫu, không chứng minh swarm đã hoàn thành việc thật. Hãy kiểm chứng kết quả bằng chính dự án của bạn.
  • Cách init thêm nhiều file (.claude/, .claude-flow/, CLAUDE.md…) vào dự án. Nên dùng trong nhánh riêng hoặc dự án có Git để dễ hoàn tác.
  • Mod chạy với quyền tài khoản, không có sandbox.

Khi nào chọn cách khác: nếu bạn chỉ cần Claude Code làm vài việc nhỏ lẻ, dùng Claude Code thuần là đủ và đơn giản hơn. Nếu bạn chỉ muốn thử một tính năng, hãy cài từng plugin riêng thay vì cả bộ. Còn nếu dự án đủ lớn, cần nhiều agent phối hợp, cần nhớ lại kinh nghiệm và theo dõi chi phí, ruflo là lựa chọn đáng thử.

4.8/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. Tư liệu không nói gì về phí của các mô hình AI đứng sau. Nếu bạn dùng Claude Code hay Codex thì chi phí của các dịch vụ đó vẫn áp dụng như bình thường. Plugin ruflo-cost-tracker có thể giúp theo dõi token và đặt ngân sách.

ruflo cài bằng cách nào, có khó không?

Cách chính là chạy `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code. Bạn cần Node 20 trở lên. Ngoài ra còn đường cài chỉ bằng plugin trong Claude Code (cần bản 2.1.287 trở lên) và đường MCP cho Codex.

Cài plugin và chạy `npx ruflo init` khác nhau thế nào?

Theo README, đường plugin gọn nhẹ: không thêm file vào dự án, không có hook, và chỉ có MCP server khi cài `ruflo-core`. Còn `npx ruflo init` là vòng lặp đầy đủ với 98 agent, hơn 60 lệnh, 30 skill, MCP server, hook và daemon, đồng thời thêm các thư mục như `.claude/` và `.claude-flow/` vào dự án.

ruflo có dùng được với Codex không, hay chỉ Claude Code?

Dùng được cả hai. Với Codex hoặc client MCP khác, bạn cấu hình command `npx` với arguments `["-y", "ruflo@latest", "mcp", "start"]`. README cũng có tuỳ chọn `--grok` cho Grok Build.

Có an toàn không? Claude có tự ý làm bậy trong console không?

Mức quyền của Claude trong console do bạn đặt: read, write, manage hoặc full, với chế độ ask hoặc auto. Mặc định là read + ask. Các hành động liên quan mạng, chi tiền và phá huỷ vẫn cần xác nhận, và bạn có thể bấm Take back control để dừng. Riêng các mod chạy với quyền tài khoản và không có sandbox, nên README khuyên đọc code trước khi cài.

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

Tư liệu không nêu yêu cầu phần cứng cho đường cài chính. Một plugin có nhắc đến tìm kiếm tăng tốc GPU (ruflo-ruvector), nhưng đó là phần tuỳ chọn. Chưa có thông tin về cấu hình tối thiểu.

Chạy được trên Windows không?

Tư liệu không ghi rõ hệ điều hành được hỗ trợ. Điều kiện duy nhất README nêu là Node 20 trở lên và Claude Code đủ phiên bản cho đường plugin. Bạn nên xem thêm README và thư mục docs/ trong repo nếu cần chắc chắn.

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 trong thư mục dự án
    2. B.Chạy lệnh init
    3. C.Khởi động lại Claude Code
    4. D.Cách khác: chỉ cài plugin trong Claude Code
    5. E.Dùng với Codex hoặc client MCP khác
    6. F.Chạy console 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.Tình huống 1: Nhờ cả đội agent rà soát một repo
    2. B.Tình huống 2: Theo dõi tiến độ trong console
    3. C.Tình huống 3: Dùng ruflo với Codex hoặc công cụ MCP khác
    4. D.Tình huống 4: Thử một plugin cụ thể trước khi cam kết
  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ỏ.