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

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 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 agent harness: lớp công cụ bao quanh Claude Code và Codex để nhiều agent phối hợp, có bộ nhớ và có cơ chế kiểm soát. Bạn dùng nó để giao việc lớn cho cả đội agent thay vì một agent đơn lẻ. Cài khá nhanh, chỉ cần Node 20 trở lên và một lệnh trong thư mục dự án.

Ruflo là một “bộ khung” (agent harness) đặt quanh Claude Code và Codex. Model AI lo việc viết và suy nghĩ. Ruflo lo phần còn lại: cho nó công cụ, bộ nhớ, vòng lặp làm việc, giới hạn an toàn, và cho nhiều agent làm việc cùng nhau như một đội. Repo này trước đây có tên Claude Flow, hiện có khoảng 81.580 sao và 9.606 fork trên GitHub, giấy phép MIT.

Bạn nên xem qua repo này nếu đang dùng Claude Code hoặc Codex cho việc thật, và thấy một agent làm một mình thì hay quên ngữ cảnh, khó kiểm soát. Người làm kinh doanh hoặc văn phòng cũng dùng được, vì README viết rõ: sau khi cài, bạn cứ dùng Claude Code như bình thường, phần điều phối chạy ngầm. Lập trình viên mới sẽ thấy lợi nhất ở chỗ có sẵn đội agent biết viết test, rà soát code, tìm module rủi ro.

Điểm đáng giá nhất là cách cài: một lệnh npx ruflo@latest init trong thư mục dự án, rồi mở Claude Code và giao việc. Bạn không phải học hết hàng trăm công cụ bên trong. Ngoài ra còn có một “bảng điều khiển” ngay trong Claude Code để xem agent đang làm gì, tốn bao nhiêu token và chi phí.

Framework

ruvnet/ruflo

Ruflo là bộ khung bao quanh Claude Code và Codex, thêm đội agent, bộ nhớ qua nhiều phiên 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ì

Theo README, Ruflo thêm cho Claude Code và Codex các thứ sau:

  • Đội agent và swarm. Có hơn 100 agent chuyên biệt, tự chia việc và phối hợp. Lợi ích: một yêu cầu lớn như “rà soát cả repo” được chia cho nhiều agent cùng làm, thay vì một agent làm tuần tự.
  • Bộ nhớ qua nhiều phiên. Agent nhớ những gì đã làm ở lần trước và dùng lại kinh nghiệm từ các task thành công. Bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần mở máy.
  • Hooks tự định tuyến. Sau khi init, hệ thống hooks tự chọn cách xử lý task và phối hợp agent ở chế độ nền. Bạn không cần nhớ lệnh nào.
  • Bảng điều khiển trong Claude Code. Gõ /ruflo để xem workflow, agent, model, token và chi phí. Bạn có thể mở log từng agent, tìm kiếm, xem lại và so sánh các lần chạy.
  • Cho Claude điều khiển bảng, nhưng bạn đặt giới hạn. Trong Settings có mục “Claude control” với các mức 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ền hoặc xoá luôn cần bạn xác nhận, kể cả ở auto.
  • Hệ plugin lớn. README liệt kê 48 plugin, ví dụ ruflo-swarm (phối hợp nhiều agent), ruflo-testgen (tìm chỗ thiếu test và sinh test), ruflo-security-audit (quét lỗ hổng), ruflo-cost-tracker (theo dõi token, đặt ngân sách), ruflo-docs (tự viết tài liệu).
  • Liên kết nhiều máy (federation). Agent trên các máy khác nhau có thể trao đổi với nhau một cách an toàn.
  • Chạy được ngoài Claude Code. Codex và các MCP client khác dùng được. Có cả giao diện terminal riêng.

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

Tư liệu của repo nói những điều sau:

  • Node.js 20 trở lên. File package.json yêu cầu Node >=20.0.0. Lệnh npx đi kèm Node.
  • Claude Code nếu bạn đi đường chính. Riêng đường cài bằng plugin cần Claude Code phiên bản 2.1.287 trở lên. Lệnh cài plugin từ terminal cần 2.1.292 trở lên.
  • Codex hoặc 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.

