Bỏ qua tới nội dung
Ông T.vn

oh-my-claudecode: điều phối nhiều agent cho Claude Code — 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ề Yeachan-Heo/oh-my-claudecode — 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: oh-my-claudecode: điều phối nhiều agent cho Claude Code — hướng dẫn cài đặt và dùng →

oh-my-claudecode: điều phối nhiều agent cho Claude Code — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

oh-my-claudecode (gọi tắt OMC) là plugin và công cụ dòng lệnh giúp Claude Code chạy nhiều agent phối hợp với nhau. Bạn chỉ cần mô tả việc cần làm, ví dụ gõ /autopilot kèm yêu cầu. Cài bằng hai lệnh plugin hoặc một lệnh npm, rồi chạy bước setup nên người mới làm được.

oh-my-claudecode (gọi tắt là OMC) là một plugin cho Claude Code, giúp bạn chạy nhiều “agent” AI phối hợp với nhau thay vì chỉ một cuộc trò chuyện đơn lẻ. Tác giả mô tả nó là công cụ điều phối đa agent, ưu tiên làm việc theo nhóm (team-first), với khẩu hiệu “không cần học Claude Code, cứ dùng OMC”.

Vấn đề nó giải quyết khá quen: khi bạn giao cho Claude Code một việc lớn như “viết một API quản lý công việc”, bạn phải tự chia nhỏ, tự nhắc, tự kiểm tra. OMC đóng gói sẵn các quy trình đó thành những lệnh gạch chéo như /autopilot, /team, /deep-interview. Bạn nói việc cần làm, phần còn lại do các agent tự phân công.

Repo này hợp với lập trình viên đã có Claude Code và muốn làm nhanh hơn. Người mới tập code cũng dùng được, vì cách dùng chỉ là gõ câu yêu cầu bằng ngôn ngữ thường. Hiện repo có khoảng 40.796 sao và 3.643 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Plugin

Yeachan-Heo/oh-my-claudecode

Plugin điều phối nhiều agent cho Claude Code: gõ một yêu cầu, các agent chia việc song song, có chế độ autopilot và team.

★ 41kTypeScriptMIT
Xem repo trên GitHub

I.oh-my-claudecode làm được gì

Dưới đây là những phần chính mà README nêu, kèm lợi ích thực tế.

  • Autopilot (/autopilot). Bạn mô tả sản phẩm cần làm, ví dụ “build a REST API for managing tasks”. Plugin tự chạy cả quy trình. Hợp khi bạn muốn giao trọn một việc và quay lại xem kết quả.
  • Phỏng vấn sâu (/deep-interview). Dành cho lúc bạn mới có ý tưởng mơ hồ. Công cụ hỏi lại bạn theo kiểu đặt câu hỏi dẫn dắt để lộ ra những giả định ngầm, trước khi viết dòng code nào. Nhờ vậy bạn đỡ làm sai hướng rồi mới phát hiện.
  • Chế độ Team (/team). README gọi đây là bề mặt điều phối chính thức. Ví dụ /team 3:executor "fix all TypeScript errors" giao việc cho 3 agent thực thi. Team chạy theo chuỗi: lập kế hoạch, viết yêu cầu, thực thi, kiểm tra, rồi sửa lỗi lặp lại cho tới khi ổn.
  • Worker chạy trong tmux (omc team). Ngoài team trong phiên Claude Code, bạn có thể bật các “ngăn” tmux chạy công cụ khác như Codex, Gemini, Antigravity, Grok, Cursor hoặc Claude. Mỗi ngăn làm một phần việc rồi tự tắt khi xong, nên không tốn tài nguyên chạy nền.
  • Hỏi ý kiến nhà cung cấp khác (/ask, omc ask). Ví dụ nhờ Codex duyệt kiến trúc, nhờ Antigravity duyệt giao diện, rồi để Claude tổng hợp. Hữu ích khi bạn muốn có “con mắt thứ hai”.
  • Quét rủi ro trước khi chạy tự động (omc lookout scan). Lệnh này đọc bản mô tả nhiệm vụ và thư mục làm việc, rồi báo các điểm nguy hiểm. README ghi rõ chỉ mang tính cảnh báo, không chặn gì.
  • Dùng như thư viện. Gói npm xuất các hàm TypeScript như createOmcSession() cho chương trình Node.js dùng @anthropic-ai/claude-agent-sdk.

README cũng nhấn mạnh vài điểm: không cần cấu hình, mặc định đã dùng được ngay, và không cần nhớ lệnh vì có thể nói bằng ngôn ngữ thường.

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

