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

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

Tóm tắt nhanh

Ruflo là một agent harness: lớp công cụ bao quanh Claude Code và Codex để thêm hàng loạt agent chuyên biệt, bộ nhớ xuyên phiên, hook và MCP server. Bạn chạy một lệnh npx trong thư mục dự án là dùng được, cần Node 20 trở lên. Người mới cài không khó, nhưng hệ thống rất lớn nên nên bắt đầu từ vài tác vụ nhỏ.

Ruflo là một “agent harness”, tức bộ khung đặt quanh Claude Code và Codex để biến một trợ lý AI đơn lẻ thành cả một nhóm làm việc. Mô hình AI lo phần viết. Ruflo lo phần còn lại: công cụ, bộ nhớ, vòng lặp, kiểm soát quyền và phối hợp giữa nhiều agent.

Vấn đề nó giải quyết rất quen thuộc. Khi dùng Claude Code cho dự án thật, bạn thường phải tự nhắc lại bối cảnh, tự chia việc, tự kiểm tra kết quả. Ruflo thêm sẵn agent chuyên biệt, hook tự định tuyến tác vụ và bộ nhớ để các phiên sau nhớ được phiên trước. Repo hiện có khoảng 81.600 sao và 9.600 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong vài tháng gần đây.

Bài này dành cho lập trình viên mới và người làm văn phòng đã quen Claude Code, muốn có thêm một “đội” agent mà không phải tự lắp ráp. Điểm đáng giá nhất: README nói thẳng là sau init bạn cứ dùng Claude Code như bình thường, không cần học hết hàng trăm công cụ bên trong.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) bao quanh Claude Code và Codex, thêm agent chuyên biệt, bộ nhớ, swarm và MCP server chỉ với một lệnh init.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Theo README, Ruflo là lớp thực thi quanh Claude Code và Codex. Dưới đây là những phần đáng chú ý nhất, giải thích theo lợi ích thực tế.

A.Nhóm agent chuyên biệt và swarm

Sau khi cài, dự án của bạn có sẵn nhiều agent chuyên biệt (README ghi 98 agent ở đường cài đầy đủ). Chúng có thể phối hợp thành “swarm”, nghĩa là một nhóm chia việc cho nhau. Bạn chỉ cần giao một việc lớn, ví dụ review cả repo, thay vì tự chia từng bước.

B.Bộ nhớ và học từ kinh nghiệm

Ruflo có bộ nhớ xuyên phiên và cơ chế học từ các tác vụ đã làm. README mô tả đây là vòng học mang tính khái niệm, và lưu ý 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. Lợi ích: lần sau bạn đỡ phải giải thích lại từ đầu.

C.Hook tự động

Hook định tuyến tác vụ, ghi nhận mẫu làm việc thành công và điều phối agent ngầm ở nền. Bạn không phải gõ lệnh riêng cho từng việc.

D.MCP server

Ruflo có MCP server nên Codex hoặc bất kỳ ứng dụng MCP nào cũng nối vào được, không chỉ Claude Code.

E.Bảng điều khiển (console) bên cạnh Claude Code

Bạn xem được workflow, agent, model, token và chi phí. Có thể mở log và kết quả của từng lần chạy, tìm kiếm, xem lại và so sánh. Mở bằng lệnh /ruflo trong Claude Code, hoặc chạy riêng bằng npx ruflo tui.

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

Trong Settings có mục Claude control. Bạn chọn mức read, write, manage hoặc full, và chọn duyệt ask (hỏi từng lần) hoặc auto. Mặc định hiện là read + ask. Các thao tác liên quan mạng, chi tiêu hoặc phá huỷ vẫn phải xác nhận ngay cả khi để auto. Có nút Take back control để lấy lại quyền.

G.Kho plugin

