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

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 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 meta-harness: lớp công cụ đặt quanh Claude Code và Codex để thêm nhóm agent phối hợp, bộ nhớ qua nhiều phiên và các hook tự động. Bạn dùng nó để giao việc lớn như rà soát cả repo hay viết test cho Claude Code xử lý theo nhóm. Cài khá dễ: 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 “agent harness” (bộ khung điều phối) mã nguồn mở, đặt quanh Claude Code và Codex. Nói đơn giản: mô hình AI lo phần viết, còn Ruflo lo phần còn lại, gồm công cụ, bộ nhớ, vòng lặp kiểm tra và các giới hạn an toàn để AI làm việc có tổ chức hơn. README mô tả công thức là “Agent = Model + Harness”, và Ruflo là phần harness.

Repo này dành cho người đã dùng Claude Code (hoặc Codex) và thấy một agent đơn lẻ làm chưa đủ: việc lớn cần chia nhỏ, cần nhớ lại kinh nghiệm từ lần trước, cần có ai đó kiểm lại kết quả. Lập trình viên mới, người làm kỹ thuật trong doanh nghiệp nhỏ, hay người muốn thử “đội AI” đều dùng được, miễn là bạn quen mở terminal và gõ vài lệnh.

Đ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 bạn cứ dùng Claude Code như bình thường. README nói không cần học hết hàng trăm công cụ MCP hay hàng chục lệnh CLI, vì sau init hệ thống hook sẽ tự định tuyến việc và phối hợp agent ở phía sau. Repo hiện có khoảng 81.600 sao và 9.600 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

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 ruflo init.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Mỗi tính năng dưới đây mình diễn giải theo lợi ích thực tế, không chép nguyên README.

  • Nhóm agent phối hợp (swarm). Thay vì một agent làm tất cả, Ruflo cho nhiều agent chuyên biệt chia việc. README nói có hơn 100 agent chuyên biệt. Lợi ích: việc dài như “tìm module rủi ro nhất, viết test, tóm tắt thay đổi” được chia thành các phần rõ ràng.
  • Bộ nhớ qua nhiều phiên. Agent có thể nhớ kinh nghiệm từ các lần làm trước và dùng lại khi định tuyến việc mới. Bạn đỡ phải giải thích lại cùng một bối cảnh mỗi lần mở Claude Code.
  • Hook tự động. Sau init, hook tự định tuyến tác vụ và học từ những mẫu làm thành công, bạn không phải gọi từng công cụ.
  • MCP server. Ruflo chạy như một MCP server, nên Codex hoặc các ứng dụng khách MCP khác cũng dùng được, không chỉ Claude Code.
  • Bảng điều khiển (console) ngay cạnh Claude Code. Bạn theo dõi workflow, agent, model, token và chi phí; mở log, 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 điều khiển, nhưng có giới hạn. 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 liên quan mạng, chi tiêu hoặc phá hủy vẫn đòi xác nhận kể cả ở chế độ auto.
  • Hệ plugin. README liệt kê 48 plugin (cộng thêm 3 plugin bên ngoài), chia nhóm: điều phối, bộ nhớ, học tập, chất lượng code và test, bảo mật, DevOps (có theo dõi chi phí token)… Bạn chỉ cài cái cần.
  • Liên kết giữa nhiều máy (federation). Agent trên các máy khác nhau có thể nói chuyện với nhau mà README cho biết không làm lộ dữ liệu. Tính năng này dành cho người dùng nâng cao, người mới có thể bỏ qua.

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

Tư liệu nêu những điều sau:

  • Node.js từ phiên bản 20 trở lên. package.json yêu cầu >=20.0.0. Lệnh npx đi kèm Node.
  • Claude Code (hoặc Codex, hoặc một ứng dụng khách MCP khác). Đường cài bằng plugin cần Claude Code 2.1.287 trở lên. Lệnh claude plugin install chạy từ terminal cần 2.1.292 trở lên.
  • Một thư mục dự án để chạy init, vì lệnh này thêm file vào chính thư mục đó.
  • Kết nối Internet để npx tải gói về.

