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 là một agent harness (lớp điều phối) mã nguồn mở giấy phép MIT, đặt quanh Claude Code và Codex để chạy nhiều agent phối hợp, có bộ nhớ qua các phiên làm việc. Cài nhanh nhất 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ông khó, nhưng repo có rất nhiều thành phần nên bạn nên bắt đầu từ lệnh init rồi dùng Claude Code như bình thường.

Ruflo là một "agent meta-harness" cho Claude Code và Codex. Nói dễ hiểu: AI viết code là phần "model", còn Ruflo là phần "bàn làm việc" bao quanh nó, gồm công cụ, bộ nhớ, vòng lặp và các giới hạn kiểm soát để AI làm việc có tổ chức hơn. Repo này trước đây có tên Claude Flow, hiện có khoảng 81.588 sao và 9.608 fork trên GitHub, giấy phép MIT.

Vấn đề nó giải quyết rất thực tế. Khi bạn giao cho một AI một việc lớn, nó hay quên ngữ cảnh giữa các phiên, làm từng việc một, và khó kiểm soát. Ruflo thêm vào Claude Code hơn 100 agent chuyên biệt, cách chia việc cho nhiều agent (gọi là swarm), bộ nhớ lưu lại giữa các lần làm, và một bảng điều khiển để theo dõi. Bạn vẫn làm việc với Claude Code như quen, phần phối hợp chạy ngầm.

Ai nên dùng? Lập trình viên đã dùng Claude Code hoặc Codex và muốn giao việc lớn hơn, như rà soát cả repo hay viết test hàng loạt. Người mới vẫn thử được vì cài chỉ một lệnh. Điểm đáng giá nhất theo mình là bạn không phải học hết hàng trăm công cụ bên trong. README nói rõ: sau init, cứ dùng Claude Code bình thường, hệ thống hook sẽ tự định tuyến tác vụ và phối hợp agent.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối bao quanh Claude Code và Codex: thêm agent, bộ nhớ, hook và bảng điều khiển, cài bằng một lệnh npx.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Repo rất rộng, nên mình chỉ nêu những phần có lợi ích rõ nhất.

  • Chia việc cho nhiều agent (swarm). Thay vì một AI làm tuần tự, bạn có thể yêu cầu cả một nhóm agent cùng xử lý một nhiệm vụ. README mô tả luồng: bạn → Ruflo (CLI/MCP) → bộ định tuyến → swarm → agent → bộ nhớ → nhà cung cấp mô hình AI.
  • Bộ nhớ qua các phiên. Agent ghi nhớ kinh nghiệm và dùng lại, nên lần sau không phải giải thích từ đầu. README ghi phần truy xuất vector cục bộ có thể chạy 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 khi cài, hook tự định tuyến tác vụ và học từ những mẫu làm thành công, bạn không phải gọi từng công cụ.
  • Bảng điều khiển (console). Hiển thị workflow, agent, model, token và chi phí ngay cạnh Claude Code. Bạn có thể mở log của từng agent, tìm kiếm, xem lại các lần chạy lỗi. Có cả chế độ chạy riêng trong terminal bằng npx ruflo tui.
  • 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, bạn chọn mức 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 thao tác liên quan mạng, chi tiêu hoặc phá huỷ vẫn phải xác nhận kể cả ở chế độ auto.
  • Kho plugin. README liệt kê 48 plugin, 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 test còn thiếu và tạo 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ể giao tiếp an toàn với nhau. Phần này nâng cao, người mới chưa cần.
  • Hỗ trợ nhiều công cụ. Ngoài Claude Code, README nói Codex và các MCP client khác dùng được, và có lệnh npx ruflo init --grok cho Grok Build.

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

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

  • Node.js từ phiên bản 20.0.0 trở lên. Đây là yêu cầu trong package.json. Lệnh npx đi kèm Node.
  • Claude Code nếu bạn đi đường cài vào dự án hoặc đường plugin. Với đường chỉ cài plugin, README yêu cầu Claude Code 2.1.287 trở lên. Lệnh cài plugin từ terminal (claude plugin install...) cần Claude Code 2.1.292 trở lên.
  • Hoặc Codex / một MCP client khác nếu bạn không dùng Claude Code.
  • Một thư mục dự án để chạy init.

