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 (tên cũ là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code hoặc Codex, thêm đội agent, bộ nhớ qua các phiên và MCP server. Bạn dùng nó để giao việc lớn cho nhiều agent phối hợp thay vì chỉ một. Cài khá dễ: chạy một lệnh npx trong thư mục dự án, cần Node 20 trở lên.

Ruflo là một “agent harness”, tức bộ khung bao quanh Claude Code và Codex. Nó thêm cho các công cụ này một đội agent chuyên biệt, bộ nhớ giữ qua nhiều phiên làm việc, hook tự động và một MCP server. Repo này trước đây có tên Claude Flow, hiện có khoảng 81.582 sao và 9.607 fork trên GitHub, giấy phép MIT.

Vấn đề nó giải quyết khá đơn giản. Khi bạn dùng Claude Code, về cơ bản chỉ có một “người” làm việc, và mỗi lần mở lại là phải giải thích lại từ đầu. Ruflo cho phép nhiều agent chia việc, phối hợp theo kiểu đội nhóm (swarm), và nhớ lại những gì đã làm trước đó. README tóm gọn ý tưởng bằng một công thức: Agent = Model + Harness. Model là phần viết; harness là phần cấp công cụ, bộ nhớ, vòng lặp và các giới hạn kiểm soát để model làm việc được thật.

Nếu bạn là lập trình viên mới, người làm văn phòng đã quen Claude Code, hoặc chủ dự án muốn thử giao việc dài hơi cho AI, repo này đáng để thử. Điểm đáng giá nhất là bạn chỉ cần một lệnh npx ruflo@latest init, sau đó cứ dùng Claude Code như bình thường. Chính README cũng nhắn: bạn không cần học hết 406 công cụ MCP hay 61 lệnh CLI.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) thêm agent, bộ nhớ, hook và MCP server cho Claude Code và Codex, để nhiều agent phối hợp làm việc trong cùng một dự án.

★ 82kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là những tính năng chính theo README, mình diễn giải theo lợi ích thực tế.

A.Đội agent làm việc cùng nhau

Sau khi cài, dự án của bạn có sẵn nhiều agent chuyên biệt (README ghi 98 agent ở đường cài đầy đủ, và nhắc tới “100+” ở phần giới thiệu). Chúng có thể tự tổ chức thành swarm để chia việc. Bạn chỉ cần mô tả mục tiêu, ví dụ “review repo này, tìm module rủi ro nhất, viết test cho nó”.

B.Bộ nhớ qua nhiều phiên

Ruflo có bộ nhớ để agent nhớ lại kinh nghiệm từ các lần làm trước. README nói các agent “học từ mỗi tác vụ” và có phần truy xuất vector (RAG). Lưu ý: README cũng ghi rõ đây là mô tả khái niệm; phần truy xuất vector cục bộ có thể chạy không cần LLM, nhưng vẫn cần embedding và các module học được cấu hình.

C.Hook tự động

Sau init, hệ thống hook tự định tuyến tác vụ và phối hợp agent ở nền. Bạn không phải gọi tay từng công cụ.

D.Bảng điều khiển ngay trong Claude Code

Plugin ruflo-console là một “cockpit”: theo dõi workflow, agent, model, token và chi phí cạnh Claude Code. Bạn 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. Bảng điều khiển cũng chạy độc lập trong terminal.

E.Cho Claude điều khiển bảng điều khiển, nhưng bạn giữ giới hạn

Trong Settings → Claude control, 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. Các hành động liên quan mạng, chi tiêu hay phá huỷ vẫn phải xác nhận kể cả ở chế độ auto. Có nút Take back control để thu lại quyền ngay.

F.Kho plugin phong phú

README liệt kê 48 plugin (cộng thêm 3 plugin bên ngoài), chia theo nhóm: điều phối (swarm, autopilot, workflow), bộ nhớ (agentdb, rag-memory), học tập (intelligence), chất lượng code (testgen, browser, docs), bảo mật (security-audit, aidefence), theo dõi chi phí (cost-tracker)... Bạn chỉ cài cái mình cần.

G.Liên kết với nhiều công cụ khác

Ngoài Claude Code, README nói Codex và các MCP client khác dùng được, và có lệnh riêng cho Grok Build (npx ruflo init --grok). Còn có tính năng federation để agent trên các máy khác nhau phối hợp, nhưng phần này khá nâng cao, bạn chưa cần đụng khi mới bắt đầu.

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

