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

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

Tóm tắt nhanh

Ruflo là một “agent harness”, tức lớp công cụ bao quanh Claude Code và Codex để các AI agent phối hợp thành nhóm, có bộ nhớ và có giới hạn an toàn. Bạn dùng nó để giao việc lập trình phức tạp cho nhiều agent cùng làm. Cài khá đơn giản: một lệnh npx trong thư mục dự án, cần Node từ 20 trở lên.

Ruflo là một “agent harness” (bộ khung điều khiển agent) cho Claude Code và Codex. Hiểu đơn giản: mô hình AI chỉ biết viết, còn Ruflo cung cấp cho nó công cụ, bộ nhớ, vòng lặp và các chốt kiểm soát để nó làm việc như một đội. Repo hiện có khoảng 81.588 sao và 9.608 fork, giấy phép MIT, viết chủ yếu bằng TypeScript.

Vấn đề nó giải quyết: dùng Claude Code một mình thì mỗi phiên làm việc gần như bắt đầu lại từ đầu, và một việc lớn phải tự bạn chia nhỏ. Ruflo thêm vào dự án của bạn hàng loạt agent chuyên biệt, hook tự động định tuyến công việc, bộ nhớ giữ lại kinh nghiệm giữa các phiên và một MCP server. Bạn vẫn viết code như bình thường, phần phối hợp để Ruflo lo.

Ai nên dùng: lập trình viên đã quen Claude Code hoặc Codex, muốn giao những việc nhiều bước như rà soát repo, viết test, theo dõi chi phí. Điểm đáng giá nhất là cách cài: một lệnh npx ruflo@latest init là xong phần nền, bạn không cần học hết hàng trăm công cụ bên trong. Dân văn phòng không code thì repo này hơi nặng, nhưng bài vẫn giải thích đủ để bạn hiểu nó làm gì.

Framework

ruvnet/ruflo

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

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Theo README, Ruflo có quá nhiều tính năng để kể hết. Dưới đây là những ý thực dụng nhất.

  • Nhiều agent chuyên biệt làm việc theo nhóm (swarm). Thay vì một AI làm mọi thứ, bạn có thể nhờ cả một “bầy” agent chia việc. README nói bản cài bằng CLI mang theo 98 agent, hơn 60 lệnh và 30 skill.
  • Bộ nhớ qua nhiều phiên. Agent nhớ lại những gì đã làm tốt trước đó nên đỡ phải giải thích lại. README lưu ý phần tìm kiếm vector cục bộ có thể chạy mà không cần LLM, nhưng vẫn cần cấu hình embedding.
  • Hook tự động. Sau khi cài, bạn cứ dùng Claude Code như thường, hook sẽ tự định tuyến công việc và học từ các mẫu thành công ở phía sau.
  • Bảng điều khiển (console) ngay cạnh Claude Code. Theo dõi workflow, agent, mô hình, token và chi phí, xem lại log, tìm lỗi, phát lại và so sánh các lần chạy.
  • Cho Claude điều khiển console, nhưng bạn đặt giới hạn. Có bốn mức quyền: read, write, manage, full, và hai chế độ duyệt: ask hoặc auto. Mặc định hiện là read + ask. Hành động liên quan mạng, chi tiêu và phá hủy luôn cần bạn xác nhận, kể cả ở chế độ auto.
  • 48 plugin chia theo nhóm: điều phối, bộ nhớ, học máy, chất lượng code và kiểm thử, bảo mật, DevOps, mở rộng. 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-aidefence chặn prompt injection.
  • Federation. Agent trên các máy khác nhau có thể liên lạc với nhau một cách an toàn. Phần này dành cho người dùng nâng cao.
  • Dùng được với Codex và các MCP client khác, không chỉ Claude Code.

README cũng nhắn nhủ người mới: bạn không cần học 406 công cụ MCP hay 61 lệnh CLI. Cài xong, cứ dùng Claude Code bình thường.

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

