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

Ruflo: điều phối nhóm 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 nhóm 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, tức lớp công cụ bao quanh Claude Code và Codex để cho nhiều agent phối hợp, có bộ nhớ và có kiểm soát. Bạn dùng nó để giao những việc lớn như rà soát repo, viết test, theo dõi chi phí. Cài khá dễ: chỉ cần Node 20 trở lên và chạy `npx ruflo@latest init` trong thư mục dự án.

Ruflo là một “agent harness”: lớp công cụ bao quanh Claude Code và Codex, giúp các AI agent có thêm công cụ, bộ nhớ, vòng lặp làm việc và giới hạn kiểm soát. Tác giả mô tả ngắn gọn: model là bên viết, còn harness là bàn làm việc để model làm được việc thật. Ruflo chính là phần bàn làm việc đó. Repo từng mang tên Claude Flow, hiện có khoảng 81.588 sao và 9.608 fork trên GitHub, giấy phép MIT.

Nếu bạn đã dùng Claude Code và thấy mỗi lần chỉ có một “trợ lý” làm từng việc một, Ruflo cho phép chia việc cho nhiều agent (gọi là swarm), nhớ lại kinh nghiệm giữa các phiên, và hiển thị tiến độ, token, chi phí trong một bảng điều khiển. Người nên thử là lập trình viên đã quen Claude Code, và người làm kỹ thuật muốn giao những việc nhiều bước như rà soát mã, viết test, tổng hợp thay đổi.

Điểm đáng giá nhất là cách vào cửa rất nhẹ. README nói bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI. Sau khi chạy init, bạn cứ dùng Claude Code như bình thường, hệ thống hooks sẽ tự định tuyến tác vụ và điều phối agent ở nền.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối bao quanh Claude Code và Codex: thêm agent chuyên biệt, bộ nhớ, hooks và MCP server 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 theo README, kèm lợi ích thực tế.

  • Nhiều agent làm việc theo nhóm. README nói Ruflo bổ sung hơn 100 agent chuyên biệt (ở đường cài bằng CLI là 98 agent). Thay vì một agent ôm hết, bạn giao một mục tiêu và các agent chia việc cho nhau.
  • Bộ nhớ qua nhiều phiên. Agent có thể nhớ giữa các lần làm việc, nên bạn đỡ phải giải thích lại bối cảnh dự án. README ghi rõ 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ấu hình.
  • Hooks tự động. Hooks định tuyến tác vụ và học từ những mẫu làm việc thành công, bạn không phải gọi tay.
  • MCP server. Claude Code, Codex hay client MCP khác đều nối vào được. Nhờ vậy Ruflo không bó chặt vào một công cụ.
  • Bảng điều khiển (console). Đây là “buồng lái” cạnh Claude Code: theo dõi workflow, agent, model, token và chi phí; mở nhật ký từng lần chạy, tìm kiếm, phân loại lỗi, phát lại và so sánh.
  • Cho Claude điều khiển console, nhưng có giới hạn. 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 là read + ask. Hành động liên quan mạng, chi tiêu hay phá huỷ vẫn phải xác nhận kể cả khi để auto.
  • 48 plugin cài riêng được. Gồm swarm, bộ nhớ RAG, sinh test (ruflo-testgen), theo dõi chi phí (ruflo-cost-tracker), quét bảo mật (ruflo-security-audit), chặn prompt injection (ruflo-aidefence), tài liệu (ruflo-docs) và nhiều nhóm khác.
  • Liên kết giữa các máy (federation). Agent trên máy khác có thể phối hợp với nhau; README nói là không làm lộ dữ liệu.

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

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

  • Node.js từ 20.0.0 trở lên (package.json yêu cầu >=20.0.0).
  • Claude Code nếu muốn dùng đường cài đầy đủ hoặc plugin. Đường chỉ cài plugin cần Claude Code 2.1.287 trở lên. Lệnh cài plugin từ terminal cần 2.1.292 trở lên.
  • Hoặc Codex / một client MCP khác nếu bạn không dùng Claude Code.
  • Một terminal mở đúng thư mục dự án của bạn.

Tư liệu không nói rõ về hệ điều hành, yêu cầu phần cứng hay API key cụ thể nào. Phần AI provider bạn dùng (ví dụ tài khoản Claude Code) là phần bạn tự có sẵn. Nếu cần chi tiết hơn, hãy xem README.md và thư mục docs/ trong repo.

Mod của Ruflo chạy với đúng quyền tài khoản của bạn và không bị đưa vào sandbox. README khuyên đọc mã trước khi cài. Hãy giữ mức điều khiển ở read + ask lúc mới thử, và chỉ nâng quyền khi bạn đã hiểu nó làm gì.

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

README có ba đường cài. Đường nhanh nhất là chạy init trong dự án.

  1. Kiểm tra NodeChắc chắn máy có Node 20 trở lên
  2. Mở terminal đúng thư mụcVào thư mục dự án bạn muốn dùng Ruflo
  3. Chạy initThêm agent, hooks, bộ nhớ và MCP server vào dự án
  4. Mở lại Claude CodeKhởi động Claude Code trong cùng thư mục để nó nhận cấu hình
  5. Giao một việc thậtĐưa một yêu cầu cụ thể để thử swarm