Tư liệu mình có không nói rõ về hệ điều hành, yêu cầu GPU hay API key riêng cho Ruflo. Vì Ruflo bao quanh Claude Code hoặc Codex, bạn cần đã đăng nhập và dùng được công cụ đó. Chi tiết thêm bạn xem phần hướng dẫn người dùng trong thư mục docs/ của repo.

Các mod của Ruflo chạy với quyền tài khoản của bạn và không bị đóng khung sandbox. README khuyên đọc code trước khi cài. Ngoài ra hãy để Claude control ở mức read + ask khi mới thử, và chỉ nâng quyền khi bạn đã hiểu mình đang cho phép điều gì.

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

README đưa ra ba đường cài. Đường chính là một lệnh npx. Mình tóm tắt trước, rồi đi từng bước.

  1. Mở terminal đúng thư mụcVào thư mục dự án của bạn
  2. Chạy initMột lệnh npx thêm agent, hook, bộ nhớ và MCP server vào dự án
  3. Khởi động lại Claude CodeĐể nó nhận các thành phần mới
  4. Giao thử một việc thậtDùng câu lệnh mẫu trong README
  5. (Tuỳ chọn) Cài bảng điều khiểnQua plugin hoặc chạy `npx ruflo tui`

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 trước khi chạy. Nếu dự án trên GitHub, bạn có thể tải về trước:

Terminal
git clone https://github.com/<tài-khoản>/<dự-án-của-bạn>.git
cd <dự-án-của-bạn>

Thay phần trong dấu <> bằng dự án của bạn. Nếu đã có thư mục dự án sẵn thì chỉ cần cd vào đó.

B.Chạy lệnh init

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

Terminal
npx ruflo@latest init

npx tải Ruflo bản mới nhất và chạy ngay, không cần cài toàn cục. Lệnh init thêm vào dự án các agent, hook, bộ nhớ và MCP server. README cho biết đường này tạo thêm các mục như .claude/, .claude-flow/, CLAUDE.md, file hỗ trợ và settings trong thư mục làm việc. Vì vậy hãy thử trên dự án có Git để xem thay đổi dễ hơn.

Nếu muốn thiết lập có hướng dẫn từng câu hỏi, README có lệnh:

Terminal
npx ruflo@latest init wizard

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

Claude Code sẽ nhận các thành phần Ruflo ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn Claude Code, hãy thoát ra và mở lại trong đúng thư mục đó. Sau đó thử giao một việc thật bằng câu lệnh mẫu ở phần "Dùng vào việc thật" bên dưới.

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

Nếu bạn không muốn thêm file nào vào dự án, README có đường plugin (số file thêm vào workspace là không). 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

Các lệnh này lần lượt thêm kho plugin, cài phần lõi, bảng điều khiển và mod, nạp lại plugin, rồi mở bảng điều khiển bằng /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

Lưu ý README so sánh hai đường: plugin chỉ cho lệnh gạch chéo, một ít skill và định nghĩa agent. Còn npx ruflo init mới cho vòng lặp đầy đủ gồm 98 agent, hơn 60 lệnh, 30 skill, MCP server, hook và daemon. Nếu muốn dùng thật thì chọn đường init.

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

Không cần cài vào dự án. Bạn cấu hình trong client của mình: command là npx, arguments là:

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. Chỗ điền cấu hình này nằm ở phần cài MCP server của từng client, bạn xem tài liệu của client đó.

F.Chạy bảng điều khiển trong terminal thường

Không có Claude Code vẫn xem được console:

Terminal
npx ruflo tui

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

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

Theo README, có vài dấu hiệu để biết cài thành công:

  1. Sau npx ruflo@latest init, thư mục dự án có thêm các mục như .claude/, .claude-flow/ và CLAUDE.md.
  2. Mở lại Claude Code trong thư mục đó rồi gõ /ruflo. Nếu bảng điều khiển hiện ra là console đã chạy.
  3. Với đường plugin, mở /plugin và xem các mod có xuất hiện trong dòng "active mods" không.
  4. Chạy npx ruflo tui: nếu giao diện terminal hiện lên thì Ruflo chạy độc lập tốt.