Tư liệu nêu rõ những điều sau:

  • Node.js 20 trở lên (package.json yêu cầu Node >=20.0.0). Bạn cần có npx đi kèm Node.
  • Claude Code, nếu muốn dùng đường cài plugin: cần bản 2.1.287 trở lên. Lệnh cài plugin ngay từ terminal cần Claude Code 2.1.292 trở lên.
  • Codex hoặc MCP client khác nếu bạn không dùng Claude Code.
  • Một thư mục dự án để chạy lệnh init trong đó.

Còn các thông tin sau thì phần README mình có chưa nói rõ: hệ điều hành được hỗ trợ, có cần API key riêng của Ruflo hay không, yêu cầu phần cứng. Bạn nên xem thêm README.md và thư mục docs/ trong repo. Claude Code và Codex là công cụ riêng, bạn cần có tài khoản hoặc quyền dùng chúng theo cách của từng công cụ.

Mod và plugin chạy với quyền tài khoản của bạn và không bị cô lập (sandbox). Hãy đọc mã nguồn trước khi cài. Với tính năng cho Claude điều khiển console, cứ để mặc định read + ask và chỉ nâng quyền khi bạn thật sự cần.

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

README có ba đường: cài vào dự án bằng CLI (khuyên dùng cho dùng thật), cài chỉ bằng plugin Claude Code, và nối vào Codex/MCP client. Bài này đi đường đầu tiên làm chính, rồi nói thêm hai đường kia.

  1. Mở terminal đúng thư mụcVào thư mục dự án mà bạn muốn dùng Ruflo
  2. Chạy initMột lệnh npx thêm agent, hook, bộ nhớ và MCP server vào dự án
  3. Mở 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ậtGõ một yêu cầu cụ thể và để swarm làm
  5. Mở console (tùy chọn)Gõ /ruflo trong Claude Code để xem bảng điều khiển

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

Chỗ người mới hay vấp nhất là chạy lệnh sai thư mục. init ghi file vào thư mục hiện tại, nên bạn phải mở terminal ngay tại dự án của mình. Nếu chưa có dự án, tạo một thư mục trống rồi vào đó.

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

Thay phần đường dẫn bằng thư mục thật của bạn. Kiểm tra Node bằng node --version, kết quả phải từ v20 trở lên.

B.Chạy lệnh init

Đây là lệnh chính của README:

Terminal
npx ruflo@latest init

npx tải Ruflo bản mới nhất rồi chạy lệnh init. Lệnh này thêm agent, hook, bộ nhớ và MCP server vào dự án. Theo bảng so sánh trong README, bạn sẽ thấy trong thư mục các mục như .claude/, .claude-flow/, CLAUDE.md, file helper và file settings. Nếu muốn thiết lập tương tác từng câu hỏi, README có lệnh:

Terminal
npx ruflo@latest init wizard

Nếu dùng Grok Build, README ghi npx ruflo init --grok chỉ ghi file trong dự án, và thêm --dry-run để xem trước mà chưa ghi gì.

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

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

D.Đường khác: chỉ cài plugin trong Claude Code

