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 'harness' bao quanh Claude Code và Codex. Nó thêm đội agent, bộ nhớ qua các phiên, hook và MCP server vào dự án của bạn. Cài chỉ cần một lệnh npx, cần Node 20 trở lên, nhưng phạm vi tính năng rất rộng nên cần thời gian làm quen.

Ruflo là một bộ khung điều phối (harness) đặt quanh Claude Code và Codex. Nói đơn giản: mô hình AI lo viết code, còn Ruflo lo phần còn lại, gồm công cụ, bộ nhớ, vòng lặp làm việc và các lớp kiểm soát. Nhờ vậy nhiều agent có thể phối hợp với nhau thay vì mỗi agent chạy riêng lẻ.

Bạn nên xem repo này nếu đã dùng Claude Code hoặc Codex và muốn giao những việc lớn hơn một câu lệnh. Ví dụ: rà soát cả dự án, viết test cho phần rủi ro nhất, rồi tóm tắt lại. Repo hiện có khoảng 81.600 sao và khoảng 9.600 fork, dùng giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là cách cài rất gọn. Bạn chạy một lệnh trong thư mục dự án, mở lại Claude Code, rồi dùng như bình thường. README nói hệ thống hook sẽ tự định tuyến tác vụ và điều phối agent ngầm, nên bạn không cần học hết hàng trăm công cụ đi kèm.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối bao 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ì

Ruflo có rất nhiều thành phần. Dưới đây là những phần dễ thấy lợi ích nhất cho người mới.

Đội agent phối hợp (swarm). Repo kèm hàng chục agent chuyên biệt (bảng so sánh trong README ghi 98 agent). Chúng được tổ chức thành nhóm để chia việc cho nhau. Lợi ích: một yêu cầu lớn được chia nhỏ và làm song song, thay vì chờ một agent làm tuần tự.

Bộ nhớ qua nhiều phiên. Agent có thể nhớ những gì đã làm và học từ các tác vụ thành công. README mô tả việc truy xuất vector chạy cục bộ, kèm các plugin như ruflo-agentdb, ruflo-rag-memory và ruflo-rvf để lưu và khôi phục bộ nhớ. Lợi ích: bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần mở phiên mới.

Hook tự định tuyến. Sau khi init, các hook chạy ngầm để chọn cách xử lý tác vụ. Bạn vẫn dùng Claude Code quen thuộc.

Bảng điều khiển (console). Đây là một 'cockpit' đặt cạnh Claude Code. Bạn xem được workflow, agent, mô hình, số token và chi phí. Bạn cũng mở được log của từng lần chạy để tìm lỗi. Mở bằng lệnh /ruflo trong Claude Code, hoặc chạy riêng ngoài terminal bằng npx ruflo tui.

Cho Claude điều khiển console, nhưng bạn đặt giới hạn. Trong Settings có mục Claude control với bốn mức: read, write, manage, full. Bạn chọn thêm chế độ duyệt ask hoặc auto. README ghi mặc định hiện là read + ask. Các thao tác liên quan mạng, chi tiêu hoặc xoá vẫn đòi xác nhận, kể cả khi đang để auto.

Kho plugin. README liệt kê 48 plugin, chia theo nhóm: điều phối, bộ nhớ, học tăng cường, kiểm thử, bảo mật, theo dõi chi phí... Ví dụ ruflo-testgen tìm test còn thiếu và sinh ra, 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ể trao đổi với nhau. Phần này nâng cao, người mới có thể bỏ qua.

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

  • Node.js từ 20.0.0 trở lên. Đây là yêu cầu trong package.json của repo.
  • Claude Code nếu bạn đi đường cài init hoặc đường plugin. Riêng đường plugin cần Claude Code bản 2.1.287 trở lên. Lệnh cài plugin từ terminal cần bản 2.1.292 trở lên.
  • Hoặc Codex / một MCP client khác. README nói các công cụ này cũng dùng được, bằng cách trỏ tới npx -y ruflo@latest mcp start.
  • Một thư mục dự án để chạy lệnh. Lệnh init ghi file vào đúng thư mục này.

Tư liệu không nêu rõ hệ điều hành hỗ trợ, cũng không nói cần GPU hay API key riêng cho phần cơ bản. Phần plugin có nhắc tới các nhà cung cấp mô hình khác (ví dụ DeepSeek, Ollama) nhưng đó là tuỳ chọn. Nếu bạn dùng Windows, hãy tự thử trên một thư mục dự án nháp trước. Chi tiết xem thêm trong README và thư mục docs của repo.

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

