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

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 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ụ bọc quanh Claude Code và Codex để nhiều agent phối hợp thành swarm, có bộ nhớ qua các phiên làm việc. Cài bằng một lệnh npx trong thư mục dự án, cần Node từ 20 trở lên. Với người mới, cài không khó, nhưng hệ thống rất lớn nên nên bắt đầu từ một tác vụ nhỏ.

Ruflo là một "agent harness" (bộ khung điều khiển agent) dành cho Claude Code và Codex. Hiểu đơn giản: mô hình AI là bộ não biết viết code, còn harness là bàn làm việc xung quanh, gồm công cụ, bộ nhớ, vòng lặp và các lớp kiểm soát để AI làm việc thật sự. Ruflo chính là phần bàn làm việc đó. Trước đây dự án có tên Claude Flow.

Vấn đề repo giải quyết: khi dùng Claude Code, mỗi phiên thường làm một mình, quên sạch sau khi đóng, và bạn phải tự chia việc. Ruflo thêm các agent chuyên biệt, cho chúng phối hợp thành nhóm (swarm), và lưu lại kinh nghiệm để lần sau làm tốt hơn. Bạn vẫn viết yêu cầu như bình thường, phần điều phối chạy nền.

Người nên thử: lập trình viên đang dùng Claude Code hoặc Codex hằng ngày, và người làm kinh doanh, văn phòng đã quen terminal cơ bản, muốn giao việc dài cho AI. Hiện repo có khoảng 81.600 sao và khoảng 9.600 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong 3 tháng gần đây. Điểm đáng giá nhất: cài chỉ một lệnh, và có cả đường cài nhẹ bằng plugin, không đụng vào file dự án của bạn.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) bọc quanh Claude Code và Codex, thêm agent chuyên biệt, bộ nhớ dài hạn, hook và MCP server chỉ với một lệnh init.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Theo README, Ruflo thêm cho Claude Code và Codex những thứ sau:

  • Nhiều agent chuyên biệt chạy thành swarm. Thay vì một AI làm tất cả, các agent chia việc và phối hợp. README nhắc tới hơn 100 agent chuyên biệt (bảng so sánh ghi 98 agent). Lợi ích: một yêu cầu lớn như "rà soát cả repo" được chia nhỏ, làm song song.
  • Bộ nhớ qua nhiều phiên. Agent nhớ lại thông tin từ các lần làm trước, dùng tìm kiếm vector. Bạn đỡ phải giải thích lại bối cảnh dự án mỗi lần mở Claude Code.
  • Học từ tác vụ thành công. Hệ thống định tuyến công việc và học từ mẫu làm tốt. README ghi rõ đây là mô tả khái niệm, và phần học cục bộ vẫn cần embedding cùng các module học được cấu hình.
  • Hook tự định tuyến. Sau khi init, bạn cứ dùng Claude Code như thường, hook tự chọn cách xử lý và phối hợp agent ở nền. Bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI.
  • Bảng điều khiển (console) cạnh Claude Code. Xem workflow, agent, mô hình, token và chi phí. Mở bằng lệnh /ruflo. Có thể xem log, tìm kiếm, phát lại và so sánh các lần chạy.
  • Cho Claude điều khiển console, 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 hiện tại là read + ask. Hành động liên quan mạng, chi tiêu hoặc phá huỷ luôn cần bạn xác nhận, kể cả khi để auto.
  • Hệ sinh thái plugin. README liệt kê 48 plugin (cộng 3 plugin bên ngoài): swarm, bộ nhớ RAG, sinh test, quét bảo mật, theo dõi chi phí, tài liệu tự động và nhiều thứ khác.
  • Federation. Agent trên các máy khác nhau có thể phối hợp với nhau. Phần này nâng cao, người mới chưa 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 yêu cầu >=20.0.0).
  • Claude Code nếu dùng đường cài bằng plugin: cần bản 2.1.287 trở lên. Riêng lệnh cài từ terminal (claude plugin install ...) cần Claude Code 2.1.292 trở lên.
  • Một thư mục dự án để chạy lệnh init.
  • Nếu dùng Codex hoặc client MCP khác: client đó phải cấu hình được một MCP server chạy bằng lệnh.