Tư liệu repo nói khá ít về yêu cầu, nên mình chỉ ghi những gì có:

  • Node.js bản 20.0.0 trở lên (theo package.json). Lệnh npx đi kèm Node.
  • Claude Code đã cài, nếu bạn dùng đường Claude Code. Riêng đường chỉ cài plugin cần Claude Code 2.1.287 trở lên; lệnh claude plugin install từ terminal cần 2.1.292 trở lên.
  • Nếu dùng Codex hoặc MCP client khác: client đó phải cho cấu hình MCP server bằng lệnh và tham số.
  • Một thư mục dự án để chạy lệnh init trong đó.

Về hệ điều hành, GPU hay API key: README đoạn mình có không nói gì rõ. Bạn dùng Claude Code hay Codex thì cần tài khoản/khoá của chính các công cụ đó, còn Ruflo thì README không nêu yêu cầu key riêng ở phần cài đặt.

Mod trong Ruflo chạy với quyền tài khoản của bạn và không bị sandbox (cô lập). README khuyên đọc mã trước khi cài. Với tính năng Claude control, hãy giữ mức read + ask cho tới khi bạn hiểu rõ mình đang cho phép gì.

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

Có vài đường cài. Đường dễ nhất, và README gọi là dùng cho môi trường thật, là chạy npx ruflo@latest init trong thư mục dự án.

  1. Mở terminal đúng thư mụcVào thư mục dự án mà bạn muốn Ruflo hoạt động
  2. Chạy lệnh initThêm agent, hook, bộ nhớ và MCP server vào dự án
  3. Khởi động lại Claude CodeĐể Claude Code nhận các thành phần mới
  4. Giao thử một việc thậtGõ yêu cầu dùng swarm trong Claude Code
  5. (Tuỳ chọn) Cài bảng điều khiểnDùng plugin ruflo-console rồi gõ /ruflo

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ên bạn phải đứng đúng thư mục dự án trước khi chạy. Nếu chưa có dự án, hãy tạo một thư mục thử nghiệm riêng.

PowerShell
cd đường-dẫn-tới-thư-mục-dự-án-của-bạn

B.Chạy lệnh init

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

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, lệnh này thêm agent, hook, bộ nhớ và MCP server vào dự án. Ở đường cài đầy đủ, README ghi các thư mục và file như .claude/, .claude-flow/, CLAUDE.md, file hỗ trợ và settings sẽ xuất hiện trong dự án, nên nếu bạn dùng git, hãy xem lại thay đổi trước khi commit.

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

Mở Claude Code trong cùng thư mục đó. README nói 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 mở sẵn Claude Code, hãy thoát và mở lại.

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

Đường này không thêm file nào vào dự án của bạn. Chạy ngay 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

Các dòng này lần lượt thêm kho plugin của Ruflo, cài lõi, bảng điều khiển và mods, nạp lại plugin rồi mở bảng điều khiển. Bảng so sánh trong README cho biết đường plugin gọn nhẹ hơn: không có hook, và chỉ ruflo-core đăng ký MCP server. Muốn trọn bộ tính năng như tài liệu mô tả, hãy chọn đường init.

Từ terminal thường (Claude Code 2.1.292 trở lên), README ghi một dòng thay thế:

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

E.Cách khác: dùng với Codex hoặc MCP client khác

Cấu hình command là npx và arguments là:

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

Bạn điền hai giá trị này vào phần cấu hình MCP server của client. Mỗi client có chỗ điền khác nhau; README chưa hướng dẫn chi tiết từng client trong đoạn mình có, nên bạn xem tài liệu của client đó.

F.Cách khác: chỉ chạy giao diện terminal

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

Terminal
npx ruflo tui

Thêm --plain nếu muốn in một khung hình ra cho script dùng.

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

Có vài dấu hiệu để bạn biết mọi thứ ổn:

  1. Sau npx ruflo@latest init không báo lỗi, và thư mục dự án có thêm các mục như .claude/ và CLAUDE.md (theo bảng so sánh trong README).
  2. Mở lại Claude Code trong thư mục đó rồi gõ /ruflo. Nếu bạn đã cài ruflo-console, bảng điều khiển sẽ hiện ra.
  3. Với đường plugin: gõ /plugin và xem các mod xuất hiện trong dòng “active mods”, theo README.
  4. Giao một việc thật như ví dụ bên dưới và xem Claude Code có điều phối agent hay không.

Cách thử ít rủi ro nhất là dùng chính ví dụ trong README: tạo một “mission” trong console với quyền write + ask, rồi xác nhận hành động tạo. README lưu ý rằng tạo mission chỉ ghi lại mục tiêu, chưa có nghĩa tính năng đã được làm xong.

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