A.Kiểm tra Node và mở terminal

Mở terminal (PowerShell trên Windows, Terminal trên macOS) rồi đi tới thư mục dự án. Lệnh kiểm tra phiên bản Node là lệnh phổ thông:

Terminal
node --version

Kết quả phải là v20 trở lên. Chỗ người mới hay vấp: chạy lệnh ở sai thư mục, khiến file cấu hình nằm lẫn chỗ khác. Hãy cd vào đúng dự án trước.

B.Chạy init trong dự án

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

Terminal
npx ruflo@latest init

Lệnh này thêm agent, hooks, bộ nhớ và MCP server vào dự án. README cho biết đường cài này tạo các mục như .claude/, .claude-flow/, CLAUDE.md và file hỗ trợ, cùng cài đặt (settings). Nghĩa là dự án của bạn sẽ có thêm file, bạn nên dùng nó trong thư mục có quản lý phiên bản để 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:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code

Sau khi init, mở Claude Code trong 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 Claude Code đang mở sẵn, hãy đóng và mở lại.

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

Đường này không thêm file vào dự án, nhưng chỉ cho một phần chức năng (slash command, một số skill, định nghĩa agent). 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

Nếu dùng Claude Code 2.1.292 trở lên, bạn có thể cài từ terminal thường:

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

Lưu ý: các lệnh bắt đầu bằng dấu / gõ bên trong Claude Code, không phải trong terminal.

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

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

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

Tương đương dòng lệnh npx -y ruflo@latest mcp start. Cách điền cụ thể vào từng client thì README chưa ghi chi tiết, bạn xem tài liệu của client đó.

F.Chạy console trong terminal thường

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

Terminal
npx ruflo tui

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

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

Với đường init: mở lại Claude Code trong thư mục dự án rồi gõ /ruflo. README hướng dẫn quy trình “npx ruflo init, khởi động lại Claude Code, rồi /ruflo” để mở console. Bạn cũng nên thấy các thư mục .claude/ và .claude-flow/ cùng file CLAUDE.md trong dự án.

Với đường plugin: gõ /plugin và xem các plugin đã cài có hiện trong dòng “active mods” hay không. Trong console, lệnh /ruflo market mở Plugin Catalog, nơi bạn xem, bật, tắt và cập nhật plugin (mỗi hành động đều hỏi lại trước).

Với terminal độc lập: chạy npx ruflo tui và xem có hiện bảng điều khiển hay không.

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

A.Dev rà soát một repo cũ

Bạn vừa nhận một dự án chưa quen. Sau khi init và mở lại Claude Code, bạn 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: các agent tìm module rủi ro nhất, viết test cho nó và tóm tắt những gì đã đổi. Bạn vẫn nên tự đọc lại test và phần thay đổi trước khi chấp nhận.

B.Giao việc qua console nhưng giữ quyền kiểm soát

Bạn muốn thử cho Claude tự thao tác trên console mà không sợ nó làm bậy. Cách làm theo README: cài console, mở /ruflo, vào Settings → Claude control và chọn 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 mở trang Missions và đặt mục tiêu; bạn xác nhận hành động tạo. Sau đó kiểm tra Missions có mục tiêu mới và Overview có ghi lại hành động. README nhắc rõ: tạo mission không có nghĩa tính năng đã được làm. Nếu thấy không ổn, bấm Take back control để dừng.

Model viết mã, còn harness mới là thứ giúp nó làm việc được: công cụ, bộ nhớ, vòng lặp và giới hạn.

Ông T

C.Theo dõi chi phí và token khi chạy nhiều agent

Khi cho nhiều agent chạy cùng lúc, nỗi lo lớn là tốn token. Console của Ruflo hiển thị workflow, agent, model, token và chi phí cạnh Claude Code. Ngoài ra có plugin ruflo-cost-tracker để theo dõi token, đặt ngân sách và nhận cảnh báo chi phí. Cài bằng /plugin install ruflo-cost-tracker@ruflo theo cùng kiểu các plugin khác. Kết quả: bạn nhìn thấy mình đang tốn bao nhiêu trước khi hoá đơn đến.

D.Nhờ agent tìm test còn thiếu

Bạn là dev nhỏ, dự án ít test. Plugin ruflo-testgen được README mô tả là tìm test còn thiếu và tự sinh ra. Cài bằng /plugin install ruflo-testgen@ruflo, rồi nhờ Claude Code tìm phần chưa có test trong thư mục bạn chỉ định. Kết quả: danh sách chỗ thiếu test và các test đề xuất để bạn duyệt. README không cho prompt mẫu riêng cho plugin này, nên bạn có thể phải thử vài cách diễn đạt.

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

Claude Code không thấy agent hay lệnh sau khi init. Thường do chưa mở lại. Đóng Claude Code, mở lại trong đúng thư mục đã chạy init.

