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

9 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 mã nguồn mở, giấy phép MIT, bọc quanh Claude Code và Codex để thêm agent chuyên biệt, swarm phối hợp, bộ nhớ qua nhiều phiên và MCP server. Bạn 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ông khó, nhưng hệ thống rất rộng nên nên bắt đầu từ một tác vụ nhỏ.

Ruflo là một "agent harness": lớp công cụ đặt quanh Claude Code hoặc Codex để AI không chỉ trả lời một lượt rồi thôi, mà có agent chuyên biệt, có bộ nhớ, có hook tự động và biết chia việc cho nhiều agent cùng làm. Repo này trước đây tên là Claude Flow, hiện có khoảng 81.600 sao và khoảng 9.600 fork trên GitHub, giấy phép MIT, viết chủ yếu bằng TypeScript.

Tác giả mô tả đơn giản thế này: model là bộ não viết code, còn harness là bàn làm việc gồm công cụ, bộ nhớ, vòng lặp và các giới hạn an toàn. Ruflo là cái bàn làm việc đó. Sau khi chạy init, bạn vẫn dùng Claude Code như bình thường; phần định tuyến tác vụ và phối hợp agent chạy ngầm bên dưới.

Repo hợp với lập trình viên đã dùng Claude Code hoặc Codex và muốn giao việc lớn hơn cho AI (review cả repo, viết test, theo dõi chi phí). Người làm văn phòng, kinh doanh vẫn thử được, nhưng bạn cần quen mở terminal và có sẵn Claude Code. Điểm đáng giá nhất là cài chỉ bằng một lệnh, kèm một bảng điều khiển (console) để xem agent đang làm gì và chi phí token.

Framework

ruvnet/ruflo

Ruflo là bộ khung (harness) bọc quanh Claude Code và Codex, thêm agent chuyên biệt, nhóm agent phối hợp, bộ nhớ dài hạn 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 gom nhiều thứ vào một lần cài. Dưới đây là những phần bạn dễ dùng nhất.

A.Agent chuyên biệt và swarm

Sau khi init, dự án có sẵn hàng chục agent (README ghi 98 agent, hơn 60 lệnh, 30 skill ở cách cài đầy đủ). Swarm là cách cho nhiều agent làm chung một việc: ví dụ một agent tìm module rủi ro, một agent viết test. Lợi ích thực tế là bạn giao một yêu cầu lớn bằng một câu thay vì tự chia nhỏ.

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

Agent có thể lưu và nhớ lại kinh nghiệm giữa các lần làm việc, dùng cơ sở dữ liệu vector. README cũng ghi rõ đây là mô hình học "khái niệm": phần truy xuất vector cục bộ chạy được mà không cần LLM, nhưng vẫn cần embedding và các module học đã cấu hình. Nghĩa là đừng kỳ vọng nó tự thông minh lên ngay từ phút đầu.

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

Plugin ruflo-console cho bạn một "buồng lái" cạnh Claude Code: xem workflow, agent, model, token và chi phí, mở log của từng lần chạy, tìm kiếm, lọc lỗi, phát lại và so sánh. Mở bằng lệnh /ruflo.

D.Để 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. Các hành động liên quan mạng, chi tiêu hoặc phá hủy vẫn phải xác nhận ngay cả khi để auto. Bạn có nút "Take back control" để dừng ngay.

E.Plugin theo nhu cầu

Có 48 plugin trong marketplace, chia theo nhóm: điều phối (swarm, autopilot, workflow), bộ nhớ (agentdb, rag-memory), kiểm thử (testgen, browser), bảo mật (security-audit, aidefence), theo dõi chi phí (cost-tracker)… Bạn chỉ cài cái cần dùng.

F.Liên kết nhiều máy (federation) và nhiều client

Các agent trên máy khác nhau có thể trao đổi an toàn qua federation. Ngoài Claude Code, Codex hoặc bất kỳ client MCP nào cũng dùng được.

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

  • Node.js từ 20.0.0 trở lên. Đây là yêu cầu trong package.json của repo.
  • Claude Code nếu bạn muốn dùng đường cài đầy đủ hoặc plugin. Cách chỉ cài plugin cần Claude Code 2.1.287 trở lên; lệnh claude plugin install ngoài terminal cần 2.1.292 trở lên.
  • Codex hoặc client MCP khác nếu bạn không dùng Claude Code (tùy chọn).
  • Một thư mục dự án để chạy init.

Về hệ điều hành, phần cứng, API key hay tài khoản trả phí, tư liệu mình có không nói rõ. Bạn dùng Claude Code hoặc Codex bằng tài khoản của chính bạn, và chi phí token tính theo nhà cung cấp mô hình đó.

Plugin và mod của ruflo chạy với quyền tài khoản của bạn và không bị đóng khung sandbox. README khuyên đọc code trước khi cài. Hãy thử trong một thư mục dự án thử nghiệm trước khi áp dụng vào dự án thật.

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

  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ớ, MCP server
  3. Mở lại Claude CodeKhởi động lại trong cùng thư mục để nhận ruflo
  4. Giao một tác vụ thậtGõ câu lệnh mẫu cho swarm
  5. (Tùy chọn) Cài consoleDùng plugin và gõ /ruflo để xem bảng điều khiển

