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 agent harness: lớp công cụ bọc quanh Claude Code và Codex, thêm agent chuyên biệt, bầy agent phối hợp, bộ nhớ qua nhiều phiên và MCP server. Bạn dùng nó để Claude Code làm việc có tổ chức hơn trên dự án thật. Cài chỉ cần một lệnh `npx ruflo@latest init` trong thư mục dự án, với điều kiện đã có Node 20 trở lên.

Ruflo là một "agent harness" mã nguồn mở: lớp công cụ bọc quanh Claude Code và Codex để AI không chỉ trả lời từng câu mà làm việc có tổ chức. Nó thêm vào dự án của bạn các agent chuyên biệt, hook, bộ nhớ và một MCP server. Repo này trước đây có tên Claude Flow, do Reuven Cohen (rUv) xây dựng, giấy phép MIT.

Một cách hiểu đơn giản: mô hình AI là người viết, còn harness là cái bàn làm việc quanh nó. Bàn làm việc đó gồm công cụ, trí nhớ, vòng lặp và các hàng rào kiểm soát. Ruflo là cái bàn ấy cho Claude Code và Codex. Repo hiện có khoảng 81.582 sao và 9.607 fork, vẫn được cập nhật trong 3 tháng gần đây.

Bạn nên đọc bài này nếu đang dùng Claude Code hoặc Codex và muốn giao những việc lớn hơn, như rà soát cả repo, viết test, chia việc cho nhiều agent. Điểm đáng giá nhất là cách cài rất gọn: một lệnh, rồi dùng Claude Code như bình thường. Phần điều phối chạy ngầm phía sau.

Framework

ruvnet/ruflo

Ruflo là lớp điều phối 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 có rất nhiều thành phần (406 công cụ MCP, 61 lệnh CLI). Nhưng README cũng nói rõ bạn không cần học hết. Sau khi init, bạn cứ dùng Claude Code bình thường, hệ thống hook sẽ tự định tuyến tác vụ và phối hợp agent ở nền. Dưới đây là những phần đáng chú ý nhất.

  • Agent chuyên biệt và bầy agent (swarm). Bạn có hơn 100 agent chuyên biệt. Chúng được tổ chức thành nhóm cùng làm một việc. Lợi ích: một yêu cầu lớn được chia nhỏ, thay vì dồn hết cho một cuộc hội thoại duy nhất.
  • Bộ nhớ qua nhiều phiên. Agent nhớ được kinh nghiệm từ lần làm trước. README mô tả luồng: bộ nhớ đưa kinh nghiệm hữu ích quay lại để định tuyến những tác vụ sau. README cũng lưu ý đây là sơ đồ khái niệm, không phải bản ghi một lần chạy thật.
  • Bảng điều khiển (console) cạnh Claude Code. Bạn theo dõi workflow, agent, mô hình, token và chi phí. Bạn có thể mở nhật ký từng agent, tìm kiếm, xem lại và so sánh các lần chạy.
  • Cho Claude lái, bạn đặt giới hạn. Trong Settings → Claude control, 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. Các hành động liên quan mạng, chi tiền hoặc phá huỷ luôn cần bạn xác nhận, kể cả khi để auto.
  • 48 plugin. Có plugin cho điều phối (swarm, autopilot), bộ nhớ (agentdb, rag-memory), sinh test (testgen), quét bảo mật (security-audit, aidefence), theo dõi chi phí (cost-tracker) và nhiều mảng khác. Bạn cài đúng cái cần.
  • Liên kết nhiều máy (federation). Agent trên các máy khác nhau có thể cộng tác mà README nói là không làm lộ dữ liệu. Đây là tính năng nâng cao, người mới chưa cần đụng tới.
  • Dùng được ngoài Claude Code. Codex hoặc bất kỳ ứng dụng nào hỗ trợ MCP đều có thể trỏ tới Ruflo.

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

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

  • Node.js từ 20.0.0 trở lên. Đây là yêu cầu trong package.json. Lệnh npx đi kèm Node.
  • Claude Code (hoặc Codex, hoặc một ứng dụng MCP khác) để dùng Ruflo.
  • Nếu chọn đường cài bằng plugin: Claude Code phiên bản 2.1.287 trở lên. Lệnh claude plugin install từ terminal cần bản 2.1.292 trở lên.
  • Một thư mục dự án để chạy lệnh init.