README phần đã cung cấp không ghi yêu cầu về hệ điều hành hay phần cứng cụ thể, cũng không nói rõ cần API key gì. Việc dùng model vẫn đi qua tài khoản Claude Code hoặc Codex của bạn, nên chi phí phụ thuộc gói bạn đang dùng.

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

  1. Kiểm tra NodeChắc chắn máy có Node 20 trở lên
  2. Mở terminal trong dự ánVào đúng thư mục dự án của bạn
  3. Chạy initMột lệnh npx thêm agent, hooks, bộ nhớ, MCP server
  4. Mở lại Claude CodeMở Claude Code ở cùng thư mục để nó nhận cấu hình
  5. Giao một việc thậtGõ yêu cầu dùng swarm và xem kết quả

A.Kiểm tra Node

Mở terminal (PowerShell trên Windows, Terminal trên macOS) rồi kiểm tra phiên bản Node. Đây là lệnh phổ thông, không thuộc README, nhưng chắc chắn đúng:

Terminal
node --version

Nếu số hiện ra nhỏ hơn 20 thì bạn cần nâng cấp Node trước. Chỗ này người mới hay bỏ qua rồi gặp lỗi khó hiểu ở bước sau.

B.Mở terminal đúng thư mục dự án

Lệnh init ghi file vào thư mục hiện tại, nên bạn phải đứng đúng chỗ. Ví dụ:

Terminal
cd ten-thu-muc-du-an-cua-ban

Thay ten-thu-muc-du-an-cua-ban bằng đường dẫn thật. Đừng chạy ở thư mục lung tung như Desktop hay thư mục người dùng, vì file sẽ bị ghi vào đó.

C.Chạy lệnh init

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

Terminal
npx ruflo@latest init

Lệnh này thêm agent, hooks, bộ nhớ và MCP server của Ruflo vào dự án. Bảng so sánh trong README cho biết đường này tạo các thư mục và file như .claude/, .claude-flow/, CLAUDE.md cùng một số file hỗ trợ và settings. Nếu dự án của bạn đã có CLAUDE.md, hãy sao lưu hoặc dùng Git để dễ so sánh thay đổi.

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

Terminal
npx ruflo@latest init wizard

D.Mở lại Claude Code

Mở Claude Code ở cùng thư mục. README nói Claude Code sẽ nhận agent, hooks, bộ nhớ và MCP server ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn Claude Code, hãy thoát và mở lại.

E.Các cách cài khác

Nếu không muốn thêm file vào dự án, README có đường cài chỉ bằng plugin. 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:

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

Với Codex hoặc MCP client khác, bạn cấu hình command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Cách tương đương trên một dòng lệnh là:

Terminal
npx -y ruflo@latest mcp start

Nếu chỉ muốn thử giao diện, README có lệnh chạy bảng điều khiển ngoài Claude Code:

Terminal
npx ruflo tui

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

Bảng so sánh của README tóm gọn: đường plugin nhẹ, không thêm file vào dự án, hợp để thử từng plugin. Đường npx ruflo init cho đủ bộ: 98 agent, hơn 60 lệnh, 30 skill, MCP server, hooks và daemon. README khuyên đường này cho dùng thật.

Các mod của Ruflo chạy với quyền tài khoản của bạn và không bị cô lập (sandbox). README dặn đọc mã trước khi cài. Hãy giữ mức Claude control ở read + ask cho đến khi bạn hiểu rõ mình đang cho phép điều gì.

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

Có ba dấu hiệu theo tư liệu:

  1. Sau init, thư mục dự án có thêm .claude/, .claude-flow/ và CLAUDE.md.
  2. Mở lại Claude Code, gõ /ruflo. Bảng điều khiển (console) hiện ra là thành công. Với đường plugin, mở /plugin để xem các plugin có nằm trong dòng “active mods” không.
  3. Giao thử một việc nhỏ, ví dụ yêu cầu dưới đây, và xem Claude có dùng swarm không.

