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

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 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à lớp điều phối quanh Claude Code và Codex: thêm agent, hook, bộ nhớ và máy chủ MCP vào dự án của bạn. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node từ 20 trở lên. Cài không khó, nhưng công cụ rất rộng nên nên bắt đầu từ một việc nhỏ.

Ruflo là một "agent harness", tức bộ khung bao quanh mô hình AI để nó làm việc được như một nhóm. Nó chạy cùng Claude Code và Codex, thêm cho chúng các agent chuyên biệt, bầy agent phối hợp với nhau, bộ nhớ nhớ được giữa các phiên và một máy chủ MCP. Repo này trước đây có tên Claude Flow, hiện có khoảng 81.500 sao và khoảng 9.600 fork trên GitHub, giấy phép MIT.

Nếu bạn đã dùng Claude Code và thấy nó hay "quên" việc cũ, hoặc muốn nhiều agent cùng chia nhau một việc lớn (đọc code, viết test, tóm tắt thay đổi), thì đây là thứ nên thử. Người dùng chính là lập trình viên, kể cả người mới. Người làm văn phòng cũng dùng được nếu đã quen Claude Code.

Điểm đáng giá nhất là cách cài rất ngắn. Một lệnh npx ruflo@latest init trong thư mục dự án là xong phần chính, sau đó bạn cứ dùng Claude Code như bình thường. Tác giả nói các hook sẽ tự định tuyến tác vụ và phối hợp agent ở phía sau, nên bạn không phải học hết hàng trăm công cụ.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) bọc quanh Claude Code và Codex, thêm agent chuyên biệt, bầy agent phối hợp, bộ nhớ dài hạn và công cụ MCP chỉ với một lệnh.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Trước hết, Ruflo không thay Claude Code. Công thức của tác giả là "Agent = Mô hình + Harness": mô hình viết, còn harness cấp công cụ, bộ nhớ, vòng lặp và các lớp kiểm soát để nó làm việc thật. Ruflo là phần harness đó. Dưới đây là các khả năng chính, theo tư liệu.

  • Agent chuyên biệt và bầy agent (swarm). Bản cài bằng CLI đi kèm khoảng 98 agent, hơn 60 lệnh và 30 skill. Lợi ích thực tế là bạn có thể giao một việc như "rà soát repo" cho cả nhóm agent thay vì một agent làm tuần tự.
  • Bộ nhớ và tự học. Agent nhớ giữa các phiên và rút kinh nghiệm từ những lần làm thành công. Tác giả lưu ý đây là vòng học mang tính khái niệm: 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.
  • Máy chủ MCP. Cài xong, Ruflo đăng ký một MCP server nên các công cụ MCP khác, ví dụ Codex, cũng gọi được.
  • Bảng điều khiển (console) ngay cạnh Claude Code. Bạn theo dõi quy trình, agent, mô hình, token và chi phí; xem nhật ký từng lần chạy, tìm kiếm, phát lại và so sánh.
  • Cho Claude điều khiển bảng điều khiển, nhưng bạn đặt giới hạn. Trong Settings → Claude control có bốn mức: read, write, manage, full, kèm chế độ duyệt ask hoặc auto. Mặc định hiện tại là read + ask. Các hành động mạng, tiêu tiền hoặc phá huỷ luôn cần bạn xác nhận, kể cả khi để auto.
  • Hệ plugin lớn. Có khoảng 48 plugin chia theo nhóm: điều phối, bộ nhớ, học máy, kiểm thử, bảo mật, theo dõi chi phí... Ví dụ ruflo-testgen tìm test còn thiếu và tạo 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 dữ liệu cá nhân.
  • Liên kết (federation). Agent trên nhiều máy có thể nói chuyện với nhau mà không lộ dữ liệu. Phần này nâng cao, người mới chưa cần.
  • Nhiều máy khách. Ngoài Claude Code còn có Codex và các máy khách MCP khác. README cũng nhắc đến cờ --grok cho Grok Build.

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

Theo tư liệu, bạn cần những thứ sau:

  • Node.js từ phiên bản 20 trở lên. package.json của gói yêu cầu >=20.0.0. Gói npm tên là claude-flow và cũng có lệnh CLI; README hướng dẫn gọi bằng npx ruflo.
  • Claude Code nếu bạn dùng theo cách chính. Riêng đường cài chỉ bằng plugin thì cần Claude Code 2.1.287 trở lên; lệnh claude plugin install từ terminal cần 2.1.292 trở lên.
  • Một thư mục dự án để chạy init. Lệnh sẽ thêm file vào đó.
  • Codex hoặc máy khách MCP khác chỉ khi bạn muốn dùng thay Claude Code.