Tư liệu không nói rõ hệ điều hành nào được hỗ trợ, không nêu yêu cầu GPU, và không nói cần API key riêng của Ruflo hay không. Bạn vẫn cần tài khoản/quyền dùng Claude Code hoặc Codex như bình thường. Mục tên miền hay giá tiền của dịch vụ đi kèm, bạn nên xem thêm ở README trong repo.

Mod và plugin chạy với quyền tài khoản của bạn và không được cô lập (sandbox). README khuyên đọc mã của chúng trước khi cài. Hãy thử trong một thư mục dự án nhỏ, không chứa dữ liệu quan trọng, trước khi dùng cho việc thật.

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

Ruflo có ba đường cài. Đường chính (CLI) cho đầy đủ tính năng; đường plugin nhẹ hơn và không thêm file vào dự án.

  1. Mở terminal đúng thư mụcVào thư mục dự án bạn muốn dùng Ruflo
  2. Chạy initMột lệnh npx thêm agent, hook, bộ nhớ và MCP server vào dự án
  3. Khởi động lại Claude CodeMở Claude Code trong cùng thư mục để nó nhận cấu hình mới
  4. Mở consoleGõ /ruflo để xem bảng điều khiển
  5. Giao việc thửĐưa một tác vụ nhỏ có thật cho Claude Code

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

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. Chỗ người mới hay vấp là chạy ở thư mục sai (ví dụ thư mục người dùng), khiến file bị tạo lẫn lộn. Nếu chưa có dự án, hãy tạo một thư mục thử rồi cd vào. Nếu bạn muốn lấy mã nguồn Ruflo về máy để đọc, dùng lệnh phổ thông sau:

Terminal
git clone https://github.com/ruvnet/ruflo.git
cd ruflo

Nhưng để dùng Ruflo cho dự án của bạn thì không cần clone. Chỉ cần lệnh ở bước kế tiếp.

B.Chạy lệnh init

Chạy trong thư mục dự án của bạn:

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. Lệnh init thêm agent, hook, bộ nhớ và MCP server vào dự án. Theo bảng so sánh trong README, đường này tạo các thư mục/file như .claude/, .claude-flow/, CLAUDE.md, file hỗ trợ và settings.

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.Khởi động lại Claude Code và mở console

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

text
/ruflo

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

Đường này cài công cụ lõi, console và mod, không tạo file trong dự án. Gõ lần lượt bên trong Claude Code (cần bản 2.1.287 trở lên):

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 lệnh này gõ trong khung chat của Claude Code, không gõ vào terminal thường. Nếu muốn cài từ terminal (Claude Code 2.1.292 trở lên):

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

Ngoài ra có thể cài thêm plugin lẻ, ví dụ ruflo-swarm, ruflo-rag-memory:

text
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo

Lưu ý từ README: đường plugin chỉ cho slash command, vài skill và định nghĩa agent. Hook không được cài, và MCP server chỉ có khi cài ruflo-core. Muốn đầy đủ tính năng thì dùng đường npx ruflo@latest init.

E.Dùng với Codex hoặc client MCP khác

Không cần thiết lập dự án. Trong client, cấu hình command là npx và arguments như sau:

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

Hoặc nếu client nhận một dòng lệnh duy nhất:

Terminal
npx -y ruflo@latest mcp start

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

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

Terminal
npx ruflo tui

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

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

Tư liệu không đưa ra một lệnh "kiểm tra phiên bản" riêng, nên bạn dựa vào các dấu hiệu sau:

  1. Sau npx ruflo@latest init, thư mục dự án có thêm .claude/, .claude-flow/ và CLAUDE.md (theo bảng so sánh trong README).
  2. Mở lại Claude Code trong thư mục đó, gõ /ruflo: console hiện ra là thành công.
  3. Với đường plugin: gõ /plugin rồi kiểm tra các plugin đã cài có nằm trong dòng mod đang hoạt động.
  4. Với console độc lập: npx ruflo tui hiện giao diện terminal.