README cũng đưa một bài thử an toàn: vào Settings → Claude control → chọn write + ask, rồi nhờ Claude “Create a mission to add a dark mode toggle. Show me the mission and its status.” Bạn duyệt hành động tạo mission, sau đó kiểm tra mục Missions có mục tiêu đó và mục Overview có ghi lại hành động. Lưu ý README nói rõ: tạo mission không có nghĩa tính năng đã được viết xong.

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

README nhắc: bạn không cần học hết hàng trăm công cụ MCP và hàng chục lệnh CLI. Sau init, cứ dùng Claude Code bình thường, phần định tuyến và học hỏi chạy ngầm.

A.Dev rà soát một repo lạ

Bối cảnh: bạn vừa nhận một dự án của đồng nghiệp, chưa biết chỗ nào dễ hỏng. Sau khi cài, mở Claude Code trong thư mục dự án và dùng đú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: nhiều agent cùng đọc code, chỉ ra module rủi ro nhất, viết test cho nó, rồi tóm tắt thay đổi. Bạn đọc bản tóm tắt thay vì tự lần từng file. Hãy luôn xem lại các file test được tạo trước khi giữ lại.

Model viết code, còn Ruflo là cái bàn làm việc để nó làm cho ra việc.

Ông T

B.Chủ shop muốn theo dõi chi phí AI

Bối cảnh: bạn có một dự án nhỏ như web bán hàng hoặc bộ script xử lý đơn, và dùng AI nhiều nên lo tốn token. Cài bảng điều khiển bằng đường plugin (ruflo-console), gõ /ruflo để xem agent, model, token và chi phí cạnh Claude Code. README cũng liệt kê plugin ruflo-cost-tracker với chức năng theo dõi token, đặt ngân sách và cảnh báo chi phí. Kết quả: bạn nhìn thấy mỗi lần chạy tốn bao nhiêu trước khi nó thành khoản bất ngờ cuối tháng.

C.Nhân viên văn phòng cần tài liệu gọn

Bối cảnh: nhóm có một công cụ nội bộ viết dở, tài liệu thiếu. Bạn cài plugin ruflo-docs (README mô tả: tạo và duy trì tài liệu tự động) qua đường plugin, rồi nhờ Claude viết tài liệu cho thư mục đó. Kết quả: có bản nháp tài liệu để bạn chỉnh. Phần tài liệu này vẫn cần người đọc lại, vì AI có thể hiểu sai ý định ban đầu của người viết code.

D.Giám sát an toàn cho việc để agent chạy tự động

Bối cảnh: bạn muốn để agent chạy lâu mà không ngồi canh. README có ruflo-protector (watchdog cho agent chạy không giám sát, các chế độ học, thông báo hoặc ép buộc) và ruflo-security-audit (quét lỗ hổng và CVE). Cách làm: cài các plugin này bằng /plugin install theo mẫu ten-plugin@ruflo, rồi thử trên dự án nhỏ trước. Kết quả: bạn có thêm lớp kiểm tra, nhưng không nên coi là bảo đảm tuyệt đối.

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

Chạy npx báo lỗi hoặc không tìm thấy lệnh. Gần như chắc chắn do chưa cài Node hoặc Node quá cũ. Chạy node --version, nếu dưới 20 thì nâng cấp rồi thử lại.

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

Lệnh /plugin install hoặc claude plugin install không chạy. Đường plugin cần Claude Code 2.1.287 trở lên, còn lệnh từ terminal cần 2.1.292 trở lên. Cập nhật Claude Code rồi thử lại.

Plugin bị nạp hai lần. README cảnh báo với các plugin ngoài như agentic-qe-fleet, agentdb, agentic-flow: chỉ cài từ một marketplace, không cài ở cả hai nơi, nếu không mod và lệnh sẽ nạp đôi. Hãy gỡ bản thừa.

Claude bị từ chối khi điều khiển bảng. Đây là thiết kế, không phải lỗi. Mặc định là read + ask, hành động vượt quyền sẽ bị từ chối. Nếu cần tạo mission, nâng lên write + ask trong Settings → Claude control. Nếu muốn dừng ngay, bấm “Take back control”.