README phần được cung cấp không nói gì về hệ điều hành cụ thể, về GPU hay về API key riêng của Ruflo. Phần README còn lại bị cắt nên mình không khẳng định thêm. Nếu cần biết chính xác, bạn xem tiếp README và thư mục docs/ trong repo.

Mod (ruflo-mods) chạy với đúng quyền tài khoản của bạn và không bị cô lập (sandbox). README khuyên đọc mã nguồn trước khi cài. Hãy làm theo lời khuyên này.

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

README đưa ra ba đường cài. Mình sẽ đi từ đường chính (đầy đủ nhất), rồi hai đường phụ.

  1. Mở terminal đúng thư mụcVào thư mục dự án mà bạn muốn dùng Ruflo
  2. Chạy lệnh initChạy npx ruflo@latest init để thêm agent, hook, bộ nhớ, MCP server
  3. Mở lại Claude CodeMở Claude Code trong cùng thư mục để nó nhận cấu hình mới
  4. Giao một việc thậtGõ một yêu cầu cụ thể cho Claude Code
  5. (Tuỳ chọn) Cài consoleDùng /plugin để thêm bảng điều khiển /ruflo

A.Mở terminal ở đúng thư mục dự án

Lệnh init ghi file vào thư mục hiện tại, nên chỗ mở terminal rất quan trọng. Chỗ này người mới hay vấp nhất: nếu bạn chạy ở sai thư mục, Ruflo sẽ nằm sai dự án. Hãy cd vào thư mục dự án trước.

Terminal
cd duong-dan-toi-thu-muc-du-an

Thay duong-dan-toi-thu-muc-du-an bằng đường dẫn thật của bạn.

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 bản Ruflo 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 trong README cho biết đường này tạo các thư mục và file như .claude/, .claude-flow/, CLAUDE.md, cùng file cài đặt và file hỗ trợ. Đây là đường được README khuyên dùng khi bạn muốn dùng thật, vì mọi thứ hoạt động như tài liệu mô tả.

Nếu muốn thiết lập theo kiểu hỏi đáp, README có lệnh:

Terminal
npx ruflo@latest init wizard

C.Mở lại Claude Code trong cùng thư mục

README nói Claude Code sẽ nhận cấu hình ở lần khởi động kế tiếp. Nếu bạn đang mở sẵn Claude Code, hãy thoát ra và mở lại trong thư mục đó.

D.Giao một việc thật

Thử câu lệnh mẫu của chính README:

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 bảo Claude dùng một bầy agent để rà soát repo, tìm module rủi ro nhất, viết test cho nó và tóm tắt thay đổi.

E.Đường phụ 1: chỉ cài plugin trong Claude Code

Đường này không thêm file nào vào dự án của bạn. README nói nó cài công cụ lõi, bảng điều khiển và các mod. Bạn gõ các dòng 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

Từng dòng làm gì: dòng đầu thêm "kho" plugin của Ruflo; ba dòng install cài ba plugin; /reload-plugins nạp lại; /ruflo mở bảng điều khiển. Nếu muốn cài từ terminal thường, với Claude Code 2.1.292 trở lên:

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

Lưu ý README nêu rõ: đường plugin chỉ cho bạn lệnh gạch chéo, một ít skill và định nghĩa agent. Hook thì không có. MCP server chỉ có khi cài ruflo-core. Muốn trọn bộ, hãy dùng npx ruflo@latest init.

F.Đường phụ 2: Codex hoặc ứng dụng MCP khác

Bạn không cần cài vào dự án. Trong phần cấu hình MCP của ứng dụng, đặt command là npx và arguments là:

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

README cũng ghi lệnh tương đương: npx -y ruflo@latest mcp start.

G.Chạy bảng điều khiển ngoài Claude Code

Nếu chỉ muốn xem giao diện terminal:

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

