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

Ruflo: điều phối nhiều agent AI 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 agent AI 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ụ bọc quanh Claude Code và Codex để thêm nhiều agent chuyên biệt, swarm phối hợp, bộ nhớ qua các phiên và MCP server. Cài chỉ cần một lệnh npx ruflo@latest init trong thư mục dự án, cần Node 20 trở lên. Người mới cài được nhanh, nhưng hệ thống rất rộng nên nên bắt đầu từ một tác vụ nhỏ.

Ruflo là một "agent harness", tức là bộ khung đặt quanh Claude Code và Codex để biến một trợ lý AI đơn lẻ thành một nhóm agent biết phối hợp, nhớ việc cũ và có kiểm soát. Repo này trước đây tên Claude Flow, viết chủ yếu bằng TypeScript, giấy phép MIT. Hiện có khoảng 81.582 sao và 9.607 fork trên GitHub.

Vấn đề nó giải quyết khá đời thường. Khi bạn giao việc lớn cho Claude Code, mô hình chỉ viết code, còn việc chia nhỏ nhiệm vụ, nhớ lại ngữ cảnh hôm qua, kiểm tra kết quả thì phải tự lo. Ruflo thêm phần "xung quanh" đó: agent chuyên biệt, swarm (nhóm agent làm việc cùng nhau), bộ nhớ, hook và một MCP server. README tóm gọn: Agent = Model + Harness. Mô hình viết, còn harness cho nó công cụ, bộ nhớ và giới hạn để làm việc thật.

Bạn nên đọc bài này nếu đang dùng Claude Code hoặc Codex và muốn thử cách làm việc "có đội", hoặc là lập trình viên mới muốn xem một hệ thống điều phối agent hoàn chỉnh trông thế nào. Điểm đáng giá nhất: cài chỉ một lệnh, sau đó bạn cứ dùng Claude Code như bình thường, các hook sẽ tự định tuyến và phối hợp agent ở phía sau.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) bọc quanh Claude Code và Codex, thêm agent chuyên biệt, bộ nhớ, 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 là lớp thực thi quanh Claude Code và Codex. Mình chọn ra những phần bạn dễ cảm nhận nhất.

A.Agent chuyên biệt và swarm

Sau khi cài, bạn có một bộ agent dựng sẵn (README ghi 98 agent ở đường cài đầy đủ, nơi khác nói hơn 100). Chúng có thể tự tổ chức thành swarm để chia việc. Lợi ích thực tế: bạn giao một yêu cầu như "xem lại repo này, tìm module rủi ro nhất, viết test" và nhiều agent cùng xử lý thay vì một mạch tuần tự.

B.Bộ nhớ qua nhiều phiên

Ruflo có bộ nhớ vector để agent nhớ lại giữa các lần làm việc. README mô tả luồng khái niệm: yêu cầu đi qua router, swarm, agent, bộ nhớ rồi mới tới nhà cung cấp mô hình, và bộ nhớ đưa kinh nghiệm ngược lại để định tuyến tốt hơn. README cũng nói rõ đây là sơ đồ khái niệm, không phải vết chạy thật. 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ấu hình.

C.Hook tự chạy ngầm

Bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI mà README nhắc tới. Sau init, hệ thống hook tự định tuyến tác vụ, học từ các mẫu thành công và điều phối agent ở nền.

D.Bảng điều khiển /ruflo

Đây là "buồng lái" nằm cạnh Claude Code: theo dõi workflow, agent, mô hình, token và chi phí. Bạn có thể mở log của agent, tìm kiếm, phân loại lỗi, phát lại và so sánh các lần chạy. Bảng này cũng chạy riêng ngoài Claude Code bằng một lệnh terminal.

E.Cho Claude điều khiển nhưng bạn đặt giới hạn

Trong Settings có mục Claude control. Bạn chọn mức quyền read, write, manage hoặc full, và chế độ duyệt ask hoặc auto. Mặc định hiện là read + ask. Hành động vượt quyền sẽ bị từ chối, còn hành động liên quan mạng, chi tiêu hoặc phá huỷ vẫn phải xác nhận ngay cả khi để auto. Có nút Take back control để thu lại quyền.

F.Kho plugin