Đường này không thêm file nào vào dự án, phù hợp để thử trước. Chạy từng dòng bên trong Claude Code (không phải ngoài 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

Dòng đầu thêm “chợ” plugin của Ruflo. Ba dòng install cài phần lõi, bảng điều khiển và mod. /reload-plugins nạp lại, còn /ruflo mở console. Nếu dùng Claude Code 2.1.292 trở lên, README cho phép cài ngay từ terminal:

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

Lưu ý: đường plugin chỉ có slash command, một số skill và định nghĩa agent. README nói đường CLI mới có đủ vòng lặp (98 agent, hook, daemon, MCP server) và là cách dùng thật.

E.Đường khác: nối Codex hoặc MCP client

Trong phần cấu hình MCP server của client, bạn điền 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 để mở MCP server của Ruflo. Mỗi client điền cấu hình một kiểu, README chưa chỉ chi tiết từng client, nên bạn xem tài liệu của client đó.

F.Chạy console trên terminal thường

Console cò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 duy nhất, tiện cho script.

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

Có vài dấu hiệu theo README:

  • Sau npx ruflo@latest init, thư mục dự án có thêm .claude/, .claude-flow/ và CLAUDE.md.
  • Mở lại Claude Code rồi gõ /ruflo: bảng điều khiển hiện ra.
  • Nếu cài bằng plugin, gõ /plugin để xem các mod có nằm trong dòng “active mods” không.
  • Với console độc lập, npx ruflo tui mở giao diện terminal. npx ruflo tui --plain in một khung rồi thoát.

Cách kiểm tra thực tế nhất là giao một việc nhỏ và xem Claude Code có phản hồi theo kiểu có swarm hay không (xem phần tiếp theo). README chưa ghi lệnh “kiểm tra phiên bản” riêng, nên nếu cần hãy xem trong docs/.

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

A.Lập trình viên rà soát một repo cũ

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

Ruflo huy động các agent: tìm module rủi ro nhất, viết test cho nó, rồi tóm tắt những gì đã đổi. Bạn nhận một bản tóm tắt và các file test mới để tự đọc lại. Hãy luôn xem kết quả trước khi gộp vào nhánh chính.

Bạn không cần học hết hàng trăm công cụ, cài xong cứ dùng Claude Code như bình thường, phần phối hợp để Ruflo lo.

Ông T

B.Tạo “mission” và giữ quyền kiểm soát

Bạn muốn thử cho Claude thao tác trên console mà vẫn an toàn. Làm theo các bước của README: cài console, mở /ruflo, vào Settings, chọn Claude control rồi chọn write + ask. Sau đó yêu cầu:

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. Kết quả: mục tiêu xuất hiện trong Missions và Overview 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. Muốn dừng, bấm Take back control để Claude mất quyền điều khiển console.

C.Người dùng Codex muốn thêm bộ nhớ và agent

Bạn dùng Codex thay vì Claude Code. Bạn cấu hình MCP client với command npx và arguments như phần cài đặt ở trên. Kết quả là Codex gọi được các công cụ MCP của Ruflo mà bạn không cần tạo file trong dự án. Mức độ công cụ nào hoạt động tốt nhất trên Codex, README chưa nói chi tiết.

D.Theo dõi chi phí khi dùng nhiều agent

Khi cho nhiều agent chạy, hóa đơn token có thể tăng nhanh. README có plugin ruflo-cost-tracker để theo dõi token, đặt ngân sách và nhận cảnh báo chi phí. Bạn cài theo cùng mẫu lệnh của các plugin khác trong Claude Code, tức /plugin install tên-plugin@ruflo với tên plugin là ruflo-cost-tracker. Sau đó mở /ruflo để xem token và chi phí cạnh phiên làm việc. Nếu lệnh báo lỗi, xem lại danh sách plugin trong /ruflo market, nơi README nói liệt kê mọi plugin, mod và skill kèm nút cài, bật, tắt, cập nhật.

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

A.Báo lỗi hoặc không chạy do Node cũ

Repo yêu cầu Node từ 20 trở lên. Chạy node --version; nếu thấp hơn, cập nhật Node rồi chạy lại npx ruflo@latest init.

B.Cài xong mà Claude Code không thấy gì

Claude Code chỉ nhận agent, hook và MCP server ở lần khởi động tiếp theo. Hãy đóng hẳn rồi mở lại trong đúng thư mục đã chạy init. Nếu đi đường plugin, thử /reload-plugins.

C.Lệnh plugin không có hoặc bị từ chối

Đườ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). Hãy cập nhật Claude Code trước. Nhớ gõ các lệnh /plugin ... bên trong Claude Code, không gõ vào terminal thường.

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 duy nhất. Cài từ cả hai nơi thì mod và lệnh bị nạp đôi. Nếu thấy lệnh lặp, gỡ một bản.

E.Tên công cụ MCP khác với tài liệu

Với plugin ruflo-core, công cụ có tên dạng mcp__plugin_ruflo-core_ruflo__memory_store, khác với tên ngắn như memory_store của đường CLI. Đó là bình thường, hai đường dùng tên khác nhau. Muốn đúng như tài liệu thì dùng đường CLI.

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

Điểm mạnh: cài một lệnh; giữ được bộ nhớ giữa các phiên; có nhiều plugin sẵn; có bảng điều khiển để xem agent làm gì và tốn bao nhiêu; có cơ chế phân quyền rõ cho phần Claude điều khiển console; giấy phép MIT; repo vẫn được cập nhật trong vài tháng gần đây.