Theo README, cách kiểm tra gồm vài dấu hiệu:

  1. Sau npx ruflo@latest init, thư mục dự án có thêm các mục như .claude/, .claude-flow/ và CLAUDE.md (theo bảng so sánh hai đường cài).
  2. Mở lại Claude Code trong thư mục đó rồi gõ /ruflo. Nếu bảng điều khiển hiện ra, phần console đã hoạt động.
  3. Nếu cài bằng plugin, gõ /plugin. Các mod của Ruflo phải xuất hiện trong dòng "active mods".
  4. Chạy thử npx ruflo tui. Giao diện terminal hiện lên nghĩa là gói tải và chạy được.

Cách chắc chắn nhất là giao một việc nhỏ thật (xem phần sau) và quan sát agent có chạy không. README chưa mô tả đầu ra chính xác của lệnh init trong phần mình có, nên mình không nêu thêm.

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

Ruflo hướng tới người làm với Claude Code hoặc Codex, nên các tình huống dưới đây thiên về công việc phần mềm. Nếu bạn làm kinh doanh hay văn phòng, bạn có thể nhờ người làm kỹ thuật trong nhóm cài hộ.

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

Ông T

A.Rà soát một dự án thừa kế

Bối cảnh: bạn là lập trình viên mới nhận lại một repo của người khác, chưa biết chỗ nào dễ hỏng.

Cách làm: chạy npx ruflo@latest init trong thư mục repo, mở lại Claude Code rồi gõ 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ả: Claude dùng một bầy 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 nên tự đọc lại test và các thay đổi trước khi giữ lại.

B.Theo dõi một nhiệm vụ trong bảng điều khiển

Bối cảnh: bạn muốn nhìn thấy Claude đang làm gì, tốn bao nhiêu token, mà vẫn giữ quyền kiểm soát.

Cách làm: cài ruflo-console bằng các lệnh /plugin ở trên, 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.

Kết quả: Claude mở mục Missions và đặt mục tiêu; bạn xác nhận hành động tạo. Kiểm tra lại: mục Missions có mục tiêu, và Overview ghi lại hành động. README lưu ý rõ rằng tạo mission không có nghĩa tính năng đã được làm xong. Bấm Take back control bất cứ lúc nào để dừng Claude.

C.Dùng Ruflo từ Codex hoặc ứng dụng MCP khác

Bối cảnh: nhóm bạn không dùng Claude Code mà dùng Codex hoặc một ứng dụng hỗ trợ MCP.

Cách làm: trong cấu hình MCP, điền command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Không cần chạy init cho dự án.

Kết quả: ứng dụng nhận bộ công cụ MCP của Ruflo mà không thêm file vào dự án.

D.Thử một plugin riêng lẻ

Bối cảnh: bạn chưa muốn cài cả bộ, chỉ muốn thử khả năng tìm test còn thiếu.

Cách làm: thêm kho plugin rồi cài đúng plugin cần, theo cùng kiểu lệnh README dùng cho các plugin khác. Ví dụ ruflo-testgen được README mô tả là tìm test còn thiếu và sinh test tự động:

text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-testgen@ruflo
/reload-plugins

Kết quả: bạn có lệnh gạch chéo và định nghĩa agent của plugin đó, không thêm file vào dự án. Muốn xem plugin cung cấp lệnh nào, mở /plugin hoặc mục Plugin Catalog trong console (/ruflo market).

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

Lệnh npx không chạy hoặc báo không tìm thấy. Thường là máy chưa cài Node.js. Cài Node từ 20.0.0 trở lên, mở terminal mới rồi chạy lại.

Mở Claude Code mà không thấy gì mới. README nói Claude Code nhận cấu hình ở lần khởi động kế tiếp. Hãy thoát hẳn rồi mở lại, và chắc chắn bạn mở nó trong đúng thư mục đã chạy init.

Lệnh /plugin install không được hoặc báo thiếu. Đường plugin cần Claude Code 2.1.287 trở lên (2.1.292 nếu cài từ terminal). Cập nhật Claude Code, sau đó chạy /reload-plugins.

Claude bị từ chối khi điều khiển console. Đây là thiết kế: hành động vượt mức quyền bạn đã chọn sẽ bị từ chối, và hành động liên quan mạng, chi tiền hoặc phá huỷ luôn cần xác nhận. Nếu muốn, hãy nâng mức quyền trong Settings → Claude control, nhưng chỉ nâng khi bạn hiểu rủi ro.