README không nói về yêu cầu GPU, dung lượng ổ đĩa hay hệ điều hành cụ thể, nên mình không khẳng định gì thêm. Phần cứng và API key riêng cho Ruflo cũng chưa thấy nêu trong phần README mình có; bạn vẫn cần tài khoản và quyền dùng Claude Code hoặc Codex như bình thường.

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

README có ba đường cài. Đường chính là chạy init trong dự án. Mình tóm tắt trước rồi đi từng bước.

  1. Mở terminal đúng chỗVào thư mục dự án của bạn
  2. Chạy initnpx ruflo@latest init
  3. Mở lại Claude CodeMở trong cùng thư mục để nó nhận agent, hook, bộ nhớ
  4. Giao một việc thậtDán câu lệnh mẫu vào Claude Code
  5. (Tuỳ chọn) Mở bảng điều khiểnGõ /ruflo trong Claude Code

A.Mở terminal trong 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ên bạn phải đứng đúng thư mục dự án trước khi chạy. Trên Windows, bạn có thể mở thư mục dự án trong File Explorer rồi mở PowerShell từ đó. Hoặc dùng cd để di chuyển:

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

Thay duong-dan-toi-du-an-cua-ban bằng đường dẫn thật. Nếu muốn thử trên một dự án trống, bạn có thể tự tạo thư mục mới rồi cd vào.

B.Chạy lệnh init

Terminal
npx ruflo@latest init

npx tải bản mới nhất của Ruflo và chạy ngay, không cần cài toàn cục. README cho biết lệnh này thêm agent, hook, bộ nhớ và MCP server của Ruflo vào dự án. Phần so sánh trong README nêu các thứ được tạo ra gồm .claude/, .claude-flow/, CLAUDE.md, các file hỗ trợ và settings. Nếu dự án đã có file CLAUDE.md của bạn, hãy sao lưu hoặc dùng Git để xem lại thay đổi sau khi chạy.

Nếu muốn thiết lập 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 trong cùng thư mục

Claude Code chỉ nhận các thứ mới ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn, hãy thoát rồi mở lại, đúng thư mục vừa chạy init.

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

Nếu bạn chỉ muốn thử, README có đường cài plugin. Đường này không thêm file vào dự án và cần Claude Code 2.1.287 trở lên. Bạ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 dòng đầu thêm “chợ” plugin của Ruflo và cài ba plugin: lõi, bảng điều khiển và mods. Dòng /reload-plugins nạp lại plugin, còn /ruflo mở bảng điều khiển. Từ terminal, với Claude Code 2.1.292 trở lên, README ghi thêm lệnh:

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

Mods 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 bạn đọc code của mod trước khi cài. Đường plugin chỉ cho bạn một phần tính năng; theo bảng so sánh trong README, muốn đủ vòng làm việc (agent, lệnh, skill, MCP server, hook, daemon) thì dùng `npx ruflo@latest init`.

E.Dùng với Codex hoặc ứng dụng MCP khác

Không cần thiết lập dự án. Bạn cấu hình ứng dụng khách MCP với command là npx và arguments là ["-y", "ruflo@latest", "mcp", "start"]. Tương đương lệnh sau:

Terminal
npx -y ruflo@latest mcp start

Chỗ điền cấu hình phụ thuộc từng ứng dụng khách; README chưa hướng dẫn riêng cho từng loại, bạn xem tài liệu của ứng dụng đó.

F.Chạy bảng điều khiển trong terminal thường

Bảng điều khiển cũng chạy độc lập, không cần Claude Code:

Terminal
npx ruflo tui

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

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

README không đưa ra một lệnh “kiểm tra phiên bản” riêng, nên mình chỉ nêu các dấu hiệu có trong tư liệu:

  • Sau npx ruflo@latest init, trong thư mục dự án có các mục như .claude/, .claude-flow/ và CLAUDE.md.
  • Mở lại Claude Code, gõ /ruflo thì bảng điều khiển hiện ra.
  • Với đường plugin, gõ /plugin và kiểm tra các plugin đã cài có nằm trong dòng “active mods”.
  • Gõ npx ruflo tui trong terminal sẽ mở bảng điều khiển bản terminal.

Nếu /ruflo không hiện, hãy thử /reload-plugins hoặc khởi động lại Claude Code.

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

