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

Ruflo: điều phối nhóm AI agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng

12 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 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à một “harness” cho Claude Code và Codex. Nó thêm các agent chuyên biệt, bộ nhớ dùng lại giữa các phiên, hook và MCP server để nhiều agent phối hợp làm việc. Cài khá dễ: chỉ cần Node 20 trở lên và chạy một lệnh `npx ruflo@latest init` trong thư mục dự án.

Ruflo là một “harness” (bộ khung điều khiển) bọc quanh Claude Code và Codex. Mô hình AI chỉ viết code. Harness cấp thêm công cụ, bộ nhớ, vòng lặp làm việc và các lớp kiểm soát để AI làm được việc dài hơi. Ruflo nằm ở lớp đó. Repo này trước đây có tên Claude Flow.

Nếu bạn đang dùng Claude Code và thấy mỗi phiên làm việc lại phải giải thích từ đầu, Ruflo đáng thử. Nó gắn thêm nhiều agent chuyên biệt, bộ nhớ giữ lại giữa các phiên, và cách chia việc cho nhiều agent cùng làm (README gọi là “swarm”). 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.

Điểm đáng giá nhất là cách cài đơn giản. Một lệnh npx ruflo@latest init trong thư mục dự án là xong phần chuẩn bị. Sau đó bạn mở Claude Code và dùng như bình thường. README nói rằng bạn không cần học hết hàng trăm công cụ MCP hay các lệnh CLI, vì hệ thống hook tự định tuyến tác vụ ở phía sau.

Framework

ruvnet/ruflo

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

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là các tính năng chính, mình tóm theo lợi ích thực tế khi dùng.

  • Nhiều agent làm việc như một nhóm. Thay vì một AI làm tất cả, Ruflo chia việc cho nhiều agent chuyên biệt rồi gom kết quả lại. Với việc lớn như rà soát cả một repo, cách này gọn hơn nhiều so với một cuộc hội thoại dài.
  • Bộ nhớ dùng lại giữa các phiên. README mô tả bộ nhớ có tìm kiếm bằng vector, để agent nhớ được kinh nghiệm từ các việc đã làm. Bạn đỡ phải nhắc lại cùng một bối cảnh.
  • Tự học từ việc đã làm. Kinh nghiệm thành công được đưa ngược lại vào bước định tuyến tác vụ. README nói rõ đây là mô hình khái niệm. 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 cấu hình.
  • Giao diện “buồng lái” (console). Bạn xem được workflow, agent, model, token và chi phí ngay cạnh Claude Code. Bạn cũng xem lại được log và kết quả từng lần chạy, tìm lỗi, phát lại và so sánh.
  • Cho Claude điều khiển console nhưng có giới hạn. Trong Settings → Claude control, bạn chọn mức quyền read, write, manage hoặc full, và chọn hỏi trước (ask) hoặc tự chạy (auto). Mặc định là read + ask. Các hành động 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à các nhóm khác. Ví dụ ruflo-testgen tìm chỗ thiếu test và sinh test, ruflo-cost-tracker theo dõi token và đặt ngân sách, ruflo-security-audit quét lỗ hổng.
  • Dùng được với Codex và client MCP khác. Bạn chỉ cần trỏ client tới npx -y ruflo@latest mcp start.
  • Liên kết giữa các máy (federation). Agent trên các máy khác nhau phối hợp được với nhau. Người mới có thể bỏ qua phần này ở giai đoạn đầu.

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

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

  • Node.js từ 20.0.0 trở lên. Đây là yêu cầu trong package.json. Lệnh npx đi kèm Node nên bạn không cần cài thêm gì.
  • Claude Code, nếu bạn muốn dùng theo cách chính. Nếu cài theo đường plugin thì cần Claude Code 2.1.287 trở lên. Lệnh claude plugin install ngoài terminal cần 2.1.292 trở lên.
  • Một thư mục dự án để chạy init.
  • Codex hoặc client MCP khác nếu bạn không dùng Claude Code.

Còn một số điều README (phần mình có) chưa nói rõ: hệ điều hành nào được hỗ trợ chính thức, yêu cầu phần cứng, và cần API key của nhà cung cấp nào. Bạn nên xem README gốc và thư mục docs/ trong repo trước khi dùng vào việc quan trọng.

Mod của Ruflo chạy với quyền tài khoản của bạn và không được đặt trong sandbox. README khuyên đọc code trước khi cài. Với tính năng Claude control, hãy để mức mặc định (read + ask) cho đến khi bạn hiểu rõ nó làm gì.

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

  1. Mở terminalVào đúng 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. Mở lại Claude CodeKhởi động Claude Code trong cùng thư mục để nó nhận cấu hình mới
  4. Giao một việc thậtDán một câu lệnh mẫu để thử swarm
  5. Tuỳ chọn: cài plugin hoặc MCPChọn đường khác nếu không muốn thêm file vào dự án

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