Ruflo có hàng chục plugin cài riêng được, ví dụ ruflo-swarm (phối hợp nhiều agent), ruflo-testgen (tìm test còn thiếu và tạo test), ruflo-security-audit (quét lỗ hổng), ruflo-cost-tracker (theo dõi token và đặt ngân sách), ruflo-docs (tạo và duy trì tài liệu). Bạn chỉ cài cái cần.

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 (package.json ghi yêu cầu này), vì lệnh cài chạy qua npx.
  • Claude Code, hoặc Codex, hoặc một MCP client khác để dùng Ruflo.
  • Nếu chọn đường cài bằng plugin Claude Code: Claude Code phiên bản 2.1.287 trở lên. Lệnh cài plugin từ terminal cần Claude Code 2.1.292 trở lên.
  • Một thư mục dự án để chạy lệnh init.

README phần đã cung cấp không nói gì về yêu cầu hệ điều hành, GPU hay dung lượng ổ đĩa, nên mình không khẳng định. Nếu cần biết rõ, bạn xem README.md và các tài liệu trong thư mục docs của repo.

Mod của Ruflo chạy với quyền của tài khoản bạn và không được đưa vào sandbox. README khuyên đọc mã trước khi cài. Hãy giữ mức quyền Claude control ở read + ask cho đến khi bạn quen.

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

Ruflo có nhiều đường cài. Đường đơn giản và đầy đủ nhất là lệnh init trong thư mục dự án.

  1. Kiểm tra NodeĐảm bảo máy có Node 20 trở lên
  2. Mở terminal trong dự ánVào đúng thư mục dự án bạn muốn dùng
  3. Chạy initThêm agent, hook, bộ nhớ và MCP server vào dự án
  4. Mở lại Claude CodeClaude Code nạp cấu hình ở lần khởi động kế tiếp
  5. Giao một tác vụ thậtThử một swarm với yêu cầu cụ thể

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

Chỗ người mới hay vấp nhất: lệnh phải chạy trong thư mục dự án của bạn, không phải thư mục bất kỳ. Trên Windows bạn có thể mở PowerShell rồi dùng cd tới thư mục đó. Ví dụ (đường dẫn là ví dụ của mình, bạn thay bằng đường dẫn thật):

PowerShell
cd C:\duong-dan\toi\du-an-cua-ban

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 README, init thêm agent, hook, bộ nhớ và MCP server vào dự án. Ở bảng so sánh, README liệt kê các thứ xuất hiện trong thư mục làm việc gồm .claude/, .claude-flow/, CLAUDE.md, các file helper và settings. Nếu thư mục đó đã có CLAUDE.md của bạn, hãy sao lưu trước khi chạy.

Muốn cài theo kiểu hỏi đáp từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code và giao việc

Mở Claude Code trong cùng thư mục. Claude Code sẽ nhận các agent, hook, bộ nhớ và MCP server ở lần khởi động tiếp theo. Rồi thử câu lệnh 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.

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

Nếu bạn không muốn thêm file nào vào dự án, README có đường plugin (cần Claude Code 2.1.287 trở lên). Gõ 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, trên Claude Code 2.1.292 trở lên:

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

Hai đường này khác nhau khá nhiều. README so sánh: đường plugin không thêm file nào vào dự án, không cài hook, và chỉ có MCP server nếu bạn cài ruflo-core. Đường npx ruflo init cho vòng làm việc đầy đủ gồm agent, lệnh, skill, MCP server, hook và daemon, và README coi đó là đường dùng cho công việc thật.

E.Cách khác: Codex hoặc MCP client khác

Bạn cấu hình command là npx và arguments là -y, ruflo@latest, mcp, start. Nói cách khác, lệnh đầy đủ là:

Terminal
npx -y ruflo@latest mcp start

Cách điền vào từng client khác nhau, README phần đã có chưa hướng dẫn chi tiết cho từng loại. Bạn xem tài liệu của client mình dùng.

F.Cách khác: chạy bảng điều khiển trong terminal thường

Terminal
npx ruflo tui

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

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

Theo README, bạn kiểm tra theo từng đường cài:

  • Đường init: khởi động lại Claude Code trong thư mục dự án, gõ /ruflo. Nếu bảng điều khiển mở ra là Ruflo đã được nạp. Bạn cũng sẽ thấy các thư mục như .claude/ và .claude-flow/ cùng file CLAUDE.md trong dự án.
  • Đường plugin: sau /reload-plugins, mở /plugin và xem các mod có nằm trong dòng active mods không. Gõ /ruflo để mở bảng điều khiển.
  • Đường terminal: chạy npx ruflo tui và xem giao diện có hiện lên không.