Về hệ điều hành, phần README mình có không nêu rõ. Về API key, tài khoản hay phần cứng (GPU), phần README mình có cũng chưa nói. Bạn nên xem tiếp README và thư mục docs/ trong repo. Bạn vẫn cần quyền dùng Claude Code hoặc Codex của chính bạn, vì Ruflo chạy bên cạnh chúng.

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

README có ba đường: cài đầy đủ vào dự án bằng init (khuyên dùng), cài chỉ plugin cho Claude Code, và nối với Codex hoặc máy khách MCP. Bắt đầu bằng đường đầu tiên.

  1. Mở terminal đúng thư mụcVào thư mục dự án bạn muốn Ruflo hỗ trợ
  2. Chạy initGõ npx ruflo@latest init để thêm agent, hook, bộ nhớ và MCP server
  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 việc thửCho Claude Code một việc thật, có nhắc "ruflo swarm"
  5. (Tuỳ chọn) Cài plugin hoặc nối CodexDùng lệnh /plugin hoặc cấu hình MCP

A.Mở terminal ở 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 đang đứng, nên bạn phải mở terminal trong thư mục dự án của mình, không phải thư mục người dùng hay màn hình nền. Trên Windows, bạn có thể mở thư mục trong File Explorer rồi mở PowerShell từ đó. Cũng nên lưu dự án vào git trước, để dễ xem Ruflo đã thêm gì.

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

Lệnh thứ hai kiểm tra Node. Con số hiện ra phải từ v20 trở lên.

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. Theo bảng so sánh trong README, init thêm vào dự án các mục như .claude/, .claude-flow/, CLAUDE.md, file hỗ trợ và file cài đặt, đồng thời đăng ký MCP server, hook và daemon. Nếu bạn đã có CLAUDE.md riêng, hãy sao lưu trước khi chạy.

Nếu muốn được hỏi từng bước để thiết lập dự án, README cũng có lệnh:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code và giao việc đầu tiên

Sau init, bạn 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. Nếu Claude Code đang mở sẵn, hãy thoát rồi mở lại.

Rồi gõ thử câu lệnh mẫu của tác giả:

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

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

Cách này không thêm file nào vào dự án và cần Claude Code 2.1.287 trở lên. Bạn gõ 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 từ terminal:

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

Bản plugin nhẹ hơn: chủ yếu có lệnh gạch chéo và định nghĩa agent, không cài hook. README gợi ý dùng đường init nếu bạn muốn dùng sản xuất và đầy đủ như tài liệu mô tả.

Mod trong Ruflo chạy với quyền tài khoản của bạn và không bị đưa vào sandbox. README khuyên đọc code trước khi cài. Hãy làm đúng như vậy, nhất là khi cài thêm plugin từ nguồn ngoài.

E.Cách khác: nối Codex hoặc máy khách MCP

Không cần cài vào dự án. Bạn cấu hình máy khách với command là npx và arguments như sau:

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

Tên chỗ điền trong phần cấu hình MCP của từng ứng dụng có thể khác nhau, README không chỉ rõ cho từng ứng dụng. Bạn xem tài liệu của máy khách mình dùng.

Còn một cách chạy riêng, không cần Claude Code, để mở bảng điều khiển trong terminal:

Terminal
npx ruflo tui

Thêm --plain sẽ in ra một khung hình cho script.

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

Có vài dấu hiệu dựa trên tư liệu:

  1. Thư mục dự án có file mới. Sau init, bạn nên thấy .claude/, .claude-flow/ và CLAUDE.md.
  2. Lệnh /ruflo mở được bảng điều khiển trong Claude Code. Với đường init, README dặn: chạy npx ruflo init, khởi động lại Claude Code, rồi gõ /ruflo.
  3. Với đường plugin, gõ /plugin để mở danh sách. README nói các mod đã bật sẽ hiện trong dòng "active mods".
  4. Chạy thử npx ruflo tui. Bạn nên thấy giao diện terminal của bảng điều khiển.
  5. Cho một việc nhỏ và xem phản hồi. Dùng câu lệnh mẫu ở trên và theo dõi trong console.

