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

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.
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.
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.jsonyê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,grokhoặccursor-agent, đã cài và đăng nhập) nếu bạn muốn dùngomc teamvới worker bên ngoài. - Linux có tiện ích
flocknế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_KEYhoặ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
- Cài pluginThêm marketplace rồi cài plugin trong Claude Code
- (Tuỳ chọn) Cài bằng npmCài lệnh omc trên terminal
- Chạy setupCấu hình bằng /omc-setup hoặc omc setup
- Bật team (tuỳ chọn)Thêm biến môi trường vào settings.json
- 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:
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecodeSau khi xong, gõ tiếp lệnh thứ hai để cài:
/plugin install oh-my-claudecodeChỗ 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:
npm i -g oh-my-claude-sisyphus@latestSau 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:
# Inside a Claude Code / OMC session
/omc-setup
# From your terminal
omc setupNế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:
{
"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õ:
/autopilot "build a REST API for managing tasks"README cũng cho phép gõ kiểu câu thường trong phiên:
autopilot: build a REST API for managing tasksNế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:
/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:
/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:
/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:
omc team 2:codex "review auth module for security issues"
omc team status auth-review
omc team shutdown auth-reviewLệ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:
/omc-doctorREADME 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.
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ể đã đủ.