A.Mở terminal trong thư mục dự án

Đây là chỗ người mới hay vấp nhất: 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. Nếu chưa có dự án, tạo một thư mục thử rồi vào đó.

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

B.Chạy lệnh init

Lệnh này lấy bản mới nhất của ruflo qua npx và thêm agent, hook, bộ nhớ và MCP server vào dự án. Lần đầu có thể chậm vì phải tải gói.

Terminal
npx ruflo@latest init

Nếu muốn thiết lập có hỏi đáp từng bước, README có lệnh:

Terminal
npx ruflo@latest init wizard

Cách này thêm file vào dự án: README liệt kê .claude/, .claude-flow/, CLAUDE.md, các file helper và settings.

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

Claude Code nhận ruflo ở 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.Giao một tác vụ thật

Dán câu mẫu trong README vào Claude Code:

text
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.

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

Cách này không ghi file nào vào thư mục dự án. Gõ các lệnh sau bên trong Claude Code (không phải 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ừ terminal, với Claude Code 2.1.292 trở lên, README có lệnh:

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

README so sánh hai đường: plugin nhẹ hơn (không file, không hook), còn npx ruflo init mới là bản đầy đủ gồm hook, daemon và MCP server. README khuyên đường đầy đủ cho dùng nghiêm túc.

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

Không cần setup dự án. Cấu hình command là npx và arguments như sau:

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

Tương đương chạy npx -y ruflo@latest mcp start.

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

Console có thể chạy độc lập trong terminal:

Terminal
npx ruflo tui

Thêm --plain để in một khung hình dùng cho script.

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

Theo README, có vài dấu hiệu để biết cài xong:

  1. Sau init, thư mục dự án có thêm .claude/, .claude-flow/ và CLAUDE.md.
  2. Mở lại Claude Code, gõ /ruflo. Console hiện ra là thành công.
  3. Nếu cài bằng plugin, mở /plugin và kiểm tra các mod xuất hiện trong dòng "active mods".
  4. Với bản plugin, ruflo-core đăng ký MCP server riêng; công cụ của nó có tên dạng mcp__plugin_ruflo-core_ruflo__memory_store.

Cách kiểm tra an toàn nhất: giao một tác vụ nhỏ (xem phần dưới) và xem console có ghi lại hoạt động trong Overview hay không.

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

Dưới đây là các tình huống bám sát khả năng README mô tả.

A.Lập trình viên nhận lại một repo cũ, cần review nhanh

Bạn vừa nhận dự án không rõ chất lượng. Chạy npx ruflo@latest init trong thư mục repo, mở Claude Code và dán prompt mẫu:

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 phối hợp chỉ ra module rủi ro nhất, viết test cho nó và tóm tắt thay đổi. Bạn vẫn nên đọc lại test trước khi gộp vào nhánh chính.

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

Ông T

B.Người mới muốn xem AI đang làm gì và tốn bao nhiêu

Bạn không muốn "hộp đen". Cài console qua plugin rồi vào /ruflo. Trong đó bạn xem workflow, agent, model, token và chi phí, mở log từng lần chạy, tìm và lọc lỗi. Hãy để Claude control ở mặc định read + ask: AI chỉ đọc, và mọi thao tác cần bạn bấm duyệt.

C.Tạo "mission" bằng Claude trong console

Đây là ví dụ README hướng dẫn từng bước. Vào Settings → Claude control, 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 trong console. Kiểm tra mission xuất hiện trong Missions và có ghi nhận trong Overview. Lưu ý README nói rõ: tạo mission không có nghĩa tính năng đã được làm xong. Muốn dừng, bấm "Take back control".

D.Dùng Codex hoặc công cụ khác, không đụng vào dự án

Nếu bạn dùng client MCP khác và không muốn thêm file vào dự án, chỉ cần khai báo MCP server như phần cài đặt ở trên. Các công cụ của ruflo sẽ gọi được từ client đó. Đây là cách thử nhẹ nhất.

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

A.Lệnh npx báo lỗi hoặc không chạy

Kiểm tra phiên bản Node bằng node --version. Repo yêu cầu 20.0.0 trở lên; nếu thấp hơn, cập nhật Node rồi chạy lại.

B.Init xong nhưng Claude Code không thấy ruflo

Claude Code chỉ nhận ruflo ở lần khởi động tiếp theo. Thoát hẳn rồi mở lại, và chắc chắn bạn mở đúng thư mục đã chạy init.

C.Lệnh /plugin không nhận hoặc cài plugin thất bại

Cách plugin cần Claude Code 2.1.287 trở lên. Hãy cập nhật Claude Code. Sau khi cài, chạy /reload-plugins. Nhớ rằng các lệnh /plugin ... gõ trong Claude Code, không phải trong PowerShell hay Bash.

D.Plugin chạy hai lần, lệnh bị trùng

Với một số plugin bên ngoài (như agentic-qe-fleet, agentdb, agentic-flow), README cảnh báo: chỉ cài từ một marketplace duy nhất. Nếu bật từ cả hai nơi, mod và lệnh sẽ được nạp hai lần. Hãy gỡ một bản.

E.Gọi công cụ MCP sai tên

Bản plugin và bản CLI đặt tên công cụ khác nhau (ví dụ mcp__plugin_ruflo-core_ruflo__memory_store so với tên ngắn memory_store). Nếu hướng dẫn của bạn dùng tên ngắn mà bạn cài bằng plugin, hãy chuyển sang cài bằng npx ruflo init.

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

Điểm mạnh: cài nhanh bằng một lệnh; giấy phép MIT; hỗ trợ Claude Code, Codex và client MCP; có console để quan sát và giới hạn quyền cho AI; hệ plugin rộng; repo vẫn được cập nhật trong 3 tháng gần đây.

Giới hạn: hệ thống rất lớn (README nhắc 406 công cụ MCP và 61 lệnh CLI), người mới dễ choáng. Bạn không cần học hết, chỉ cần init rồi dùng Claude Code bình thường. README cũng nói thẳng nhiều demo dùng dữ liệu mẫu và không chứng minh swarm hay bộ nhớ đã hoàn thành việc thật. Cách cài đầy đủ ghi thêm nhiều file vào dự án, và mod chạy với quyền tài khoản của bạn.

Khi nào chọn cách khác: nếu bạn chỉ cần Claude Code trả lời trong một file hoặc làm việc nhỏ, ruflo là thừa. Nếu bạn không dùng terminal hay Node, nó chưa phải công cụ cho bạn. Còn nếu bạn đang giao việc lớn, nhiều bước cho AI và muốn có bộ nhớ, giám sát và giới hạn quyền, hãy thử ruflo trong một dự án thử trước.

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 Ruflo bọc quanh Claude Code hoặc Codex, nên chi phí model vẫn tính theo nhà cung cấp bạn dùng. README có plugin ruflo-cost-tracker để theo dõi token và đặt ngân sách.

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

Cần Node.js từ 20.0.0 trở lên. Nếu muốn dùng plugin trong Claude Code thì cần Claude Code 2.1.287 trở lên. Lệnh cài chính là `npx ruflo@latest init` chạy trong thư mục dự án.

Ruflo có chạy được với Codex, không chỉ Claude Code không?

Có. README nói Codex và các client MCP khác dùng được, bằng cách khai báo command là `npx` với tham số `-y`, `ruflo@latest`, `mcp`, `start`. Không cần thiết lập dự án.

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

Nếu dùng `npx ruflo init`, có: README liệt kê `.claude/`, `.claude-flow/`, `CLAUDE.md`, file helper và settings. Nếu chỉ cài plugin trong Claude Code thì không thêm file nào vào dự án.

Ruflo có an toàn không, AI có tự làm bừa không?

Console cho bạn chọn mức quyền read, write, manage, full và chế độ duyệt ask hoặc auto; mặc định là read + ask. 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. Riêng mod và plugin chạy với quyền tài khoản của bạn và không có sandbox, nên cần đọc code trước khi cài.

Tôi có cần GPU không?

Tư liệu mình có không nêu yêu cầu GPU cho phần cài cơ bản. Chỉ có một plugin (ruflo-ruvector) được mô tả là tìm kiếm tăng tốc bằng GPU. Thông tin chi tiết hơn về phần cứng chưa có trong tư liệu.

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

Claude Code thuần là nơi model làm việc. Ruflo thêm lớp harness: agent chuyên biệt, swarm, bộ nhớ qua các phiên, hook tự động và console theo dõi. Sau khi init, bạn vẫn dùng Claude Code như bình thường.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
    1. A.Agent chuyên biệt và swarm
    2. B.Bộ nhớ qua nhiều phiên
    3. C.Bảng điều khiển trong Claude Code
    4. D.Để Claude điều khiển console, bạn đặt giới hạn
    5. E.Plugin theo nhu cầu
    6. F.Liên kết nhiều máy (federation) và nhiều client
  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ở Claude Code trong cùng thư mục
    4. D.Giao một tác vụ thật
    5. E.Cách khác: chỉ cài plugin (không thêm file vào dự án)
    6. F.Dùng với Codex hoặc client 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.Lập trình viên nhận lại một repo cũ, cần review nhanh
    2. B.Người mới muốn xem AI đang làm gì và tốn bao nhiêu
    3. C.Tạo "mission" bằng Claude trong console
    4. D.Dùng Codex hoặc công cụ khác, không đụng vào dự án
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh npx báo lỗi hoặc không chạy
    2. B.Init xong nhưng Claude Code không thấy ruflo
    3. C.Lệnh /plugin không nhận hoặc cài plugin thất bại
    4. D.Plugin chạy hai lần, lệnh bị trùng
    5. E.Gọi công cụ MCP sai tên
  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ỏ.