Lệnh /plugin báo không hợp lệ hoặc không cài được. Có thể Claude Code của bạn cũ. Đường plugin cần 2.1.287 trở lên, còn lệnh claude plugin install ở terminal cần 2.1.292 trở lên. Hãy cập nhật Claude Code.

npx báo lỗi hoặc cú pháp không chạy. Kiểm tra node --version; Ruflo yêu cầu Node 20 trở lên. Nếu thấp hơn, nâng cấp Node rồi chạy lại.

Tên công cụ MCP không giống tài liệu. README giải thích: plugin ruflo-core đăng ký MCP server riêng với tên dạng mcp__plugin_ruflo-core_ruflo__memory_store, khác với tên ngắn của đường CLI như memory_store. Nếu làm theo tài liệu CLI mà dùng đường plugin, tên sẽ lệch. Hãy chọn một đường và bám theo.

Cài cùng một plugin ngoài từ hai marketplace. Với agentic-qe-fleet, agentdb, agentic-flow, README dặn chỉ cài từ một marketplace, vì 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. Một lệnh init là có ngay bộ agent, hooks, bộ nhớ và MCP server. Có bảng điều khiển để nhìn thấy chuyện gì đang xảy ra. Có cơ chế phân quyền rõ (read, write, manage, full cùng ask hoặc auto), và hành động nhạy cảm vẫn phải xác nhận. Hoạt động với cả Claude Code lẫn Codex qua MCP. Giấy phép MIT và repo còn được cập nhật trong vài tháng gần đây.

Giới hạn. Hệ thống rất rộng (48 plugin, hàng trăm công cụ), nên người mới dễ choáng; hãy bắt đầu từ init và một việc cụ thể. README tự nói rõ một số phần chỉ là sơ đồ khái niệm, và các bản demo dùng dữ liệu mẫu, không chứng minh swarm đã hoàn tất việc thật hay bộ nhớ đã được gọi lại. Đường init thêm khá nhiều file vào dự án. Mod chạy với quyền tài khoản của bạn, không có sandbox. Tư liệu chưa cho biết chi phí token thực tế khi chạy swarm, bạn nên tự đo trên một việc nhỏ trước.

Khi nên chọn cách khác. Nếu bạn chỉ cần Claude Code làm việc đơn lẻ, không cần phối hợp nhiều agent, thì dùng Claude Code thuần là đủ và gọn hơn. Nếu bạn không biết lập trình hay không dùng terminal, công cụ này chưa phù hợp. Còn nếu bạn muốn thử nhẹ, đường cài plugin không thêm file nào vào dự án.

4.9/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 tự do. Tuy nhiên Ruflo điều phối Claude Code hoặc Codex, và chi phí của các dịch vụ AI đó nằm ngoài repo; tư liệu không nêu mức giá.

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

Claude Code là công cụ để AI viết mã. Ruflo là lớp bao quanh nó, thêm hơn 100 agent chuyên biệt, bộ nhớ, hooks, MCP server và bảng điều khiển. Sau khi init, bạn vẫn dùng Claude Code như bình thường.

Cần cài gì trước khi dùng?

Cần Node.js từ 20.0.0 trở lên. Nếu dùng đường plugin thì cần Claude Code 2.1.287 trở lên. Tư liệu chưa nói về yêu cầu phần cứng.

Có cần GPU không?

Tư liệu không nêu yêu cầu GPU cho đường cài cơ bản. Chỉ có plugin ruflo-ruvector được mô tả là có tìm kiếm tăng tốc bằng GPU, đó là một lựa chọn thêm.

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

Được. README nói Codex và các client MCP khác trỏ tới lệnh `npx -y ruflo@latest mcp start`, với command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. README cũng có lệnh `npx ruflo init --grok` cho Grok Build.

Claude có thể tự làm bậy trong console không?

Bạn đặt mức quyền (read, write, manage, full) và chế độ duyệt (ask hoặc auto). Mặc định hiện là read + ask. Hành động vượt quyền bị từ chối, còn 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ả khi để auto. Nút Take back control sẽ dừng việc Claude điều khiển.

Cài plugin và chạy init khác nhau thế nào?

Plugin không thêm file nào vào dự án và chỉ cho slash command, một số skill và định nghĩa agent. Còn `npx ruflo init` cho vòng làm việc đầy đủ: 98 agent, hơn 60 lệnh, 30 skill, MCP server, hooks và daemon, nhưng thêm các mục như .claude/, .claude-flow/ và CLAUDE.md vào dự án.

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 và mở terminal
    2. B.Chạy init trong dự án
    3. C.Mở lại Claude Code
    4. D.Cách khác: chỉ cài plugin Claude Code
    5. E.Cách khác: Codex hoặc client MCP khác
    6. F.Chạy console 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 rà soát một repo cũ
    2. B.Giao việc qua console nhưng giữ quyền kiểm soát
    3. C.Theo dõi chi phí và token khi chạy nhiều agent
    4. D.Nhờ agent tìm test còn thiếu
  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ỏ.