Lỗi hay gặp nhất của người mới là chạy lệnh sai chỗ. Bạn cần đứng trong thư mục dự án mà bạn muốn Ruflo hỗ trợ. Trên Windows, bạn có thể mở thư mục đó trong File Explorer, gõ cmd hoặc powershell lên thanh địa chỉ rồi Enter. Hoặc dùng terminal tích hợp của VS Code.

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

Hãy thay duong-dan-toi-du-an-cua-ban bằng đường dẫn thật của bạn. Đây chỉ là lệnh cd thông thường.

B.Chạy lệnh init

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

Terminal
npx ruflo@latest init

npx tải bản Ruflo mới nhất rồi chạy init. Theo README, init thêm agent, hook, bộ nhớ và MCP server vào dự án. Bảng so sánh trong README cho biết cách này tạo thêm các thư mục và file như .claude/, .claude-flow/, CLAUDE.md và một số file phụ trợ trong dự án. Nếu thư mục của bạn đang quản lý bằng Git, bạn nên commit trước khi chạy để dễ xem những gì vừa được thêm.

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ở lại Claude Code và giao việc

Sau init, bạn mở Claude Code trong cùng thư mục. README nói Claude Code sẽ nhận các thành phần này ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn Claude Code, hãy thoát rồi mở lại. Sau đó thử một việc thật, ví dụ 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.

Câu này nhờ Ruflo rà soát repo, tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã đổi. Bạn có thể viết bằng tiếng Việt theo ý mình. Câu tiếng Anh ở trên là bản gốc của README.

D.Cách khác: cài bằng plugin, không thêm file vào dự án

Nếu bạn chưa muốn thêm file vào dự án, README có đường plugin. Đường này cài công cụ lõi, console và mod, và không thêm file nào vào dự án. Bạn cần Claude Code 2.1.287 trở lê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 thêm kho plugin của Ruflo, cài ba plugin, nạp lại plugin, rồi mở console bằng /ruflo. Nếu dùng Claude Code 2.1.292 trở lên, bạn cũng có thể cài từ terminal:

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

Lưu ý từ README: cách plugin chỉ cho một phần chức năng (lệnh gạch chéo, một số skill, định nghĩa agent). Muốn có đầy đủ vòng làm việc (agent, hook, daemon, MCP server) thì dùng npx ruflo@latest init.

E.Cách khác: dùng với Codex hoặc client MCP khác

Với Codex hoặc bất kỳ client MCP nào, bạn cấu hình command là npx và arguments là:

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

Cách điền cụ thể tuỳ từng client, nên bạn xem tài liệu của client đó để biết điền vào đâu. README chỉ nêu hai giá trị này.

F.Chạy giao diện terminal riêng

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

Terminal
npx ruflo tui

Thêm --plain nếu bạn muốn in ra một khung hình duy nhất để dùng trong script.

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

README không đưa ra một lệnh kiểm tra duy nhất, nhưng có vài dấu hiệu bạn có thể dựa vào:

  • Sau init: trong thư mục dự án xuất hiện các thư mục như .claude/ và .claude-flow/ cùng file CLAUDE.md, theo bảng so sánh của README.
  • Sau khi mở lại Claude Code: gõ /ruflo. README nói bạn sẽ thấy console. Hướng dẫn trong README là chạy npx ruflo init, khởi động lại Claude Code rồi gõ /ruflo.
  • Với đường plugin: mở /plugin và kiểm tra các mod xuất hiện trong dòng “active mods”.
  • Với giao diện riêng: npx ruflo tui mở được console ngay trong terminal.

Chưa thấy gì? Hãy xem phần lỗi thường gặp bên dưới.

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

Các tình huống dưới đây bám vào khả năng README mô tả. Các câu lệnh mẫu mình tự viết theo ý của README, không phải lệnh chính thức. Kết quả thực tế sẽ khác tuỳ dự án và tuỳ model bạn dùng.

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

Bạn nhận lại một repo của đồng nghiệp đã nghỉ, chưa có test và không ai nhớ module nào dễ hỏng. Sau khi chạy init và mở lại Claude Code, bạn dán 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.

Bạn nhận được: một nhận định về module rủi ro nhất, các bài test mới cho module đó và bản tóm tắt thay đổi. Hãy đọc kỹ test do AI viết và tự chạy lại trước khi gộp vào nhánh chính.