Cách kiểm tra chắc nhất là giao một việc nhỏ ở phần dưới và xem agent có phản hồi, ghi nhận hành động trong console hay không.

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

Các tình huống dưới đây bám theo những gì README mô tả.

A.Rà soát một repo bằng swarm

Bối cảnh: bạn là lập trình viên vừa nhận một dự án cũ, chưa 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 trong 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: Claude Code dùng nhóm agent để 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 các file test mới được thêm trước khi giữ lại.

Bạn không cần học hết hàng trăm công cụ. Chạy init, rồi cứ giao việc cho Claude Code như thường.

Ông T

B.Tạo một "mission" và theo dõi trong bảng điều khiển

Bối cảnh: bạn là chủ sản phẩm muốn thử xem Claude thao tác bảng điều khiển ra sao mà vẫn nắm quyền. README hướng dẫn: cài console, mở /ruflo, 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 đang chờ. Kết quả: mục tiêu xuất hiện trong Missions, và Overview ghi lại hành động. Cần nhớ: tạo mission không có nghĩa là tính năng đã được viết. Nếu muốn dừng, bấm Take back control và các lệnh gọi sau đó sẽ bị từ chối cho đến khi bạn trả quyền lại.

C.Dùng Ruflo từ Codex hoặc công cụ MCP khác

Bối cảnh: nhóm của bạn dùng Codex thay vì Claude Code. Bạn không cần đổi công cụ, chỉ cần khai báo MCP server như phần cài đặt ở trên (command npx, arguments ["-y", "ruflo@latest", "mcp", "start"]). Từ đó công cụ của bạn gọi được các tính năng điều phối và bộ nhớ của Ruflo. Kết quả là bạn có cùng lớp điều phối mà không phải thay môi trường làm việc quen thuộc.

D.Thử từng plugin nhỏ trước khi cam kết

Bối cảnh: bạn chỉ cần một việc, ví dụ sinh test còn thiếu hoặc theo dõi chi phí token, và không muốn thêm file vào dự án. Bạn thêm kho plugin rồi cài đúng plugin cần, theo mẫu README (ruflo-testgen và ruflo-cost-tracker có trong danh sách plugin, cú pháp cài giống các plugin khác):

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

Sau /reload-plugins, các lệnh gạch chéo của plugin sẵn sàng dùng. Trong console, /ruflo market mở Plugin Catalog, nơi 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 bạn trước.

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

Lệnh npx báo lỗi hoặc chạy không nổi. Nguyên nhân thường là Node cũ. Repo yêu cầu Node từ 20.0.0. Chạy node --version để kiểm tra, nếu thấp hơn thì nâng cấp Node rồi chạy lại.

Cài xong nhưng Claude Code không thấy gì mới. README nói Claude Code nhận thành phần ở lần khởi động kế tiếp. Hãy thoát hẳn và mở lại trong đúng thư mục đã chạy init. Với plugin, chạy /reload-plugins.

Lệnh /plugin install không chạy hoặc không nhận cờ. Đường plugin cần Claude Code 2.1.287 trở lên, và lệnh claude plugin install... --marketplace cần 2.1.292 trở lên. Hãy cập nhật Claude Code trước.

Gọi công cụ mà không thấy đúng tên. README giải thích hai đường cài dùng tên công cụ khác nhau. Plugin ruflo-core đăng ký công cụ dạng mcp__plugin_ruflo-core_ruflo__*, còn đường CLI dùng tên không có tiền tố. Nếu bạn làm theo hướng một trang tin tức cho đường kia thì tên sẽ lệch. Hãy chọn một đường và bám theo nó.

Plugin bị nạp hai lần. Với các plugin ngoài như agentic-qe-fleet, agentdb hay agentic-flow, README cảnh báo chỉ cài từ một kho duy nhất. Bật từ cả hai kho thì mod và lệnh sẽ nạp đôi.

Một điều nữa: vì init thêm file vào dự án, hãy chạy trên nhánh Git riêng để dễ xem và hoàn tác nếu cần.

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