Phần này mình lấy ví dụ đời thường. Những câu lệnh mẫu dưới đây bám vào khả năng Ruflo mô tả; kết quả cụ thể sẽ tuỳ dự án và model của bạn.

A.Dev mới nhận một repo lạ và cần biết chỗ nào dễ hỏng

Bạn vừa được giao bảo trì một dự án cũ, chưa biết bắt đầu từ đâu. Sau khi chạy init và mở lại Claude Code, bạn dùng đú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.

Bạn có thể viết bằng tiếng Việt nếu Claude Code của bạn hiểu tốt, nhưng câu gốc từ README là cách chắc chắn nhất. Kết quả mong đợi: các agent chia nhau xem repo, chỉ ra module rủi ro, viết test và tóm tắt thay đổi. Bạn đọc lại tóm tắt và chạy test trước khi tin.

Bạn vẫn viết code như cũ, còn việc điều phối giữa các agent thì để Ruflo lo.

Ông T

B.Chủ dự án nhỏ muốn theo dõi chi phí khi giao việc cho AI

Bạn thuê AI làm việc dài và lo token tốn quá tay. Có hai thứ liên quan trong README. Một là bảng điều khiển ruflo-console hiển thị token và chi phí cạnh Claude Code. Hai là plugin ruflo-cost-tracker, mô tả là theo dõi token, đặt ngân sách và cảnh báo chi phí:

text
/plugin install ruflo-cost-tracker@ruflo
/reload-plugins

Sau đó mở /ruflo để xem. Cách dùng chi tiết từng lệnh của plugin này, bạn xem thêm trong thư mục plugins/ của repo vì README đoạn mình có chỉ ghi mô tả ngắn.

C.Nhân viên văn phòng muốn thử bảng điều khiển trước khi cam kết

Bạn chưa muốn thêm file vào dự án. Hãy đi đường plugin, vì đường này không thêm file nào vào thư mục làm việc:

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

Sau đó vào Settings → Claude control, chọn write + ask và thử câu README gợi ý:

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. Bạn kiểm tra trong Missions và trang Overview xem hành động đã được ghi lại chưa. Nếu muốn dừng, bấm Take back control.

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. Hãy đăng ký Ruflo như một MCP server với command npx và arguments ["-y", "ruflo@latest", "mcp", "start"]. Khi đó công cụ của bạn gọi được các tool bộ nhớ và điều phối của Ruflo qua MCP. Bạn cần tự kiểm tra danh sách tool hiển thị trong client của mình.

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

Tư liệu README mình có không liệt kê mục xử lý lỗi, nên dưới đây là những tình huống rất dễ gặp với loại công cụ này, kèm cách xử lý an toàn.

A.Lệnh npx báo lỗi hoặc phiên bản Node cũ

package.json yêu cầu Node 20.0.0 trở lên. Hãy kiểm tra bản của bạn:

Terminal
node --version

Nếu thấp hơn 20, cập nhật Node rồi chạy lại.

B.Chạy init xong mà Claude Code không thấy gì

Thường do bạn chưa khởi động lại Claude Code, hoặc mở Claude Code ở một thư mục khác với thư mục đã chạy init. Thoát hẳn, mở lại đúng thư mục dự án.

C.Lệnh /plugin hoặc /ruflo không có tác dụng

Đường plugin cần Claude Code từ 2.1.287 trở lên. Hãy cập nhật Claude Code, rồi chạy lại /plugin marketplace add ruvnet/ruflo và /reload-plugins.

D.Cài một plugin từ hai kho cùng lúc

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 kho. Cài từ cả hai thì mod và lệnh bị nạp hai lần.

E.Claude làm hành động ngoài ý muốn trong console

Hạ mức quyền về read hoặc write kèm ask, hoặc bấm Take back control. README nói các hành động vượt mức quyền sẽ bị từ chối, và hành động mạng, chi tiêu, phá huỷ luôn cần xác nhận.

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

Điểm mạnh. Cài nhanh bằng một lệnh. Dùng giấy phép MIT. Hỗ trợ cả Claude Code lẫn Codex. Có bảng điều khiển để nhìn thấy agent đang làm gì và tốn bao nhiêu. Có cơ chế giới hạn quyền cho Claude khi điều khiển console. Repo vẫn được cập nhật trong những tháng gần đây, và có hệ plugin lớn để mở rộng dần.