Agent = Model + Harness. Model viết code, còn harness cho nó công cụ, bộ nhớ và giới hạn để làm việc thật.

Ông T

B.Người mới muốn xem agent đang làm gì

Bạn là người mới, giao việc cho AI nhưng không biết nó làm gì phía sau. Bạn cài console theo đường plugin rồi gõ /ruflo. Trong console, bạn xem được workflow, agent, token và chi phí bên cạnh Claude Code. Khi có việc lỗi, bạn mở log, tìm kiếm, phát lại hoặc so sánh các lần chạy.

Bạn nhận được: nhìn rõ agent nào đang làm gì và tốn bao nhiêu token, thay vì chờ kết quả cuối cùng. Với người đang lo chi phí, đây là điểm đáng dùng nhất.

C.Nhờ Claude tạo “mission” trong console, có kiểm soát

README có một bài tập khá an toàn để làm quen. Các bước như sau:

  1. Cài console bằng các lệnh plugin ở trên, mở /ruflo, vào Settings → Claude control và chọn write + ask.
  2. Nói với Claude: “Create a mission to add a dark mode toggle. Show me the mission and its status.”
  3. Claude mở mục Missions và đặt mục tiêu. Bạn xác nhận thao tác tạo đang chờ trong console.
  4. Kiểm tra mục Missions có mục tiêu mới và Overview có ghi lại hành động.
  5. Muốn dừng, bấm Take back control. Từ lúc đó mọi lời gọi công cụ console của Claude sẽ bị từ chối cho đến khi bạn trả quyền lại.

README nhắc rõ: tạo mission không có nghĩa tính năng đã được làm xong. Bài tập này giúp bạn hiểu cách đặt giới hạn cho AI trước khi giao việc lớn hơn.

D.Chạy tự động trong script hoặc trên Codex

Nếu bạn dùng Codex, hoặc có công cụ riêng hỗ trợ MCP, bạn trỏ nó tới npx -y ruflo@latest mcp start để dùng cùng bộ công cụ mà không cần Claude Code. Với việc cần in trạng thái ra file hoặc log, npx ruflo tui --plain cho ra một khung hình để script bắt được.

Bạn nhận được: Ruflo dùng được ngoài Claude Code, và tình trạng hệ thống lấy được bằng script. README không mô tả sâu hơn về cách tích hợp với từng client, nên bạn nên thử trên dự án nhỏ trước.

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

A.Chạy npx báo lỗi hoặc cài không được

Nguyên nhân thường gặp là Node quá cũ. Gói yêu cầu Node 20.0.0 trở lên. Hãy chạy node --version để kiểm tra. Nếu thấp hơn 20, bạn cập nhật Node rồi chạy lại lệnh init.

B.Chạy init xong mà Claude Code không thấy gì

README nói Claude Code nhận cấu hình ở lần khởi động kế tiếp. Vì vậy hãy thoát hẳn Claude Code rồi mở lại trong đúng thư mục bạn đã chạy init. Nếu mở ở thư mục khác, nó sẽ không thấy file cấu hình.

C.Lệnh /plugin install không chạy hoặc không nhận

Đường plugin cần Claude Code từ 2.1.287 trở lên (lệnh claude plugin install ngoài terminal cần 2.1.292). Hãy cập nhật Claude Code. Sau khi cài, gõ /reload-plugins để nạp lại. Ngoài ra các lệnh /plugin ... phải gõ trong Claude Code, không gõ trong PowerShell hay Terminal thường.

D.Plugin bên ngoài bị nạp hai lần

Bảng plugin của README cảnh báo với agentic-qe-fleet, agentdb và agentic-flow: chỉ nên cài từ một marketplace, hoặc marketplace gốc của chúng, hoặc marketplace ruflo. Cài từ cả hai thì mod và lệnh bị nạp hai lần. Nếu đã lỡ cài kép, hãy gỡ một bên.

E.Claude từ chối thao tác trong console

Đây thường là hành vi đúng thiết kế. Hành động vượt quá mức quyền bạn đặt sẽ bị từ chối. Các thao tác liên quan mạng, chi tiêu hoặc phá huỷ luôn cần bạn xác nhận. Mặc định là read + ask. Nếu cần ghi dữ liệu, bạn nâng lên write + ask và xác nhận từng thao tác. Chỉ nên dùng chế độ auto khi đã hiểu rõ mình đang cho phép điều gì.

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

Điểm mạnh. Cài nhanh bằng một lệnh. Bạn có sẵn nhiều agent, bộ nhớ và hệ thống hook. Console cho bạn thấy agent và chi phí. Có mức quyền rõ ràng cho phần Claude điều khiển. Dùng được với cả Claude Code lẫn Codex. Giấy phép MIT và repo vẫn được cập nhật trong vài tháng gần đây.