Bài kiểm tra thực tế hơn là làm theo ví dụ trong README: vào Settings → Claude control, chọn write + ask, rồi yêu cầu Claude: "Create a mission to add a dark mode toggle. Show me the mission and its status." Bạn sẽ thấy Claude mở trang Missions, đặt mục tiêu và chờ bạn xác nhận thao tác tạo. Sau khi bạn đồng ý, mission xuất hiện trong Missions và hành động được ghi ở Overview. Chú ý: tạo mission không có nghĩa tính năng đã được làm xong.

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

Các tình huống dưới đây bám đúng khả năng được README nêu. Kết quả cụ thể phụ thuộc dự án và mô hình bạn dùng.

A.Dev rà soát một repo lạ và viết test

Bối cảnh: bạn vừa nhận một dự án cũ, không ai nhớ module nào dễ lỗi. 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: một nhóm 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 đọc phần tóm tắt, chạy test, rồi quyết định giữ hay bỏ.

Agent = Model + Harness. Mô hình viết, còn harness cho nó công cụ, trí nhớ và giới hạn để làm việc thật.

Ông T

B.Trưởng nhóm theo dõi việc và chi phí của AI

Bối cảnh: bạn quản lý vài người cùng dùng AI viết code và muốn biết agent đang làm gì, tốn bao nhiêu token. Cài console theo đường plugin hoặc init, rồi mở /ruflo. README mô tả bảng điều khiển này theo dõi workflow, agent, mô hình, token và chi phí. Bạn mở log của từng lần chạy, tìm lần lỗi, phát lại và so sánh. Plugin ruflo-cost-tracker trong danh sách cũng có chức năng đặt ngân sách và cảnh báo chi phí.

C.Người mới thử giao việc có kiểm soát

Bối cảnh: bạn không muốn AI tự ý làm gì quá tay. Trong console, vào Settings → Claude control, chọn mức read hoặc write cùng chế độ ask. Claude chỉ điều hướng và chạy các hành động trong giới hạn bạn đặt; 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ỷ luôn cần bạn xác nhận. Nếu thấy lo, bấm Take back control để dừng ngay. Cách này giúp bạn làm quen từng bước thay vì giao toàn quyền.

D.Dev cần agent nhớ và tìm lại tri thức dự án

Bối cảnh: dự án có nhiều tài liệu và quyết định kiến trúc, mỗi phiên Claude Code lại "quên". Bạn cài thêm plugin bộ nhớ:

text
/plugin install ruflo-rag-memory@ruflo

Theo README, plugin này cho tìm kiếm thông minh kiểu hybrid, graph hops và xếp hạng đa dạng. ruflo-rvf lưu và khôi phục bộ nhớ agent qua các phiên. Hãy tự thử trên một dự án nhỏ để đánh giá độ hữu ích thực tế, vì README cũng lưu ý các bản demo dùng dữ liệu mẫu, chưa chứng minh việc nhớ lại hay swarm đã hoàn thành.

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

Chạy npx ruflo@latest init báo lỗi hoặc không chạy được. Kiểm tra phiên bản Node bằng node --version. Repo yêu cầu từ 20.0.0 trở lên. Nếu thấp hơn, hãy nâng cấp Node rồi chạy lại.

Gõ /plugin ... mà không có tác dụng. Có thể Claude Code của bạn quá cũ. Đường plugin cần bản 2.1.287 trở lên (2.1.292 nếu cài từ terminal bằng claude plugin install). Cập nhật Claude Code rồi thử lại. Nhớ gõ các lệnh /plugin bên trong Claude Code, không gõ vào terminal thường.

Cài xong mà không thấy gì mới. Thoát hẳn Claude Code rồi mở lại trong đúng thư mục đã chạy init. Với plugin, chạy /reload-plugins. Rồi gõ /ruflo để kiểm tra.

Cài một plugin hai lần. README cảnh báo với vài 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 nơi, mod và lệnh sẽ bị nạp hai lần. Hãy gỡ một bản.

Claude làm quá tay hoặc bạn lo về quyền. Vào Settings → Claude control, hạ xuống read + ask, hoặc bấm Take back control. Với mod và plugin, đọc mã trước khi cài vì chúng chạy bằng quyền tài khoản của bạn.

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