Điểm mạnh. Cài một lệnh, có sẵn rất nhiều thứ (agent, bộ nhớ, bảng điều khiển, kho plugin), giấy phép MIT, và repo vẫn được cập nhật trong vài tháng gần đây. Cơ chế phân quyền cho Claude control (read/write/manage/full, ask/auto) cho bạn nắm quyền rõ ràng. Hỗ trợ cả Claude Code lẫn Codex và MCP client khác cũng là điểm cộng.

Giới hạn. Repo khá đồ sộ: README nhắc tới 406 công cụ MCP, 61 lệnh CLI và 48 plugin, nên dễ choáng nếu muốn hiểu hết. Chính README cũng lưu ý một số demo dùng dữ liệu mẫu và không chứng minh swarm đã hoàn thành việc thật hay bộ nhớ đã được gợi lại, nên bạn nên tự thử trên việc của mình. Các mod không chạy trong sandbox. Tư liệu mình có chưa nói rõ chi phí dùng mô hình AI phía dưới, nên bạn nên theo dõi token trong console.

Khi nào chọn cách khác. Nếu bạn chỉ cần một AI viết code cho việc nhỏ lẻ, Claude Code hoặc Codex đứng một mình là đủ, thêm một lớp điều phối sẽ thừa. Nếu bạn làm việc trong môi trường cần kiểm soát chặt, hãy đọc kỹ tài liệu bảo mật của repo (có file SECURITY.md) trước khi bật quyền cao. Còn nếu bạn hay giao việc lớn, nhiều bước cho AI và muốn nó nhớ qua các phiên, Ruflo đáng để thử trên một dự án nhỏ trước.

4.7/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à tự do sử dụng. Tuy nhiên Ruflo bao quanh Claude Code hoặc Codex, nên chi phí dùng các mô hình AI phía dưới là chuyện riêng của tài khoản bạn. Tư liệu chưa có thông tin chi tiết về giá, bạn có thể theo dõi token và chi phí trong bảng điều khiển.

Cài Ruflo cần phiên bản Node nào?

File package.json yêu cầu Node từ 20.0.0 trở lên. Bạn chạy `node --version` để kiểm tra trước khi chạy `npx ruflo@latest init`.

Dùng Ruflo có bắt buộc phải có Claude Code không?

Không bắt buộc. README nói Codex và các MCP client khác cũng dùng được bằng cách cấu hình command `npx` với arguments `["-y", "ruflo@latest", "mcp", "start"]`. Bạn cũng có thể chạy bảng điều khiển riêng bằng `npx ruflo tui`.

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

Theo README, Ruflo là lớp harness thêm hơn 100 agent chuyên biệt, swarm phối hợp, bộ nhớ qua các phiên, hook tự định tuyến và bảng điều khiển. Claude Code vẫn là nơi bạn làm việc, còn Ruflo lo phần phối hợp chạy ngầm.

Cài đường plugin và đường npx init khác nhau thế nào?

Đường plugin không thêm file nào vào dự án và chỉ cho lệnh gạch chéo, vài skill và định nghĩa agent. Đường `npx ruflo init` cho vòng lặp đầy đủ gồm MCP server, hook, daemon, 98 agent, hơn 60 lệnh và 30 skill, nhưng thêm file như `.claude/` và `CLAUDE.md` vào dự án. README gợi ý đường init cho dùng thật.

Cho Claude điều khiển bảng điều khiển có an toàn không?

README mô tả bạn tự chọn 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 liên quan mạng, chi tiêu hoặc phá huỷ vẫn cần xác nhận kể cả ở auto, và nút Take back control dừng ngay. Riêng các mod thì 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.

Ruflo có cần GPU hoặc chạy được trên Windows không?

Tư liệu mình có chưa nói về yêu cầu GPU hay hệ điều hành cụ thể. Điều kiện duy nhất được nêu rõ là Node từ 20.0.0 trở lên. Bạn nên xem tài liệu trong thư mục docs/ của repo để biết thêm.

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ở Claude Code trong cùng thư mục
    4. D.Đường khác: chỉ cài plugin vào Claude Code
    5. E.Đường khác: Codex hoặc MCP client khác
    6. F.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.Rà soát một repo bằng swarm
    2. B.Tạo một "mission" và theo dõi trong bảng điều khiển
    3. C.Dùng Ruflo từ Codex hoặc công cụ MCP khác
    4. D.Thử từng plugin nhỏ 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ỏ.