README đưa ra ba đường: cài vào dự án bằng npx ruflo@latest init, cài chỉ bằng plugin Claude Code, hoặc nối qua MCP. Với người mới, đường đầu là đơn giản nhất.

  1. Mở terminal trong thư mục dự ánĐứng đúng thư mục bạn muốn Ruflo làm việc
  2. Chạy initLệnh npx ruflo@latest init thêm agent, hook, bộ nhớ và MCP server
  3. Mở lại Claude CodeMở 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 yêu cầu cụ thể cho Claude Code
  5. Tuỳ chọn: bảng điều khiểnGõ /ruflo hoặc chạy npx ruflo tui

A.Mở terminal đúng 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ếu bạn đang đứng sai chỗ (ví dụ thư mục Desktop), file sẽ nằm sai nơi. Hãy cd vào dự án trước.

Terminal
cd ten-thu-muc-du-an

Thay ten-thu-muc-du-an bằng tên thư mục thật của bạn. Nếu bạn muốn thử mà chưa có dự án, hãy tạo một thư mục nháp và chạy trong đó.

B.Chạy lệnh init

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. Phần so sánh trong README nói đường này tạo các mục như .claude/, .claude-flow/, CLAUDE.md và file cấu hình trong thư mục làm việc. Vì vậy bạn nên thử trên dự án có Git để dễ xem thay đổi.

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

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. README cho biết Claude Code sẽ nhận các thành phần mới ở lần khởi động kế tiếp. Nếu bạn đang để Claude Code mở sẵn, hãy đóng và mở lại. Sau đó thử một yêu cầu cụ thể, lấy nguyên mẫu từ 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 (không thêm file vào dự án)

Đường này cài công cụ lõi, bảng điều khiển và các mod, và README nói là không thêm file nào vào dự án. Bạn chạy các lệnh sau bên trong Claude Code, không phải ở 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 muốn gõ từ terminal (Claude Code bản 2.1.292 trở lên), README ghi:

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

Các mod chạy với quyền tài khoản của bạn và không bị cô lập (sandbox). README khuyên đọc code của mod trước khi cài. Hãy làm theo, nhất là khi dùng trên máy có dữ liệu công việc.

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

Cấu hình client của bạn với command là npx và arguments như sau:

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

Cách nhập cụ thể tuỳ từng client. Tư liệu không hướng dẫn chi tiết cho từng công cụ, bạn xem tài liệu của client đó.

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:

  • Sau init và khởi động lại Claude Code, gõ /ruflo sẽ mở bảng điều khiển (nếu bạn có cài console).
  • Với đường plugin, mở /plugin và xem các plugin có xuất hiện trong dòng mod đang hoạt động hay không.
  • Chạy npx ruflo tui trong terminal để mở console độc lập, không cần Claude Code. Thêm --plain nếu muốn in một khung hình ra cho script.
  • Cách thử thực tế nhất: giao câu yêu cầu mẫu ở trên và xem Claude Code có điều phối nhiều agent không.

Tư liệu không mô tả cụ thể màn hình hay thông báo chính xác khi init xong. Nếu thấy thư mục dự án có thêm .claude/ và CLAUDE.md, đó là dấu hiệu init đã ghi file.

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

Các tình huống dưới đây bám theo khả năng README mô tả. Kết quả thực tế sẽ khác tuỳ dự án của bạn.

A.Lập trình viên mới: rà soát một dự án vừa nhận

Bạn vừa nhận một dự án lạ và không biết bắt đầu từ đâu. Sau khi init, mở Claude Code và dán đúng câu 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 chia việc cho các agent, chọn ra module rủi ro nhất, viết test và tóm tắt phần đã sửa. Hãy đọc kỹ phần tóm tắt và chạy lại test của bạn trước khi tin kết quả.

Agent = Model + Harness. Mô hình viết code, còn Ruflo là phần giúp nó làm việc thật sự.

Ông T

B.Chủ shop có website nhỏ: theo dõi chi phí token

Bạn thuê hoặc tự dùng Claude Code để sửa website bán hàng và lo bị đội chi phí. Cài thêm plugin theo dõi chi phí trong Claude Code:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-cost-tracker@ruflo

README mô tả plugin này theo dõi lượng token, đặt ngân sách và cảnh báo chi phí. Bảng điều khiển /ruflo cũng hiển thị token và chi phí cạnh Claude Code. Bạn nhìn được mỗi việc tốn bao nhiêu trước khi giao thêm việc lớn.

C.Người làm văn phòng, thử bảng điều khiển an toàn

Bạn chưa muốn để AI tự làm gì cả, chỉ muốn quan sát. Cài console theo đường plugin, mở /ruflo, rồi để Claude control ở mức mặc định là read + ask. Bạn có thể hỏi Claude về trạng thái các trang trong console mà không cho nó sửa gì.

Nếu muốn thử bước tiếp theo, README có một bài thực hành: chọn Settings → Claude control → write + ask, rồi yêu cầu:

text
Create a mission to add a dark mode toggle. Show me the mission and its status.