Theo tư liệu, bạn cần:

  • Claude Code đã cài sẵn, vì OMC là plugin chạy trong đó. Các lệnh gạch chéo chỉ dùng được trong một phiên Claude Code đang mở.
  • Node.js nếu đi đường npm. File package.json yêu cầu Node 20, 22, 23, 24, 25 hoặc 26.
  • tmux và công cụ dòng lệnh tương ứng (codex, gemini, agy, grok hoặc cursor-agent, đã cài và đăng nhập) nếu bạn muốn dùng omc team với worker bên ngoài.
  • Linux có tiện ích flock nếu muốn dùng tính năng hồ sơ autopilot đặt tên (--workflow). Môi trường không hỗ trợ sẽ bị từ chối, còn autopilot thường vẫn chạy.
  • Khoá API hoặc đăng nhập của nhà cung cấp khi chạy tự động trên máy chủ CI. README nhắc đặt ANTHROPIC_API_KEY hoặc đăng nhập CLI của nhà cung cấp trong môi trường chạy.

Về phần cứng và hệ điều hành cho dùng thông thường, README không nêu yêu cầu cụ thể. Mình không đoán thêm.

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

  1. Cài pluginThêm marketplace rồi cài plugin trong Claude Code
  2. (Tuỳ chọn) Cài bằng npmCài lệnh omc trên terminal
  3. Chạy setupCấu hình bằng /omc-setup hoặc omc setup
  4. Bật team (tuỳ chọn)Thêm biến môi trường vào settings.json
  5. Chạy thửGõ /autopilot với một yêu cầu nhỏ

A.Cài plugin trong Claude Code

Đây là cách README khuyên dùng cho đa số người dùng Claude Code. Hãy mở một phiên Claude Code rồi gõ từng lệnh một. README lưu ý dán cả hai dòng cùng lúc sẽ bị lỗi.

Lệnh thứ nhất thêm kho plugin:

Terminal
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

Sau khi xong, gõ tiếp lệnh thứ hai để cài:

Terminal
/plugin install oh-my-claudecode

Chỗ người mới hay vấp: đây là lệnh gạch chéo của Claude Code, gõ vào khung chat của Claude Code, không gõ vào PowerShell hay Terminal thường.

B.Cài bằng npm (tuỳ chọn)

Nếu bạn thích đường dòng lệnh thay vì marketplace, cài gói npm. Lưu ý tên gói là oh-my-claude-sisyphus, khác với tên thương hiệu. Lệnh này gõ ở terminal bình thường:

Terminal
npm i -g oh-my-claude-sisyphus@latest

Sau khi cài, bạn có cả lệnh oh-my-claudecode lẫn lệnh ngắn omc.

Khi cài, npm có thể in cảnh báo deprecated prebuild-install@7.1.3. README giải thích cảnh báo này đến từ một thư viện phụ thuộc (better-sqlite3) và không có nghĩa là cài thất bại.

C.Chạy setup

Bước này cấu hình OMC. Có hai cách, tuỳ bạn đang ở đâu:

Terminal
# Inside a Claude Code / OMC session
/omc-setup

# From your terminal
omc setup

Nếu bạn chạy Claude Code với cờ --plugin-dir, README bảo thêm --plugin-dir-mode vào omc setup (hoặc đặt biến OMC_PLUGIN_ROOT trước khi chạy) để tránh nhân đôi skill và agent. Người dùng thông thường không cần quan tâm phần này.

D.Bật chế độ Team (tuỳ chọn)

Để dùng /team theo kiểu team gốc của Claude Code, README yêu cầu bật một biến môi trường trong file ~/.claude/settings.json:

JSON
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Nếu file đã có nội dung, bạn thêm khối env vào cho đúng cú pháp JSON, đừng ghi đè mất cấu hình cũ. Nếu chưa bật, OMC sẽ cảnh báo và chuyển sang chạy không theo team khi có thể.

OMC có thể gọi nhiều agent chạy song song và gọi cả các công cụ AI khác. Điều này có thể làm tăng mức dùng quota hoặc chi phí tài khoản của bạn. README không nêu con số chi phí, nên hãy theo dõi mức dùng ở những lần chạy đầu và thử với việc nhỏ trước.

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

README không có lệnh “kiểm tra phiên bản” riêng. Cách thực tế nhất là thử đúng ví dụ trong tài liệu. Trong một phiên Claude Code, gõ:

Terminal
/autopilot "build a REST API for managing tasks"

README cũng cho phép gõ kiểu câu thường trong phiên:

Terminal
autopilot: build a REST API for managing tasks