README liệt kê 48 plugin (cộng 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í dụ ruflo-testgen tìm chỗ thiếu test rồi sinh test, ruflo-cost-tracker theo dõi token và đặt ngân sách, ruflo-aidefence chặn prompt injection và phát hiện thông tin cá nhân.

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

Tư liệu chỉ nói những điều sau:

  • Node.js từ 20.0.0 trở lên (theo package.json).
  • Claude Code nếu bạn dùng đường cài vào dự án hoặc đường plugin. Đường plugin cần Claude Code từ 2.1.287 trở lên. Lệnh cài plugin từ terminal cần từ 2.1.292 trở lên.
  • Codex hoặc ứng dụng MCP khác nếu bạn không dùng Claude Code.
  • Một thư mục dự án để chạy lệnh init.

README không nêu yêu cầu về hệ điều hành hay GPU ở phần mình có. Phần README còn lại bị cắt nên mình không khẳng định thêm về API key. Nếu bạn gọi các nhà cung cấp AI khác, hãy xem hướng dẫn trong thư mục docs/ của repo.

Plugin và mod của Ruflo chạy với đúng quyền tài khoản của bạn và không bị sandbox. README khuyên đọc code trước khi cài. Ngoài ra nên theo dõi chi phí token, vì swarm gọi nhiều agent cùng lúc.

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

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

  1. Mở terminalVào đúng thư mục dự án của bạn
  2. Chạy initGõ npx ruflo@latest init để thêm agent, hook, bộ nhớ, MCP server
  3. Mở lại Claude CodeMở Claude Code trong cùng thư mục để nó nhận cấu hình
  4. Giao thử một việcĐưa một tác vụ thật cho swarm
  5. (Tuỳ chọn) Cài plugin hoặc nối CodexChọn đường plugin hoặc MCP nếu cần

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

Lỗi người mới hay gặp nhất là chạy lệnh sai chỗ. Hãy mở terminal ngay trong thư mục dự án, vì init ghi file vào thư mục hiện tại. Trên Windows, bạn có thể mở PowerShell rồi dùng cd tới thư mục đó. Dòng dưới chỉ là ví dụ, bạn thay bằng đường dẫn của mình.

PowerShell
cd D:\duan\cua-hang-online

B.Chạy lệnh init

Đây là lệnh chính trong 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. README ghi init thêm agent, hook, bộ nhớ và MCP server vào dự án. Ở bảng so sánh, đường này tạo các thư mục và file như .claude/, .claude-flow/, CLAUDE.md cùng các file hỗ trợ và settings. Vì vậy hãy chạy trong một dự án đã có Git để dễ xem lại thay đổi.

Muốn cài theo kiểu hỏi đáp từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code

Claude Code sẽ nhận cấu hình của Ruflo ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn, hãy thoát rồi mở lại trong cùng thư mục.

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

Gõ câu lệnh mẫu của 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.

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

Đường này không thêm file vào dự án. README ghi nó cài công cụ lõi, console và mod. Chạy từng dòng 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

Từ terminal, với Claude Code 2.1.292 trở lên, README ghi thêm:

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

Lưu ý: đường plugin nhẹ hơn, không cài hook, và README cho biết chỉ ruflo-core đăng ký MCP server. Muốn đủ bộ như tài liệu mô tả, hãy dùng npx ruflo@latest init.

F.Cách khác: Codex hoặc ứng dụng MCP khác

Cấu hình command là npx và arguments như sau:

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

Cách này tương đương chạy npx -y ruflo@latest mcp start. Bạn điền hai giá trị đó vào phần cấu hình MCP server của ứng dụng đang dùng. Mỗi ứng dụng đặt ô nhập ở chỗ khác nhau, nên mình không chỉ chính xác được vị trí.

G.Cách khác: chạy giao diện terminal riêng

Terminal
npx ruflo tui

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

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

Theo tư liệu, bạn có thể kiểm tra như sau:

  • Sau init: trong thư mục dự án xuất hiện .claude/, .claude-flow/ và CLAUDE.md. Mở lại Claude Code, gõ /ruflo để mở console.
  • Sau khi cài plugin: gõ /plugin và xem các mod xuất hiện trong dòng active mods. README hướng dẫn kiểm tra đúng cách này.
  • Với giao diện terminal: chạy npx ruflo tui và xem console hiện ra. Trong console, /ruflo market mở Plugin Catalog liệt kê plugin, mod và skill, có nút cài, bật, tắt và cập nhật (mỗi thao tác đều hỏi lại trước).
  • Với Codex hoặc MCP client: ứng dụng nối được vào server npx -y ruflo@latest mcp start mà không báo lỗi khởi động.

README chưa mô tả đầu ra chính xác của từng lệnh. Nếu màn hình không giống bạn nghĩ, hãy đối chiếu với phần hướng dẫn console trong thư mục docs/.

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

Bạn vẫn viết code. Ruflo lo phần điều phối.

Ông T

A.Lập trình viên mới: nhờ swarm rà soát cả repo

Bạn vừa nhận một dự án cũ và chưa biết chỗ nào dễ hỏng. Sau khi init, mở Claude Code và 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.

Kết quả mong đợi theo README: Claude tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã thay đổi. Bạn nên xem lại diff trước khi giữ thay đổi.

B.Người quản lý dự án: tạo “mission” và theo dõi trong console

Bạn muốn theo dõi việc mà không đọc log. Cài console theo đường plugin, mở /ruflo, rồi vào Settings → Claude control và chọn write + ask. Sau đó nhờ Claude:

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

Claude mở trang Missions và đặt mục tiêu. Bạn xác nhận hành động tạo. Kiểm tra Missions có mục tiêu mới và Overview có ghi lại hành động. README nhấn mạnh: tạo mission chưa có nghĩa tính năng đã được làm. Muốn dừng, bấm Take back control.

C.Chủ dự án nhỏ: sinh test còn thiếu bằng plugin

Bạn có một website nhỏ chưa có nhiều test. README mô tả ruflo-testgen là plugin tìm chỗ thiếu test và tạo test tự động. Theo đúng mẫu lệnh cài plugin trong README, bạn gõ trong Claude Code:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-testgen@ruflo
/reload-plugins

Sau đó nhờ Claude tìm phần thiếu test và viết bổ sung. Với plugin này README chỉ mô tả ngắn gọn, nên hãy thử trên một nhánh riêng trước.

D.Người dùng Codex: dùng chung bộ công cụ qua MCP

Nếu bạn không dùng Claude Code mà dùng Codex, hãy khai báo MCP server với command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Khi đó Codex gọi được công cụ của Ruflo (README nói có khoảng 406 công cụ MCP và 61 lệnh CLI, nhưng bạn không cần học hết). Bạn bắt đầu từ vài tác vụ nhỏ rồi mở rộng dần.

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

A.Node quá cũ

Package yêu cầu Node từ 20.0.0. Nếu npx báo lỗi khi chạy, gõ node --version để kiểm tra. Nếu thấp hơn 20, hãy nâng cấp Node rồi chạy lại.

B.Claude Code chưa thấy gì sau init

README ghi 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 trong đúng thư mục bạn đã chạy init. Chạy init ở thư mục này mà mở Claude Code ở thư mục khác là nguyên nhân rất hay gặp.

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

Đường plugin cần Claude Code từ 2.1.287 trở lên, và lệnh cài từ terminal cần từ 2.1.292 trở lên. Hãy cập nhật Claude Code. Sau khi cài, chạy /reload-plugins để nạp lại.

D.Cài một plugin hai lần từ hai kho

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

E.Chi phí token tăng nhanh

Nhiều agent chạy cùng lúc nghĩa là tốn token hơn. Hãy mở console để xem token và chi phí. Giữ Claude control ở mức read + ask hoặc write + ask để mọi hành động quan trọng đều phải qua tay bạn. Plugin ruflo-cost-tracker cũng hỗ trợ đặt ngân sách và cảnh báo chi phí.

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

Điểm mạnh. Cài đặt một lệnh. Có sẵn agent, hook, bộ nhớ và MCP server. Có console để xem và kiểm soát, và giấy phép MIT. Dùng được với cả Claude Code lẫn Codex, kho plugin phong phú. Cơ chế phân quyền Claude control, với mặc định read + ask, là điểm cộng cho người cẩn thận.

Giới hạn. Hệ thống rất lớn (hàng chục plugin, hàng trăm công cụ MCP) nên người mới dễ choáng. init thêm khá nhiều file vào dự án, nên cần quản lý bằng Git. Mod và plugin không bị sandbox. Bản demo trong README dùng dữ liệu mẫu hoặc phát lại khung hình, chưa chứng minh kết quả swarm hoàn chỉnh hay khả năng nhớ lại. README cũng ghi vòng học là mô tả khái niệm. Phần yêu cầu API key và hệ điều hành chưa rõ trong phần tư liệu mình có.

Khi nào chọn cách khác. Nếu bạn chỉ cần Claude Code trả lời một việc nhỏ, dùng thẳng Claude Code là đủ. Nếu muốn thử nhẹ, hãy cài từng plugin. Nếu cần chạy trong môi trường rất nghiêm ngặt về bảo mật, hãy đọc kỹ SECURITY.md và mã nguồn trước khi dùng.

Lời khuyên của mình: thử trên một dự án nhỏ hoặc nhánh riêng, chạy một tác vụ review như ví dụ trên, xem kết quả trong console 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 bạn dùng và sửa mã được tự do. Tuy vậy bạn vẫn trả chi phí cho mô hình AI bạn kết nối, như Claude Code hay Codex. Tư liệu chưa nêu rõ mức giá của các dịch vụ này.

Cần cài gì trước khi chạy Ruflo?

Cần Node.js từ 20.0.0 trở lên. Nếu dùng đường plugin, cần Claude Code từ 2.1.287 trở lên. Lệnh cài plugin từ terminal cần Claude Code từ 2.1.292 trở lên.

Chỉ có một lệnh cài thôi à?

Đường chính là `npx ruflo@latest init` chạy trong thư mục dự án, sau đó mở lại Claude Code. Ngoài ra có đường chỉ cài plugin trong Claude Code, đường nối Codex hoặc MCP client bằng `npx -y ruflo@latest mcp start`, và đường chạy giao diện terminal bằng `npx ruflo tui`.

Ruflo dùng được với Codex và công cụ khác ngoài Claude Code không?

Có. README ghi Codex và các MCP client khác dùng được bằng cách trỏ tới `npx -y ruflo@latest mcp start`. README còn nhắc tới Grok Build qua lệnh `npx ruflo init --grok`, và có thể dùng `--dry-run` để xem trước.

Ruflo có tự ý làm những việc nguy hiểm không?

Phần console có cơ chế phân quyền: bạn chọn mức read, write, manage hoặc full, và duyệt kiểu 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 cần xác nhận kể cả ở chế độ auto. Tuy vậy plugin và 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 mã trước khi cài.

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

Claude Code thuần là một trợ lý đơn lẻ. Ruflo là lớp bao quanh, thêm nhiều agent chuyên biệt, swarm, bộ nhớ xuyên phiên, hook định tuyến tác vụ và console theo dõi. Bạn vẫn dùng Claude Code bình thường, Ruflo làm phần điều phối ở nền.

Có cần GPU không?

Tư liệu mình có không nêu yêu cầu GPU cho cách cài cơ bản. Một số plugin như ruflo-ruvector nhắc tới tìm kiếm tăng tốc GPU, nhưng README không nói đó là điều kiện bắt buộc. Muốn chắc chắn hãy xem tài liệu của từng plugin.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
    1. A.Nhóm agent chuyên biệt và swarm
    2. B.Bộ nhớ và học từ kinh nghiệm
    3. C.Hook tự động
    4. D.MCP server
    5. E.Bảng điều khiển (console) bên cạnh Claude Code
    6. F.Cho Claude điều khiển nhưng bạn đặt giới hạn
    7. G.Kho plugin
  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.Mở lại Claude Code
    4. D.Giao một việc thật
    5. E.Cách khác: chỉ cài plugin trong Claude Code
    6. F.Cách khác: Codex hoặc ứng dụng MCP khác
    7. G.Cách khác: chạy giao diện terminal riê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: nhờ swarm rà soát cả repo
    2. B.Người quản lý dự án: tạo “mission” và theo dõi trong console
    3. C.Chủ dự án nhỏ: sinh test còn thiếu bằng plugin
    4. D.Người dùng Codex: dùng chung bộ công cụ qua MCP
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Node quá cũ
    2. B.Claude Code chưa thấy gì sau init
    3. C.Lệnh /plugin không nhận hoặc cài plugin thất bại
    4. D.Cài một plugin hai lần từ hai kho
    5. E.Chi phí token tăng nhanh
  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ỏ.