Bài thử gọn nhất theo README: trong Settings → Claude control chọn write + ask, rồi bảo Claude: "Create a mission to add a dark mode toggle. Show me the mission and its status." Bạn xác nhận hành động tạo mission, rồi kiểm tra mục Missions có mục tiêu đó và Overview có ghi lại hành động. Lưu ý: tạo mission không có nghĩa tính năng dark mode đã được làm xong.

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

Bám theo những gì README nêu, đây là vài tình huống bạn có thể thử.

A.Dev mới nhận một repo lạ

Bạn vừa vào công ty, được giao một dự án cũ chưa có tài liệu. Chạy npx ruflo@latest init trong thư mục dự án, mở lại Claude Code rồi dùng đúng câu lệnh mẫu:

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 điều phối các agent để chỉ ra module rủi ro nhất, viết test cho nó và tóm tắt những gì đã thay đổi. Bạn đọc bản tóm tắt để biết mình cần xem file nào trước. Hãy đọc kỹ các test được tạo ra trước khi tin vào chúng.

Bạn vẫn viết code như cũ. Ruflo lo phần phối hợp phía sau.

Ông T

B.Theo dõi chi phí khi chạy nhiều agent

Bạn đang trả tiền theo token và lo agent "đốt" quá nhiều. Cài bảng điều khiển bằng /plugin install ruflo-console@ruflo, rồi gõ /ruflo. README nói bảng này cho thấy workflow, agent, mô hình, token và chi phí cạnh Claude Code. Trong danh sách plugin còn có ruflo-cost-tracker để theo dõi token, đặt ngân sách và nhận cảnh báo chi phí. Kết quả: bạn nhìn được lần chạy nào tốn nhiều và quyết định có dừng hay không.

C.Giao Claude thao tác trên bảng điều khiển nhưng có kiểm soát

Bạn muốn thử cho Claude tự tạo và quản lý việc trong bảng điều khiển, nhưng không muốn nó làm bậy. Vào Settings → Claude control, chọn write + ask. Rồi nhờ Claude tạo một mission cho mục tiêu của bạn. Mỗi hành động tạo sẽ chờ bạn xác nhận. Nếu thấy không ổn, bấm Take back control để dừng; những lần gọi sau đó sẽ bị từ chối cho tới khi bạn trả quyền. Kết quả là bạn có một cách thử agent tự động mà vẫn nắm được cái phanh.

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

Bạn không dùng Claude Code mà dùng Codex hay một MCP client khác. Bạn cấu hình client chạy npx -y ruflo@latest mcp start. Kết quả: client đó gọi được các công cụ của Ruflo qua MCP. README phần đã cung cấp chưa nêu từng bước cấu hình cho Codex, nên hãy xem thêm tài liệu trong thư mục docs.

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

Mấy lỗi dưới đây là các tình huống rất dễ gặp với loại công cụ này. Chúng không phải lỗi được README liệt kê.

A.Báo lỗi phiên bản Node

package.json yêu cầu Node 20 trở lên. Nếu máy bạn dùng bản cũ, npx có thể báo lỗi hoặc chạy sai. Gõ node --version để kiểm tra, rồi nâng cấp Node nếu thấy thấp hơn 20.

B.Chạy lệnh sai thư mục

init ghi file vào thư mục hiện tại. Nếu bạn chạy ở thư mục sai, Ruflo sẽ nằm sai chỗ. Hãy cd đúng vào dự án trước khi chạy. Với Grok, README có cờ --dry-run để xem trước thay đổi; với các đường khác, hãy sao lưu hoặc dùng Git để xem file nào mới xuất hiện rồi hoàn tác nếu cần.

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

README nói Claude Code nạp cấu hình ở lần khởi động tiếp theo. Hãy thoát hẳn Claude Code rồi mở lại trong cùng thư mục. Với đường plugin, chạy /reload-plugins rồi mở /plugin để xem plugin đã hiện chưa.

D.Lệnh plugin không nhận

Đường plugin cần Claude Code 2.1.287 trở lên, còn lệnh cài từ terminal cần 2.1.292 trở lên. Nếu Claude Code của bạn cũ hơn, hãy cập nhật trước.

E.Cài một plugin từ hai marketplace

README cảnh báo với các plugin bên ngoài như agentic-qe-fleet, agentdb, agentic-flow: chỉ nên cài từ một marketplace, nếu bật từ cả hai thì mod và lệnh bị nạp hai lần. Hãy chọn một nguồn và gỡ nguồn còn lại.

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