Bạn có thể bắt đầu bằng việc cụ thể, vừa sức, rồi mới tăng dần quyền cho agent.

A.Lập trình viên mới: rà soát cả dự án thừa kế

Bạn nhận lại một dự án từ đồng nghiệp, không biết chỗ nào dễ hỏng. Sau khi chạy init và mở lại Claude Code, bạn dán đúng câu README gợi ý:

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 yêu cầu một nhóm agent tìm module rủi ro nhất, viết test cho nó và tóm tắt thay đổi. Kết quả bạn nhận được là danh sách thay đổi cùng các file test mới. Hãy đọc kỹ và chạy test trước khi giữ lại, vì AI vẫn có thể sai.

Agent không chỉ chạy, mà phải hợp tác — Ruflo lo phần phối hợp, bạn giữ phần quyết định.

Ông T

B.Người phụ trách nhóm: xem agent đang làm gì và tốn bao nhiêu

Bạn giao việc cho Claude Code và muốn biết nó đang chạy cái gì, hết bao nhiêu token. Cài ruflo-console rồi gõ /ruflo. Theo README, bảng điều khiển hiển thị workflow, agent, model, token và chi phí. Bạn mở log của từng agent, tìm kiếm, xem lại các lần chạy thất bại và so sánh. README cũng có plugin ruflo-cost-tracker để theo dõi token, đặt ngân sách và nhận cảnh báo chi phí. Nếu muốn cài, bạn dùng cùng mẫu lệnh /plugin install ten-plugin@ruflo như các plugin khác.

C.Thử cho Claude điều khiển bảng điều khiển, có kiểm soát

Đây là bài thử an toàn theo README. Cài console, mở /ruflo, vào Settings → Claude control và chọn write + ask. Rồi nhờ Claude:

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 đang chờ. Sau đó kiểm tra Missions có mục tiêu mới và Overview có ghi lại hành động. README nhấn mạnh: tạo mission không có nghĩa tính năng đã được viết. Muốn dừng, bấm Take back control; lần gọi tiếp theo của Claude sẽ bị từ chối cho tới khi bạn trả quyền lại.

D.Người dùng Codex hoặc công cụ MCP khác

Bạn không dùng Claude Code mà dùng Codex. Bạn trỏ ứng dụng khách MCP tới npx -y ruflo@latest mcp start như phần cài đặt ở trên. Khi đó các công cụ của Ruflo (bộ nhớ, phối hợp agent) có mặt trong ứng dụng của bạn. README chưa liệt kê chi tiết từng ứng dụng khách đã thử, nên bạn nên thử trên một dự án nhỏ trước.

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

  • npx báo không tìm thấy lệnh hoặc lỗi phiên bản. Có thể Node chưa được cài hoặc quá cũ. package.json yêu cầu Node 20 trở lên. Cài hoặc nâng cấp Node rồi mở terminal mới và chạy lại.
  • Chạy init nhưng Claude Code không thấy gì. Thường do bạn chưa mở lại Claude Code, hoặc mở sai thư mục. Thoát, mở lại Claude Code đúng thư mục đã chạy init.
  • Lệnh /plugin hoặc claude plugin install không chạy. Đường plugin cần Claude Code 2.1.287 trở lên (lệnh từ terminal cần 2.1.292 trở lên). Cập nhật Claude Code trước. Nhớ rằng các lệnh bắt đầu bằng / gõ trong Claude Code, không gõ trong PowerShell.
  • File trong dự án bị thay đổi sau init. Lệnh này thêm .claude/, .claude-flow/, CLAUDE.md và file phụ trợ. Hãy dùng Git (commit trước khi chạy) để xem và hoàn tác nếu cần. Nếu không muốn đụng vào dự án, dùng đường plugin hoặc MCP.
  • Cài cùng một plugin ngoài từ hai “chợ”. README cảnh báo với các plugin ngoài như agentic-qe-fleet, agentdb, agentic-flow: chỉ nên cài từ một marketplace, nếu bậ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, có bảng điều khiển để nhìn thấy agent làm gì, có giới hạn quyền rõ ràng (read, write, manage, full; ask hoặc auto), giấy phép MIT, và dự án được cập nhật gần đây. Hệ plugin lớn nên bạn chọn đúng phần cần.