Giới hạn: hệ thống rất lớn, dễ khiến người mới choáng. README tự thừa nhận một số video minh họa dùng dữ liệu mẫu và không chứng minh việc swarm hoàn thành công việc thật hay việc nhớ lại bộ nhớ. Vài phần như phần học liên tục chỉ là sơ đồ khái niệm. Yêu cầu hệ điều hành, key và phần cứng chưa rõ trong phần README mình có. Ngoài ra bạn vẫn phải tự kiểm tra kết quả agent làm ra.

Nên chọn cách khác khi: bạn chỉ cần Claude Code làm vài việc nhỏ, hoặc không muốn có thêm thư mục và hook trong dự án. Khi đó đường plugin hoặc dùng Claude Code thuần là đủ. Còn nếu bạn làm dự án lớn, nhiều việc lặp lại và muốn có bộ nhớ, bảng điều khiển, theo dõi chi phí thì Ruflo đáng thử, nhất là trên một dự án thử trước khi áp dụng thật.

4.9/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 chạy bên cạnh Claude Code hoặc Codex, và chi phí của các dịch vụ AI đó tính theo cách của từng nhà cung cấp. Tư liệu mình có không nêu giá.

Cần cài những gì trước khi dùng Ruflo?

Bạn cần Node.js từ phiên bản 20 trở lên. Nếu dùng đường plugin thì cần Claude Code 2.1.287 trở lên. Có Codex hoặc MCP client khác cũng dùng được qua lệnh npx -y ruflo@latest mcp start.

Ruflo cài như thế nào cho nhanh nhất?

Mở terminal trong thư mục dự án và chạy npx ruflo@latest init. Sau đó mở lại Claude Code trong cùng thư mục để nó nhận agent, hook, bộ nhớ và MCP server. Nếu muốn trả lời câu hỏi từng bước, dùng npx ruflo@latest init wizard.

Cài plugin và chạy init khác nhau chỗ nào?

Plugin Claude Code không thêm file nào vào dự án, chỉ cho slash command, vài skill và định nghĩa agent. Chạy init thêm .claude/, .claude-flow/, CLAUDE.md, hook, daemon và MCP server, và theo README đây là cách dùng đầy đủ.

Ruflo có cho phép AI tự làm mọi thứ không, có an toàn không?

Với console, Claude chỉ làm trong mức quyền bạn đặt (read, write, manage, full), mặc định là read + ask. Hành động liên quan mạng, chi tiêu và phá hủy vẫn cần bạn xác nhận, kể cả ở chế độ auto. Riêng mod và plugin 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ó chạy được trên Windows hoặc cần GPU không?

Tư liệu mình có không nói rõ về hệ điều hành hay yêu cầu GPU. Một plugin trong danh sách (ruflo-ruvector) có nhắc tìm kiếm tăng tốc GPU, nhưng không nói là bắt buộc. Bạn nên xem README.md và docs/ trong repo để chắc chắn.

Ruflo có dùng được với Codex không?

Có. README nói Codex và các MCP client khác hoạt động bằng cách trỏ tới lệnh npx -y ruflo@latest mcp start. Cách điền cấu hình cụ thể phụ thuộc vào từng client.

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.Mở lại Claude Code trong cùng thư mục
    4. D.Đường khác: chỉ cài plugin trong Claude Code
    5. E.Đường khác: nối Codex hoặc MCP client
    6. F.Chạy console trên 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 rà soát một repo cũ
    2. B.Tạo “mission” và giữ quyền kiểm soát
    3. C.Người dùng Codex muốn thêm bộ nhớ và agent
    4. D.Theo dõi chi phí khi dùng nhiều agent
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo lỗi hoặc không chạy do Node cũ
    2. B.Cài xong mà Claude Code không thấy gì
    3. C.Lệnh plugin không có hoặc bị từ chối
    4. D.Plugin bị nạp hai lần
    5. E.Tên công cụ MCP khác với tài liệu
  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ỏ.