README không đưa ra một đoạn kết quả mẫu chính xác để so sánh từng chữ. Nếu lệnh chạy hết mà không báo lỗi và /ruflo mở được thì có thể xem là thành công.

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 cũ và chưa biết chỗ nào dễ hỏng. Chạy npx ruflo@latest init trong thư mục dự án, mở lại Claude Code rồi gõ đúng câu mẫu của tác giả:

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: các agent chia việc tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã đổi. Hãy đọc kỹ phần thay đổi và chạy test của dự án trước khi giữ lại.

Bạn vẫn viết code. Ruflo lo phần phối hợp.

Ông T

B.Quản lý theo dõi một việc qua bảng điều khiển

Bạn thích nhìn thấy mọi thứ ở một chỗ thay vì đọc nhật ký dài. Cài ruflo-console bằng các lệnh plugin ở trên, 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 sẽ mở mục Missions và đặt mục tiêu. Bạn xác nhận hành động tạo trong console, rồi kiểm tra Missions có mục tiêu và Overview có ghi lại hành động. README nhấn mạnh: tạo mission không có nghĩa là tính năng đã được làm. Nếu muốn dừng, bấm Take back control, và Claude sẽ bị từ chối khi gọi công cụ cho đến khi bạn trả quyền lại.

C.Dùng Codex hoặc công cụ MCP khác mà không đụng vào dự án

Bạn dùng Codex và chưa muốn có thêm file lạ trong repo công ty. Cấu hình máy khách MCP với command npx và các đối số -y, ruflo@latest, mcp, start như phần cài đặt. Khi đó bạn có các công cụ của Ruflo (bộ nhớ, điều phối) mà không cần chạy init. Đổi lại, bạn không có đủ hook và agent như cài đầy đủ.

D.Thử một plugin riêng để làm quen

Bạn là người mới, chỉ muốn thử một thứ và chưa muốn cài cả bộ. Thêm marketplace rồi cài một plugin nhỏ trong Claude Code:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-swarm@ruflo

ruflo-swarm điều phối nhiều agent như một đội. Trong README nó nằm cạnh ruflo-rag-memory (truy xuất thông minh cho bộ nhớ) và ruflo-cost-tracker (theo dõi token, đặt ngân sách). Bạn cài theo cùng một mẫu /plugin install tên@ruflo. Cách này cho lệnh gạch chéo và định nghĩa agent, chưa phải bản đầy đủ.

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

npx báo không tìm thấy lệnh, hoặc lỗi phiên bản. Thường do chưa cài Node hoặc cài bản cũ hơn 20. Chạy node --version để kiểm tra, cài lại Node bản 20 trở lên rồi mở lại terminal.

Claude Code không thấy Ruflo sau khi init. README nói Claude Code nhận cấu hình ở lần khởi động tiếp theo. Hãy thoát hẳn, mở lại trong đúng thư mục bạn đã chạy init, rồi thử /ruflo.

Lệnh /plugin ... không được nhận. Có thể Claude Code của bạn cũ. Đường plugin cần 2.1.287 trở lên (lệnh claude plugin install từ terminal cần 2.1.292 trở lên). Cập nhật Claude Code rồi chạy /reload-plugins.

Cài trùng một plugin từ hai marketplace. README cảnh báo với các plugin ngoài như agentdb, agentic-flow, agentic-qe-fleet: nếu bật từ cả hai nơi, mod và lệnh sẽ nạp hai lần. Chỉ cài từ một marketplace.

Claude bị từ chối khi thao tác trên console. Mặc định là read + ask, nên hành động ghi bị chặn. Đây là thiết kế an toàn. Nếu cần, nâng mức trong Settings → Claude control, nhưng hãy giữ chế độ ask để tự duyệt từng hành động.

Dự án có thêm nhiều file lạ. Đó là hành vi của init. Nên commit trước khi chạy để xem và hoàn tác được. Nếu chỉ muốn thử, dùng đường plugin, vốn không thêm file nào vào dự án.

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

Điểm mạnh. Cài nhanh bằng một lệnh. Có sẵn nhiều agent, bộ nhớ, bảng điều khiển và hệ plugin rộng. Giấy phép MIT, repo còn được cập nhật trong vài tháng gần đây. Cơ chế phân quyền cho Claude điều khiển console khá cẩn thận.