Claude sẽ mở trang Missions, đặt mục tiêu và chờ bạn xác nhận. Lưu ý quan trọng từ README: tạo mission không có nghĩa là tính năng đã được làm xong. Bạn có thể bấm Take back control bất cứ lúc nào để dừng Claude.

D.Dev dùng Codex hoặc công cụ MCP khác

Bạn không dùng Claude Code mà dùng một client MCP khác. Trỏ client tới server của Ruflo bằng command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Client sẽ thấy các công cụ MCP của Ruflo như bộ nhớ, swarm, agent. Bạn gọi chúng qua giao diện của client đó.

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

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

Lệnh /plugin install báo lỗi hoặc không tồn tại. README yêu cầu Claude Code bản 2.1.287 trở lên cho đường plugin (2.1.292 cho lệnh từ terminal). Kiểm tra phiên bản Claude Code và cập nhật nếu cũ.

npx báo lỗi phiên bản Node. package.json yêu cầu Node từ 20.0.0. Kiểm tra bằng node --version rồi nâng cấp nếu thấp hơn.

Chạy init nhầm thư mục. File được ghi vào thư mục hiện tại. Nếu nhầm, nên dùng Git để xem phần mới thêm rồi xoá có chọn lọc. Đừng xoá hàng loạt khi chưa xem. Nên thử trên thư mục nháp trước.

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

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

Điểm mạnh. Cài nhanh bằng một lệnh. Hỗ trợ cả Claude Code và Codex. Có bảng điều khiển để nhìn chi phí và log. Có cơ chế giới hạn quyền cho Claude khi dùng console. Mã nguồn mở, giấy phép MIT, và repo còn được cập nhật.

Giới hạn. Phạm vi rất rộng: README nhắc tới hàng trăm công cụ MCP, hàng chục lệnh và 48 plugin, nên người mới dễ choáng. Một số số liệu trong README không hoàn toàn khớp nhau giữa các đoạn, ví dụ số agent. Chính README cũng ghi rõ một số video demo dùng dữ liệu mẫu và không chứng minh việc swarm hoặc bộ nhớ đã hoàn thành công việc thật. Bạn nên tự kiểm chứng trên dự án nhỏ trước.

Khi nên chọn cách khác. Nếu bạn chỉ cần Claude Code sửa vài file đơn giản, dùng Claude Code thuần là đủ, không cần thêm lớp điều phối. Nếu chưa quen terminal và Git, hãy làm quen những thứ đó trước. Nếu dự án có dữ liệu nhạy cảm, hãy đọc kỹ mục bảo mật trong repo trước khi bật các tính năng như federation hay mod bên ngoài.

Lời khuyên của mình: thử trên một dự án nháp, giữ quyền ở mức read + ask, rồi mới tăng dần khi bạn đã quen.

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?

Repo dùng giấy phép MIT nên mã nguồn dùng tự do. Tuy nhiên bạn vẫn cần Claude Code hoặc Codex để chạy, và các dịch vụ đó có thể tính phí riêng. Tư liệu không nêu chi phí cụ thể của chúng.

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

Cách cơ bản chỉ là một lệnh `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code. Phần khó hơn là làm quen với các tính năng vì repo rất rộng. README khuyên bạn cứ dùng Claude Code bình thường sau khi init.

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

package.json của repo yêu cầu Node từ 20.0.0 trở lên. Nếu dùng đường plugin thì cần Claude Code bản 2.1.287 trở lên.

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

Tư liệu mình có không nêu rõ danh sách hệ điều hành hỗ trợ, nên chưa thể khẳng định. Bạn nên thử trên một thư mục nháp, và xem thêm README cùng thư mục docs trong repo.

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ạn cấu hình command là `npx` và arguments là `["-y", "ruflo@latest", "mcp", "start"]`. Cách nhập cụ thể tuỳ từng client.

Ruflo có tự làm những việc nguy hiểm mà không hỏi không?

Với bảng điều khiển, mặc định là read + ask. Hành động vượt quyền bị từ chối, còn các thao tác liên quan mạng, chi tiêu hoặc xoá vẫn phải xác nhận kể cả ở chế độ auto. Riêng các 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.

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

Claude Code thuần chỉ có mô hình cùng công cụ cơ bản. Ruflo thêm lớp điều phối: đội agent, bộ nhớ qua các phiên, hook, MCP server và bảng điều khiển theo dõi chi phí. Tư liệu chưa có so sánh hiệu năng cụ thể giữa hai cách.

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 dự án
    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 (không thêm file vào dự án)
    5. E.Cách khác: Codex hoặc MCP client khác
  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 mới: rà soát một dự án vừa nhận
    2. B.Chủ shop có website nhỏ: theo dõi chi phí token
    3. C.Người làm văn phòng, thử bảng điều khiển an toàn
    4. D.Dev dùng Codex hoặc công cụ MCP khác
  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ỏ.