Giới hạn. Dự án rất lớn (hàng trăm công cụ, hàng chục lệnh, hàng chục plugin), nên người mới dễ choáng. Một số phần như federation hay chạy tự động không giám sát chỉ hợp người đã quen. README cũng tự nói rõ nhiều đoạn demo dùng dữ liệu mẫu, không phải bằng chứng cho việc hoàn thành công việc swarm hay nhớ lại bộ nhớ. Hãy kiểm chứng kết quả bằng chính dự án của bạn.

Khi nào chọn cách khác. Nếu bạn chỉ cần Claude Code làm vài việc nhỏ, dùng Claude Code thuần là đủ, đỡ thêm file vào dự án. Nếu bạn chỉ muốn thử vài lệnh, đường plugin nhẹ hơn. Nếu bạn làm việc với dữ liệu nhạy cảm, hãy đọc kỹ file SECURITY.md trong repo trước khi bật các chế độ tự động.

Đặt mức quyền thấp (read + ask) khi mới thử. Đừng bật `auto` ở mức quyền cao cho tới khi bạn đã xem log và hiểu agent làm gì. Việc chạy nhiều agent có thể tốn nhiều token hơn bình thường, nên hãy theo dõi chi phí.

4.0/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 Ruflo dùng giấy phép MIT nên bạn dùng miễn phí. Tuy nhiên bạn vẫn cần quyền dùng Claude Code hoặc Codex, và chi phí của các dịch vụ AI đó tính riêng. README có plugin theo dõi token và ngân sách để bạn kiểm soát chi phí.

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

Claude Code thuần là một agent đơn lẻ. Ruflo là lớp harness bọc quanh nó, thêm nhiều agent chuyên biệt phối hợp thành nhóm, bộ nhớ qua nhiều phiên, hook tự động, MCP server và bảng điều khiển. Bạn vẫn dùng Claude Code như bình thường, Ruflo làm việc ở phía sau.

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

Cần Node.js từ phiên bản 20 trở lên và Claude Code (hoặc Codex, hoặc ứng dụng MCP khác). Đường cài plugin cần Claude Code 2.1.287 trở lên. README không nêu yêu cầu GPU hay dung lượng ổ đĩa.

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

Tư liệu mình có không nói riêng về hệ điều hành. Lệnh `npx ruflo@latest init` chạy dựa trên Node 20 trở lên, nên về nguyên tắc dùng được ở nơi có Node. Bạn nên thử trên một dự án nhỏ, và xem README cùng phần issue trong repo để chắc chắn.

Chạy init có làm thay đổi dự án của tôi không?

Có. README cho biết lệnh này thêm agent, hook, bộ nhớ và MCP server vào dự án, bao gồm các mục như `.claude/`, `.claude-flow/` và `CLAUDE.md`. Nên commit bằng Git trước khi chạy. Nếu không muốn thêm file, hãy dùng đường cài bằng plugin, vốn không thêm file vào dự án.

Claude có tự ý làm việc nguy hiểm trong bảng điều khiển không?

Theo README, bạn chọn 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, và hành động liên quan mạng, chi tiêu hoặc phá hủy vẫn cần xác nhận kể cả ở chế độ auto. Bạn có thể bấm Take back control để dừng.

Dữ liệu của tôi có an toàn không?

README nói Ruflo có các rào chắn bảo mật cho doanh nghiệp, và các plugin như aidefence (chặn prompt injection, phát hiện thông tin cá nhân). Mức an toàn cụ thể cho dữ liệu của bạn thì chưa có thông tin chi tiết trong phần README mình có. Hãy đọc file SECURITY.md trong repo và xem lại mod 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 trong thư mục dự án
    2. B.Chạy lệnh init
    3. C.Mở lại Claude Code trong cùng thư mục
    4. D.Cách khác: chỉ cài bằng plugin (không thêm file vào dự án)
    5. E.Dùng với Codex hoặc ứng dụng MCP khác
    6. F.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.Lập trình viên mới: rà soát cả dự án thừa kế
    2. B.Người phụ trách nhóm: xem agent đang làm gì và tốn bao nhiêu
    3. C.Thử cho Claude điều khiển bảng điều khiển, có kiểm soát
    4. D.Người 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ỏ.