Nếu Claude Code nhận lệnh và bắt đầu lập kế hoạch, chia việc rồi làm, tức là plugin đã hoạt động. Nếu gõ /autopilot mà báo không có lệnh này, nhiều khả năng bước cài hoặc setup chưa xong.

Với đường npm, bạn có thể thử lệnh omc setup ở terminal. Nếu máy nhận ra lệnh omc, gói đã cài đúng chỗ. Ngoài ra README có nhắc lệnh /omc-doctor để xử lý sự cố sau khi cập nhật (xem phần lỗi bên dưới).

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

A.Lập trình viên muốn dựng nhanh một API

Bạn là dev nhỏ lẻ, cần một bản API quản lý công việc để demo cho khách. Thay vì tự chia nhỏ từng file, bạn mở Claude Code trong thư mục dự án rồi gõ đúng ví dụ của README:

Terminal
/autopilot "build a REST API for managing tasks"

Kết quả là các agent tự lập kế hoạch, viết code và kiểm tra. Bạn đọc lại thành quả và chỉnh những chỗ chưa vừa ý.

Đừng cố học hết từng lệnh. Nói rõ việc cần làm, để công cụ lo phần chia việc.

Ông T

B.Chủ shop có ý tưởng nhưng chưa rõ cần gì

Bạn muốn có một ứng dụng quản lý đơn hàng nhỏ nhưng chưa biết nên có tính năng nào. Đây đúng là lúc nên dùng phỏng vấn sâu:

Code
/deep-interview "I want to build a task management app"

Công cụ sẽ đặt câu hỏi từng bước để làm rõ bạn muốn gì, trước khi bất kỳ dòng code nào được viết. Bạn nhận được một bản yêu cầu rõ hơn, nên đỡ tốn công sửa đi sửa lại khi giao cho dev hoặc cho autopilot.

C.Dev sửa hàng loạt lỗi TypeScript

Dự án có nhiều lỗi TypeScript nằm rải rác. Bạn bật chế độ team (đã thêm biến môi trường ở trên) rồi giao cho ba agent thực thi:

Terminal
/team 3:executor "fix all TypeScript errors"

Team chạy theo chuỗi lập kế hoạch, viết yêu cầu, thực thi, kiểm tra, sửa lặp. Bạn được một lần chạy có kiểm tra thay vì tự chạy từng lỗi.

D.Nhờ nhiều công cụ AI cùng duyệt một đoạn code

Bạn đã cài sẵn Codex CLI và đang mở tmux. Muốn có ý kiến thứ hai về module đăng nhập, chạy trên terminal:

Terminal
omc team 2:codex "review auth module for security issues"
omc team status auth-review
omc team shutdown auth-review

Lệnh đầu bật hai ngăn Codex để rà soát bảo mật. Lệnh thứ hai xem trạng thái, lệnh thứ ba tắt nhóm. Cách này phù hợp để rà soát chéo, nhưng bạn vẫn nên đọc kỹ kết quả thay vì tin hoàn toàn.

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

A.Dán hai lệnh plugin cùng lúc bị lỗi

README nêu rõ hai lệnh /plugin marketplace add và /plugin install phải nhập từng lệnh một. Hãy gõ lệnh đầu, chờ xong, rồi mới gõ lệnh thứ hai.

B.Gõ lệnh /autopilot ở terminal thường

Các lệnh như /autopilot, /ralph, /execute, /team là skill trong phiên Claude Code. README nói rõ không có lệnh omc autopilot hay omc ralph ở terminal. Hãy mở Claude Code rồi gõ lệnh ở đó. Với CI, README khuyên dùng lệnh xác định như omc setup, omc ask thay vì lệnh gạch chéo.

C.Cảnh báo deprecated prebuild-install khi cài npm

Đây là cảnh báo đã biết, đến từ thư viện phụ thuộc, không phải lỗi của OMC. Nếu lệnh omc vẫn dùng được thì bạn cứ tiếp tục.

D.Sau khi cập nhật thì bị lỗi lạ

README hướng dẫn cập nhật bản marketplace bằng /plugin marketplace update omc, rồi chạy lại /omc-setup. Nếu vẫn gặp sự cố, chạy:

Terminal
/omc-doctor

README mô tả lệnh này dùng để dọn bộ nhớ đệm plugin cũ. Với bản cài bằng npm, cập nhật bằng npm i -g oh-my-claude-sisyphus@latest.

E.omc team không bật được ngăn worker

README nói loại worker này cần công cụ tương ứng (codex, gemini, agy, grok hoặc cursor-agent) đã cài và đăng nhập, cùng một phiên tmux đang chạy. Hãy kiểm tra từng điều kiện: đã vào tmux chưa, công cụ đã đăng nhập chưa.

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