Điểm mạnh: cài nhanh bằng một lệnh; có đường cài nhẹ không đụng file dự án; giấy phép MIT; cộng đồng lớn (khoảng 81.600 sao) và repo vẫn được cập nhật; có console để nhìn thấy agent đang làm gì; có cơ chế đặt giới hạn quyền cho Claude.

Giới hạn: hệ thống rất rộng (hàng trăm công cụ MCP, hàng chục lệnh và 48 plugin), người mới dễ choáng. Một số bản demo trong README dùng dữ liệu mẫu, và README tự nói phần học là "khái niệm", cần embedding và module cấu hình. Tư liệu cũng chưa nêu rõ yêu cầu hệ điều hành, chi phí token khi chạy nhiều agent, hay cách vận hành chi tiết cho từng loại dự án.

Nên chọn cách khác khi: bạn chỉ cần Claude Code làm việc đơn giản, một file một lần. Khi đó dùng Claude Code thuần là đủ. Hoặc khi dự án có dữ liệu nhạy cảm và bạn chưa có thời gian đọc mã hook, mod. Lời khuyên của mình: bắt đầu bằng đường plugin hoặc một dự án thử, giao một tác vụ nhỏ, xem console để hiểu agent làm gì, rồi mới mở rộng.

4.8/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 và sửa mã được tự do. Tuy nhiên bạn vẫn cần quyền dùng Claude Code hoặc Codex như bình thường, và tư liệu chưa nêu rõ chi phí token khi chạy nhiều agent. Plugin cost-tracker giúp theo dõi token và đặt ngân sách.

Cần cài những gì trước khi chạy Ruflo?

Cần Node.js từ phiên bản 20.0.0 trở lên. Nếu dùng đường plugin thì cần Claude Code từ 2.1.287 (2.1.292 nếu cài từ terminal). Tư liệu không nêu thêm yêu cầu nào khác.

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

Tư liệu không nói rõ hệ điều hành nào được hỗ trợ. Lệnh cài là lệnh npx chung, chạy ở terminal có Node 20 trở lên. Bạn nên tự thử trên dự án nhỏ trước, hoặc xem README và mục Issues trong repo.

Có cần GPU không?

Tư liệu không nêu yêu cầu GPU cho phần cài đặt cơ bản. README có nhắc plugin ruvector hỗ trợ tìm kiếm tăng tốc GPU, nhưng đó là một plugin riêng, không phải yêu cầu bắt buộc.

Cài Ruflo có làm thay đổi dự án của tôi không?

Có nếu dùng `npx ruflo@latest init`: nó thêm các thư mục và file như .claude/, .claude-flow/, CLAUDE.md, file hỗ trợ và settings. Nếu muốn không thêm file nào, dùng đường plugin Claude Code, README ghi là không có file nào trong workspace. Riêng `init --grok` có thêm cờ `--dry-run` để xem trước.

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

Claude Code thuần là một agent làm việc đơn lẻ. Ruflo là lớp bọc thêm agent chuyên biệt, swarm, bộ nhớ qua nhiều phiên, hook tự định tuyến và bảng điều khiển. Đổi lại hệ thống phức tạp hơn nên đường học sẽ dài hơn.

Claude có tự ý làm việc nguy hiểm qua console không?

Theo README, mặc định là read + ask. Hành động vượt mức quyền bị từ chối, còn hành động liên quan mạng, chi tiêu hoặc phá huỷ luôn cần bạn xác nhận, kể cả khi để auto. Bạn có thể bấm Take back control để dừng ngay.

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
    2. B.Chạy lệnh init
    3. C.Khởi động lại Claude Code và mở console
    4. D.Cách khác: chỉ cài plugin Claude Code (không thêm file vào dự án)
    5. E.Dùng với 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 lạ và viết test
    2. B.Trưởng nhóm theo dõi việc và chi phí của AI
    3. C.Người mới thử giao việc có kiểm soát
    4. D.Dev cần agent nhớ và tìm lại tri thức dự án
  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ỏ.