Điểm mạnh: một lệnh npx ruflo@latest init là có sẵn một hệ thống khá đầy đủ gồm agent, hook, bộ nhớ và MCP server. Giấy phép MIT, repo vẫn được cập nhật trong vài tháng gần đây, và có cả đường cài nhẹ bằng plugin không đụng vào dự án. Cơ chế giới hạn quyền (read, write, manage, full và ask, auto) là điểm cộng cho người lo agent tự làm bậy.

Giới hạn: hệ thống rất rộng, với hàng trăm công cụ và hàng chục plugin, nên người mới dễ choáng. README cũng nói thẳng là một số bản demo dùng dữ liệu mẫu và không chứng minh swarm hay bộ nhớ đã hoàn thành việc thật. Các mod không chạy trong sandbox. Chi phí token khi chạy nhiều agent là thứ bạn phải tự theo dõi. Tài liệu bạn đưa mình chưa nói rõ về hỗ trợ hệ điều hành hay yêu cầu phần cứng.

Khi nào nên chọn cách khác: nếu bạn chỉ cần Claude Code làm vài việc nhỏ, dùng thẳng Claude Code là đủ. Nếu chỉ muốn thử một tính năng, hãy cài đúng một plugin thay vì cài toàn bộ. Còn nếu bạn muốn một đội agent phối hợp, có bộ nhớ và có bảng điều khiển, Ruflo đáng để thử trên một dự án nhỏ trước.

4.5/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?

Mã nguồn dùng giấy phép MIT nên dùng tự do. Tuy nhiên Ruflo chạy cùng Claude Code hoặc Codex, nên chi phí dùng mô hình phụ thuộc gói và tài khoản bạn đang có. Tư liệu chưa nói rõ về giá.

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. Nếu muốn cài theo kiểu hỏi đáp, README có lệnh npx ruflo@latest init wizard. Bạn cần Node 20 trở lên.

Có cần cài vào dự án không, hay chỉ cài plugin được?

Được cả hai. Đường plugin không thêm file nào vào dự án nhưng chỉ có slash command, một số skill và agent, không có hook. Đường npx ruflo init cho vòng làm việc đầy đủ, README coi là đường dùng cho công việc thật.

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

Có. README nói Codex và các MCP client khác dùng được: cấu hình command là npx với tham số -y, ruflo@latest, mcp, start. Từng bước cấu hình cho riêng từng client thì tư liệu chưa nêu chi tiết.

Claude có tự làm bậy trên máy của tôi không?

README mô tả cơ chế giới hạn: bạn chọn mức quyền read, write, manage hoặc full và chế độ 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ỷ luôn cần xác nhận. Riêng các mod thì không chạy trong sandbox, nên cần đọc mã trước khi cài.

Có cần GPU hay chạy được trên Windows không?

Tư liệu mình có chưa nêu yêu cầu GPU hay danh sách hệ điều hành được hỗ trợ. Yêu cầu duy nhất được ghi rõ là Node 20 trở lên và, với đường plugin, Claude Code 2.1.287 trở lên. Bạn nên xem README.md và thư mục docs trong repo.

Ruflo trước đây có tên gì?

README nói Ruflo trước đây là Claude Flow, do Reuven Cohen (rUv) tạo ra. Tên gói npm trong tư liệu là claude-flow, còn lệnh trong README dùng tên ruflo.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
    1. A.Agent chuyên biệt và swarm
    2. B.Bộ nhớ qua nhiều phiên
    3. C.Hook tự chạy ngầm
    4. D.Bảng điều khiển /ruflo
    5. E.Cho Claude điều khiển nhưng bạn đặt giới hạn
    6. F.Kho plugin
  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: chỉ cài plugin trong Claude Code
    5. E.Cách khác: Codex hoặc MCP client khác
    6. F.Cách khác: 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.Dev mới nhận một repo lạ
    2. B.Theo dõi chi phí khi chạy nhiều agent
    3. C.Giao Claude thao tác trên bảng điều khiển nhưng có kiểm soát
    4. D.Dùng Ruflo từ Codex hoặc công cụ khác
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo lỗi phiên bản Node
    2. B.Chạy lệnh sai thư mục
    3. C.Cài xong mà Claude Code không thấy gì
    4. D.Lệnh plugin không nhận
    5. E.Cài một plugin từ hai marketplace
  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ỏ.