Giới hạn. Công cụ rất rộng (hàng trăm công cụ MCP, nhiều lệnh CLI), nên người mới dễ choáng. README có tách rõ các đoạn mô phỏng, hoạt ảnh mẫu với những gì đã được chứng minh bằng một lần chạy thật, và mình cũng khuyên bạn đừng xem demo là bằng chứng việc đã hoàn thành. Phần học tự động chỉ là mô hình khái niệm. Chi phí AI vẫn phát sinh theo tài khoản bạn dùng với Claude Code hoặc Codex. Tư liệu mình có chưa nói rõ về hệ điều hành hỗ trợ hay yêu cầu phần cứng.

Khi nên chọn cách khác. Nếu bạn chỉ cần một agent làm một việc nhỏ, Claude Code hoặc Codex đứng một mình là đủ. Nếu không muốn thêm file vào dự án, dùng đường plugin hoặc chỉ nối MCP. Nếu bạn cần công cụ nhỏ, dễ hiểu từng dòng, hãy cân nhắc một plugin riêng thay vì cả bộ.

Cách bắt đầu hợp lý: cài init vào một dự án thử, giao đúng một việc, đọc kỹ kết quả, rồi mới thêm plugin khi bạn thấy cần.

3.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 bạn dùng, sửa và chia sẻ thoải mái. Tuy nhiên Ruflo chạy cùng Claude Code hoặc Codex, nên chi phí dùng các dịch vụ AI đó vẫn tính theo tài khoản của bạn. README có plugin theo dõi token và đặt ngân sách là `ruflo-cost-tracker`.

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

Trong thư mục dự án, chạy `npx ruflo@latest init`, rồi mở lại Claude Code trong cùng thư mục. Nếu chỉ muốn plugin, dùng `/plugin marketplace add ruvnet/ruflo` rồi `/plugin install ruflo-core@ruflo` bên trong Claude Code. Gói cần Node từ phiên bản 20 trở lên.

Ruflo có cần GPU không?

Tư liệu mình có chưa nói yêu cầu GPU. Một plugin trong danh sách (`ruflo-ruvector`) được mô tả là tìm kiếm có tăng tốc GPU, nhưng không thấy ghi là bắt buộc. Bạn nên xem README đầy đủ và thư mục docs trong repo.

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

Phần README mình có chưa nói rõ về hệ điều hành. Điều chắc chắn là cần Node 20 trở lên và lệnh `npx`. Nếu bạn dùng Windows, hãy thử trên một dự án nhỏ trước và xem tài liệu trong repo.

Dữ liệu của mình có an toàn không?

README nêu các lớp bảo vệ: Claude control mặc định chỉ đọc và hỏi trước (read + ask), còn hành động mạng, tiêu tiền, phá huỷ luôn cần xác nhận. Tuy vậy 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 code trước khi cài. Với dữ liệu nhạy cảm, bạn nên tự xem kỹ SECURITY.md trong repo.

Ruflo khác gì Claude Code thông thường?

Claude Code là công cụ viết code bằng AI. Ruflo là lớp bọc thêm quanh nó: nhiều agent chuyên biệt, bầy agent phối hợp, bộ nhớ qua nhiều phiên, hook, bảng điều khiển và máy chủ MCP. Bạn vẫn dùng Claude Code như bình thường, phần điều phối chạy ở phía sau.

Dùng với Codex hay ChatGPT được không?

Codex và các máy khách MCP khác dùng được: cấu hình command `npx` với đối số `-y`, `ruflo@latest`, `mcp`, `start`. README cũng có mục tuỳ chọn ruOS Desktop để nối ChatGPT hoặc Claude qua một địa chỉ MCP. Chi tiết từng ứng dụng chưa có trong phần README mình đọc.

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 ở thư mục dự án
    2. B.Chạy lệnh init
    3. C.Mở lại Claude Code và giao việc đầu tiên
    4. D.Cách khác: cài chỉ plugin cho Claude Code
    5. E.Cách khác: nối Codex hoặc máy khách MCP
  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.Quản lý theo dõi một việc qua bảng điều khiển
    3. C.Dùng Codex hoặc công cụ MCP khác mà không đụng vào dự án
    4. D.Thử một plugin riêng để làm quen
  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ỏ.