Giới hạn. Repo khá đồ sộ: README nhắc tới hàng trăm công cụ MCP, hàng chục lệnh CLI và 48 plugin. Người mới dễ choáng. Cứ bắt đầu từ init rồi dùng Claude Code như bình thường, các phần khác khám phá dần. Lệnh init thêm nhiều file vào dự án. Mod chạy với quyền tài khoản của bạn và không sandbox. README cũng nói thẳng rằng một số bản demo dùng dữ liệu mẫu và không chứng minh swarm đã hoàn thành việc thật. Phần “tự học” là mô hình khái niệm, không phải đảm bảo kết quả.

Khi nên chọn cách khác. Nếu bạn chỉ cần AI sửa vài dòng code hoặc trả lời câu hỏi ngắn, Claude Code thuần là đủ. Nếu muốn thử nhẹ, hãy cài theo đường plugin vì cách này không thêm file vào dự án. Nếu bạn làm ở môi trường có quy định chặt về dữ liệu, nên đọc SECURITY.md và tài liệu trong docs/ trước, vì mình chưa có thông tin chi tiết về cách dữ liệu được lưu và gửi đi.

Tóm lại, Ruflo hợp với người đã dùng Claude Code, muốn giao việc lớn hơn cho nhiều agent mà vẫn giữ được quyền kiểm soát. Bạn nên thử trên một dự án nhỏ, xem kết quả rồi mới áp dụng rộng hơn.

4.2/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 mã nguồn miễn phí. Tuy nhiên README có nhắc tới việc theo dõi token và chi phí, nghĩa là việc gọi mô hình AI có thể tốn tiền theo nhà cung cấp bạn dùng. Tư liệu mình có chưa nêu bảng giá cụ thể.

Cài Ruflo cần những gì?

Cần Node.js từ 20.0.0 trở lên, theo yêu cầu trong package.json. Nếu dùng đường plugin thì cần Claude Code 2.1.287 trở lên. Lệnh cài chính là `npx ruflo@latest init`, chạy trong thư mục dự án.

Ruflo có chạy trên Windows không?

README (phần mình có) không nêu rõ hệ điều hành được hỗ trợ. Các lệnh đều dựa trên Node và npx nên về nguyên tắc chạy ở nơi có Node 20 trở lên. Nếu gặp vấn đề riêng trên Windows, bạn nên xem README đầy đủ và mục Issues của repo.

Có cần GPU không?

Tư liệu mình có không yêu cầu GPU cho cách dùng cơ bản. Chỉ có một plugin (`ruflo-ruvector`) được mô tả là tìm kiếm tăng tốc bằng GPU, và đó là phần tuỳ chọn. Yêu cầu phần cứng chi tiết hơn thì chưa có thông tin.

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

Claude Code là công cụ để AI viết và sửa code. Ruflo là lớp bọc thêm quanh nó: nhiều agent chuyên biệt, bộ nhớ giữa các phiên, hook định tuyến tác vụ, MCP server và console theo dõi. Bạn vẫn dùng Claude Code như bình thường sau khi chạy `init`.

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

Có. README nói Codex và các client MCP khác dùng được bằng cách cấu hình command `npx` với arguments `["-y", "ruflo@latest", "mcp", "start"]`. README cũng có lệnh `npx ruflo init --grok` cho Grok Build.

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

README mô tả các lớp kiểm soát: bạn chọn mức quyền read, write, manage hoặc full, và chọn hỏi trước hoặc tự chạy. Mặc định là read + ask. Hành động liên quan mạng, chi tiêu hoặc phá huỷ vẫn phải xác nhận, và bạn có nút Take back control để dừng. Riêng 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.

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 đúng thư mục
    2. B.Chạy lệnh init
    3. C.Mở lại Claude Code và giao việc
    4. D.Cách khác: cài bằng plugin, không thêm file vào dự án
    5. E.Cách khác: dùng với Codex hoặc client MCP khác
    6. F.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 rà soát một dự án cũ
    2. B.Người mới muốn xem agent đang làm gì
    3. C.Nhờ Claude tạo “mission” trong console, có kiểm soát
    4. D.Chạy tự động trong script hoặc trên Codex
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy npx báo lỗi hoặc cài không được
    2. B.Chạy init xong mà Claude Code không thấy gì
    3. C.Lệnh /plugin install không chạy hoặc không nhận
    4. D.Plugin bên ngoài bị nạp hai lần
    5. E.Claude từ chối thao tác trong console
  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ỏ.