Plugin chạy trùng hai lần. Với các plugin bên ngoài như agentdb hay agentic-flow, README dặn chỉ cài từ một kho duy nhất. Cài từ cả hai kho thì mod và lệnh sẽ nạp hai lần. Hãy gỡ một bên.

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

Điểm mạnh. Cài đặt gọn (một lệnh), giấy phép MIT, dùng được với cả Claude Code lẫn Codex. Bộ plugin rộng. Bảng điều khiển có cơ chế giới hạn quyền rõ ràng. Cộng đồng lớn và repo còn được cập nhật.

Giới hạn. Hệ thống lớn, nhiều khái niệm (swarm, federation, mod, plugin), nên người mới dễ choáng dù README bảo bạn chỉ cần dùng Claude Code như thường. Một số phần README tự nói rõ là chưa được chứng minh bằng demo, ví dụ phần thực thi swarm hoàn chỉnh hay việc nhớ lại bộ nhớ. Hãy tự thử trên việc nhỏ trước. Các mod không bị sandbox, và init thêm khá nhiều file vào dự án, nên hãy thử trên một nhánh hoặc dự án nháp trước.

Khi nào chọn cách khác. Nếu bạn chỉ cần Claude Code trả lời hoặc sửa vài file nhỏ, bản thân Claude Code là đủ. Nếu chỉ muốn thử một khả năng nhỏ, cài riêng một plugin thay vì cả bộ. Nếu bạn không làm việc với code, repo này chưa phải công cụ dành cho bạn.

4.4/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ưới giấy phép MIT, nên dùng và sửa được. Tuy nhiên Ruflo chạy trên Claude Code hoặc Codex, và các dịch vụ đó có thể tính phí riêng. Tư liệu mình có không nói chi tiết về chi phí của các dịch vụ này.

Ruflo khác gì Claude Flow?

Theo README, Claude Flow là tên cũ của chính dự án này. Dự án đã đổi tên thành Ruflo; gói npm hiện vẫn còn tên claude-flow trong thông tin repo, còn README hướng dẫn chạy bằng `npx ruflo@latest`.

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

Đường chính chỉ cần một lệnh: `npx ruflo@latest init` trong thư mục dự án, rồi mở lại Claude Code. Bạn cần có Node.js từ 20.0.0 trở lên. Phần cấu hình sâu hơn thì README còn dài, bạn xem thêm trong repo.

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 ứng dụng MCP khác dùng được: đặt command là `npx` và arguments là `-y`, `ruflo@latest`, `mcp`, `start`. README cũng có lệnh `npx ruflo init --grok` cho Grok Build.

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

Plugin không thêm file nào vào dự án, chỉ cho lệnh gạch chéo, một ít skill và định nghĩa agent. Còn `init` thêm đầy đủ agent, lệnh, skill, MCP server, hook và daemon, cùng các thư mục như `.claude/` và `.claude-flow/`. README khuyên dùng `init` khi cần dùng thật.

Giao quyền cho Claude trong bảng điều khiển có an toàn không?

Theo README, mức mặc định 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ền hoặc phá huỷ luôn cần xác nhận kể cả khi để auto. Bạn cũng có nút Take back control để dừng ngay.

Có cần GPU hay máy mạnh không?

Phần README mình có không nêu yêu cầu GPU hay cấu hình máy. Một plugin có nhắc tìm kiếm tăng tốc GPU, nhưng đó là plugin riêng. Với yêu cầu phần cứng chính xác, bạn xem tài liệu trong repo.

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 trong cùng thư mục
    4. D.Giao một việc thật
    5. E.Đường phụ 1: chỉ cài plugin trong Claude Code
    6. F.Đường phụ 2: Codex hoặc ứng dụng MCP khác
    7. G.Chạy bảng điều khiển ngoài Claude Code
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Rà soát một dự án thừa kế
    2. B.Theo dõi một nhiệm vụ trong bảng điều khiển
    3. C.Dùng Ruflo từ Codex hoặc ứng dụng MCP khác
    4. D.Thử một plugin riêng lẻ
  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ỏ.