Điểm mạnh. OMC gom các quy trình hay dùng (tự động hoá, phỏng vấn làm rõ yêu cầu, làm việc theo nhóm, rà soát chéo) thành vài lệnh dễ nhớ. Cài bằng hai lệnh plugin là xong phần chính. Dự án mở nguồn MIT, có cộng đồng đông (hàng chục nghìn sao) và vẫn được cập nhật, nên bạn dễ tìm trợ giúp.

Giới hạn. Dự án khá lớn và có nhiều khái niệm: team, tmux, hồ sơ autopilot, nhiều nhà cung cấp. Người mới có thể thấy rối nếu thử hết cùng lúc, nên hãy bắt đầu với /autopilot và /deep-interview. Một số tính năng có điều kiện riêng, như hồ sơ autopilot đặt tên cần Linux có flock, còn worker ngoài cần tmux. Chi phí và quota khi chạy nhiều agent README không nêu rõ, bạn cần tự theo dõi. Tài liệu cũng không có thông tin riêng về Windows hay về dữ liệu của bạn được xử lý thế nào. Dữ liệu đi qua những dịch vụ mà bạn dùng cùng OMC, nên hãy xem điều khoản của chính các dịch vụ đó.

Khi nào chọn cách khác. Nếu bạn chỉ cần một trợ lý lập trình đơn giản, Claude Code thuần có thể đã đủ. Chính README cũng giới thiệu một dự án khác tên gajae-code cho người thấy OMC hơi nặng, và oh-my-codex cho người dùng Codex CLI. Hãy thử OMC trên một dự án nhỏ trước, rồi quyết định có dùng cho việc quan trọng hay không.

4.6/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

oh-my-claudecode có miễn phí không?

Bản thân repo dùng giấy phép MIT, tức là mã nguồn mở. Tuy vậy OMC chạy cùng Claude Code và có thể gọi các công cụ AI khác, nên chi phí hoặc quota của những dịch vụ đó vẫn tính theo tài khoản của bạn. README không nêu con số cụ thể.

Cài oh-my-claudecode bằng cách nào nhanh nhất?

Trong Claude Code, gõ lần lượt `/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode` rồi `/plugin install oh-my-claudecode`, sau đó chạy `/omc-setup`. Hai lệnh đầu phải gõ từng lệnh một, không dán cùng lúc.

Gói npm tên là gì, vì sao khác tên repo?

Tên gói npm là `oh-my-claude-sisyphus`, dù repo và plugin mang tên oh-my-claudecode. Lệnh cài là `npm i -g oh-my-claude-sisyphus@latest`, và sau đó bạn có cả lệnh `oh-my-claudecode` lẫn lệnh ngắn `omc`.

Cần phiên bản Node nào?

File package.json yêu cầu Node 20, 22, 23, 24, 25 hoặc 26. Yêu cầu này áp dụng khi bạn cài hoặc chạy bản npm.

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

README không có mục riêng nói về Windows nên mình chưa có thông tin chắc chắn. Chỉ biết tính năng hồ sơ autopilot đặt tên cần Linux có `flock`, còn autopilot thường vẫn dùng được. Worker `omc team` cần tmux, nên bạn cần kiểm tra môi trường của mình.

Có cần GPU không?

Tư liệu không nhắc yêu cầu GPU hay phần cứng riêng. Công cụ điều phối các agent của Claude Code và các CLI khác, nên chưa có thông tin về yêu cầu cấu hình máy.

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

OMC thêm các quy trình dựng sẵn như `/autopilot`, `/deep-interview` và `/team` để nhiều agent phối hợp, thay vì bạn tự chia việc. Nếu việc của bạn nhỏ và đơn giản thì Claude Code thuần có thể đã đủ.

Chuyển nhanh tới mục

  1. I.oh-my-claudecode làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài plugin trong Claude Code
    2. B.Cài bằng npm (tuỳ chọn)
    3. C.Chạy setup
    4. D.Bật chế độ Team (tuỳ chọn)
  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 muốn dựng nhanh một API
    2. B.Chủ shop có ý tưởng nhưng chưa rõ cần gì
    3. C.Dev sửa hàng loạt lỗi TypeScript
    4. D.Nhờ nhiều công cụ AI cùng duyệt một đoạn code
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Dán hai lệnh plugin cùng lúc bị lỗi
    2. B.Gõ lệnh /autopilot ở terminal thường
    3. C.Cảnh báo deprecated prebuild-install khi cài npm
    4. D.Sau khi cập nhật thì bị lỗi lạ
    5. E.omc team không bật được ngăn worker
  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ỏ.