File lạ xuất hiện trong dự án. Đường init ghi .claude/, .claude-flow/, CLAUDE.md và file hỗ trợ. Hãy chạy trên nhánh Git riêng hoặc sao lưu trước. README còn nhắc với Grok có cờ --dry-run để xem trước. Nếu cần biết lệnh khác có cờ này không, xem tài liệu trong thư mục docs của repo.

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

Điểm mạnh. Cài nhanh bằng một lệnh. Có cả đường nhẹ (plugin, không thêm file) lẫn đường đầy đủ. Hệ sinh thái rộng: agent, bộ nhớ, bảng điều khiển, bảo mật, theo dõi chi phí. Giấy phép MIT, repo còn được cập nhật trong vài tháng gần đây. README cũng khá trung thực về giới hạn: ghi rõ phần demo dùng dữ liệu mẫu, và bản ghi phiên chạy không chứng minh swarm đã hoàn thành việc thật hay bộ nhớ gợi lại được.

Giới hạn. Bộ khung rất lớn, nên người mới dễ choáng. Đường đầy đủ thêm khá nhiều file vào dự án. Các mod chạy với quyền tài khoản và không sandbox. Phần học tự động theo README vẫn cần embeddings và module cấu hình, không phải chạy hoàn toàn “không cần gì”. Tư liệu tôi có chưa nói rõ về chi phí token khi chạy swarm nhiều agent, bạn nên tự theo dõi bằng bảng điều khiển.

Khi nào chọn cách khác. Nếu bạn chỉ cần một agent làm việc đơn giản, dùng thẳng Claude Code hoặc Codex là đủ. Nếu chỉ cần bộ nhớ hoặc một tính năng riêng, hãy thử đường plugin với một hai plugin trước, rồi hãy quyết định có cài đủ bộ không. Nếu dự án quan trọng, thử trên một repo nháp để xem Ruflo thay đổi những gì.

4.1/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 là gì, khác gì Claude Flow?

Ruflo là bộ khung (agent harness) bao quanh Claude Code và Codex, thêm đội agent, bộ nhớ và cơ chế kiểm soát. README cho biết nó là tên mới của Claude Flow, cùng tác giả và cùng dòng phát triển.

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 bạn vẫn dùng model qua Claude Code, Codex hoặc nhà cung cấp khác, và chi phí đó tuỳ gói của bạn. Tư liệu chưa nêu giá cụ thể.

Cài Ruflo có khó không?

Không khó. Đường chính chỉ cần Node 20 trở lên và chạy `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code. Cũng có đường chỉ cài plugin trong Claude Code nếu bạn không muốn thêm file vào dự án.

Dùng Ruflo có cần GPU không?

Tư liệu tôi có không nêu yêu cầu GPU. Một số plugin như ruflo-ruvector có nhắc tìm kiếm tăng tốc bằng GPU, nhưng đó là tuỳ chọn riêng. Yêu cầu phần cứng chi tiết chưa có thông tin.

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

README phần tôi có không ghi rõ hệ điều hành được hỗ trợ. Yêu cầu được nêu là Node 20 trở lên, và các lệnh đều chạy qua `npx`. Bạn nên thử trên một thư mục dự án nháp trước.

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

Có. README nói Codex và các MCP client 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 nhắc hỗ trợ cho Grok qua tuỳ chọn riêng.

Dữ liệu và quyền truy cập có an toàn không?

README nhấn mạnh các cơ chế kiểm soát: mức quyền read, write, manage, full, mặc định read + ask, và hành động nhạy cảm luôn cần xác nhận. Tuy vậy các mod chạy với quyền tài khoản của bạn và không sandbox, nên cần đọc mã 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.Kiểm tra Node
    2. B.Mở terminal đúng thư mục dự án
    3. C.Chạy lệnh init
    4. D.Mở lại Claude Code
    5. E.Các cách cài khác
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev rà soát một repo lạ
    2. B.Chủ shop muốn theo dõi chi phí AI
    3. C.Nhân viên văn phòng cần tài liệu gọn
    4. D.Giám sát an toàn cho việc để agent chạy tự động
  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ỏ.