Giới hạn. Dự án rất lớn: hàng trăm công cụ MCP, hàng chục lệnh và plugin, nên người mới dễ bị choáng. README cũng tự nói nhiều phần là mô tả khái niệm, và các đoạn demo dùng dữ liệu mẫu chứ không chứng minh kết quả swarm hoàn chỉnh. Lệnh init thêm khá nhiều file vào dự án. Mod không bị sandbox. Thông tin về yêu cầu phần cứng, hệ điều hành và chi phí gọi model trong tư liệu mình có là chưa đầy đủ.

Khi nào nên chọn cách khác. Nếu bạn chỉ cần một trợ lý lập trình cho các việc nhỏ lẻ, Claude Code hoặc Codex thuần là đủ và gọn hơn. Nếu bạn không muốn công cụ chạm vào cấu trúc dự án, hãy thử đường chỉ cài plugin trước. Còn nếu bạn muốn giao việc dài, nhiều bước cho một đội agent có bộ nhớ, thì Ruflo là một lựa chọn đáng thử, miễn là bạn bắt đầu nhỏ, trong một dự án thử nghiệm, và đọc kỹ những gì nó thêm vào.

4.7/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 tài khoản hoặc quyền dùng Claude Code hay Codex, và chi phí gọi model nằm ở phía các dịch vụ đó. README đoạn mình có không nêu bảng giá.

Ruflo khác gì Claude Code?

Claude Code là công cụ lập trình bằng AI; Ruflo là lớp harness bao quanh nó. Theo README, Ruflo thêm đội agent chuyên biệt, swarm, bộ nhớ qua các phiên, hook và MCP server. Bạn vẫn dùng Claude Code như bình thường sau khi cài.

Cần GPU hoặc cấu hình mạnh không?

Tư liệu mình có không nêu yêu cầu phần cứng hay GPU cho đường cài cơ bản. Chỉ có yêu cầu rõ là Node 20 trở lên. Nếu bạn dùng plugin chạy model cục bộ hay tìm kiếm tăng tốc GPU thì cần xem riêng tài liệu từng plugin.

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

README đoạn mình có không nói rõ về hệ điều hành. Lệnh cài chỉ là `npx ruflo@latest init` nên nếu máy bạn có Node 20 trở lên thì có thể thử. Nếu gặp vấn đề riêng cho Windows, hãy xem mục issues hoặc tài liệu trong repo.

Cài Ruflo có thêm file vào dự án của tôi không?

Có nếu bạn chạy `npx ruflo@latest init`: README ghi các thư mục và file như `.claude/`, `.claude-flow/` và `CLAUDE.md` sẽ xuất hiện. Nếu chọn đường chỉ cài plugin Claude Code thì README nói không có file nào được thêm vào thư mục làm việc.

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

README có nhắc tới các rào bảo mật và kiểm soát quyền, ví dụ giới hạn quyền khi Claude điều khiển console, yêu cầu xác nhận với hành động mạng, chi tiêu, phá huỷ. Nhưng mod chạy với quyền tài khoản của bạn và không bị sandbox. Vì vậy bạn nên đọc mã trước khi cài và thử trong dự án không chứa dữ liệu nhạy cảm.

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

Được. README nói Codex và các MCP client khác dùng được bằng cách cấu hình command `npx` với arguments `["-y", "ruflo@latest", "mcp", "start"]`. Cách điền cụ thể tuỳ từng client, README đoạn mình có chưa hướng dẫn chi tiết.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
    1. A.Đội agent làm việc cùng nhau
    2. B.Bộ nhớ qua nhiều phiên
    3. C.Hook tự động
    4. D.Bảng điều khiển ngay trong Claude Code
    5. E.Cho Claude điều khiển bảng điều khiển, nhưng bạn giữ giới hạn
    6. F.Kho plugin phong phú
    7. G.Liên kết với nhiều công cụ khác
  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.Khởi động lại Claude Code
    4. D.Cách khác: chỉ cài plugin Claude Code
    5. E.Cách khác: dùng với Codex hoặc MCP client khác
    6. F.Cách khác: chỉ chạy giao diện terminal
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới nhận một repo lạ và cần biết chỗ nào dễ hỏng
    2. B.Chủ dự án nhỏ muốn theo dõi chi phí khi giao việc cho AI
    3. C.Nhân viên văn phòng muốn thử bảng điều khiển trước khi cam kế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ý
    1. A.Lệnh npx báo lỗi hoặc phiên bản Node cũ
    2. B.Chạy init xong mà Claude Code không thấy gì
    3. C.Lệnh /plugin hoặc /ruflo không có tác dụng
    4. D.Cài một plugin từ hai kho cùng lúc
    5. E.Claude làm hành động ngoài ý muốn trong console
  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ỏ.