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 (viết tắt OMC) là plugin và công cụ dòng lệnh giúp Claude Code làm việc theo nhóm nhiều agent, theo hướng "Team-first". Bạn mô tả việc cần làm bằng lời thường, OMC lo phần lập kế hoạch, chạy và kiểm tra. Cài bằng hai lệnh plugin hoặc một lệnh npm, rồi chạy bước setup, nên không quá khó nếu bạn đã dùng Claude Code.
oh-my-claudecode (gọi tắt là OMC) là một plugin điều phối nhiều agent cho Claude Code. Nó đi kèm một công cụ dòng lệnh tên omc. Tác giả mô tả ngắn gọn là "Teams-first multi-agent orchestration for Claude Code" và khẩu hiệu là "Don't learn Claude Code. Just use OMC". Nghĩa là bạn không cần học thuộc nhiều lệnh, chỉ cần nói mình muốn gì.
Vấn đề repo giải quyết khá quen thuộc. Khi bạn giao cho một AI một việc lớn, ví dụ dựng cả một API hay sửa hàng loạt lỗi, một phiên chat đơn lẻ dễ bị rối, làm chậm và khó kiểm soát. OMC chia việc thành các giai đoạn, cho nhiều agent làm song song, rồi có bước kiểm tra và sửa lại. Repo hiện có khoảng 40802 sao và 3645 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong 3 tháng gần đây.
Bài này hợp với người đã dùng Claude Code và muốn giao việc lớn hơn cho AI: lập trình viên mới, người làm sản phẩm, chủ dự án nhỏ tự dựng công cụ nội bộ. Điểm đáng giá nhất là chế độ Team: một pipeline có sẵn từ lập kế hoạch đến kiểm tra, mà bạn khởi động bằng đúng một câu lệnh.
Yeachan-Heo/oh-my-claudecode
Plugin điều phối nhiều agent cho Claude Code: gõ yêu cầu bằng lời, công cụ tự chia việc, chạy song song và kiểm tra kết quả.
I.OMC làm được gì
Dưới đây là những phần chính theo README. Mình chỉ nói những gì tài liệu có ghi.
- Autopilotbạn đưa một yêu cầu bằng lời, ví dụ "build a REST API for managing tasks", OMC tự đi hết quy trình. Lợi ích là bạn không phải điều khiển từng bước nhỏ.
- Team mode (khuyên dùng)đây là bề mặt điều phối chính của OMC. Công việc chạy qua chuỗi
team-plan → team-prd → team-exec → team-verify → team-fix, và bước sửa lỗi lặp lại cho đến khi qua kiểm tra. Bạn gọi bằng/team 3:executor "...", tức nhờ 3 agent loại executor cùng làm. - Tmux CLI workerslệnh
omc teammở các cửa sổ tmux chạy công cụ khác nhau (Codex, Gemini, Antigravity, Grok, Cursor, Claude). Lợi ích là bạn dùng đúng "người làm" cho đúng việc, ví dụ Codex để xem lại mã, Antigravity để làm giao diện. Worker chỉ sinh ra khi cần và tắt khi xong việc. - Hỏi nhà cung cấp khác bằng
askomc ask codex "review this patch"hoặc/ask codex "..."để lấy ý kiến thứ hai. Danh sách nhà cung cấp trong README: claude, codex, gemini, antigravity, grok, cursor, muse. - Deep interviewkhi ý tưởng còn mơ hồ,
/deep-interviewhỏi bạn theo kiểu hỏi dồn trước khi viết mã. Nó giúp lộ ra các giả định ngầm, nên bạn biết rõ mình cần xây gì trước khi chạy. - Lookout scan
omc lookout scan --brief "..."quét bản mô tả công việc và thư mục làm việc trước khi chạy tự động, rồi báo các dấu hiệu nguy hiểm. README ghi đây chỉ là cảnh báo tham khảo. - Quy trình tự định nghĩa cho autopilotbạn có thể đặt tên một dãy giai đoạn (ví dụ lập kế hoạch, thực thi, QA) trong file cấu hình, rồi gọi bằng
--workflow. - Dùng như thư việngói npm có xuất các hàm TypeScript như
createOmcSession()cho chương trình Node.js dùng@anthropic-ai/claude-agent-sdk.
II.Cần chuẩn bị gì
Theo README và package.json, bạn cần:
- Claude Code đã cài và đăng nhập được. OMC là plugin cho Claude Code nên không có nó thì các lệnh dạng
/...không chạy. - Node.js nếu cài qua npm.
package.jsonyêu cầu Node 20, 22, 23, 24, 25 hoặc 26 (các dòng chẵn lẫn lẻ như ghi trong file). - tmux đang chạy, nếu bạn muốn dùng
omc teamđể mở các worker. README ghi cần một phiên tmux đang hoạt động. - CLI của công cụ bạn chọn làm worker:
codex,gemini,agy(Antigravity),grokhoặccursor-agent, đã cài và đăng nhập. Chỉ cần khi bạn dùng đúng loại đó. - Linux có tiện ích
flock, chỉ cần nếu bạn dùng tính năng quy trình đặt tên (--workflow). Môi trường khác sẽ từ chối lệnh này, còn autopilot kiểu cũ vẫn chạy. - Khóa API hoặc đăng nhập của từng nhà cung cấp: với chạy tự động không có người ngồi trước, README nói đặt
ANTHROPIC_API_KEYhoặc đăng nhập của CLI tương ứng trong môi trường chạy.
Tư liệu không nói gì về yêu cầu GPU hay cấu hình máy tối thiểu, nên mình không đoán.
III.Cài đặt từng bước
- Cài pluginNhập hai lệnh /plugin trong Claude Code, từng lệnh một
- Hoặc cài bằng npmDùng npm i -g oh-my-claude-sisyphus@latest nếu thích CLI
- Chạy setup/omc-setup trong phiên Claude Code, hoặc omc setup ở terminal
- Bật Team (tuỳ chọn)Thêm biến môi trường vào ~/.claude/settings.json
- Thử chạyGõ /autopilot với một yêu cầu nhỏ
A.Cách 1: cài qua plugin của Claude Code (README khuyên dùng)
Mở Claude Code, rồi nhập từng lệnh dưới đây. Đây là lệnh gạch chéo của Claude Code, không phải lệnh terminal. README nhấn mạnh phải nhập từng dòng một, dán cả hai dòng cùng lúc sẽ lỗi.
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecodeLệnh này thêm kho plugin của OMC vào Claude Code. Chờ xong rồi mới nhập lệnh tiếp:
/plugin install oh-my-claudecodeLệnh này cài plugin về.
B.Cách 2: cài bằng npm
Nếu bạn thích chạy omc ngay từ terminal, mở terminal (trên Windows là PowerShell hoặc Git Bash) và chạy:
npm i -g oh-my-claude-sisyphus@latestChỗ người mới hay vấp: tên repo và plugin là oh-my-claudecode, nhưng tên gói npm lại là oh-my-claude-sisyphus. Đây không phải gõ nhầm. Sau khi cài, bạn có cả hai lệnh oh-my-claudecode và omc, và README dùng omc cho gọn.
Trong lúc 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.Bước 3: chạy setup
Sau khi cài xong, chạy bước thiết lập. Có hai cách tương đương:
# Inside a Claude Code / OMC session
/omc-setup
# From your terminal
omc setupDòng đầu gõ trong phiên Claude Code, dòng sau gõ ở terminal. README còn nói nếu bạn chạy OMC qua omc --plugin-dir hoặc claude --plugin-dir, hãy thêm --plugin-dir-mode vào omc setup (hoặc đặt biến OMC_PLUGIN_ROOT trước khi chạy) để trình cài không nhân đôi skill và agent. Nếu bạn cài bình thường thì không cần quan tâm phần này. Muốn xem đầy đủ các cờ, README trỏ đến file REFERENCE.md trong repo.
D.Bước 4: bật Team mode (tuỳ chọn)
Chế độ Team dùng tính năng nhóm agent thử nghiệm của Claude Code. Mở file ~/.claude/settings.json và thêm:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}Nếu file đã có nội dung, hãy thêm khối env vào cho đúng cú pháp JSON, đừng dán đè lên toàn bộ file. README nói nếu Team bị tắt, OMC sẽ cảnh báo và chuyển về chế độ không dùng team khi có thể.
E.Cập nhật về sau
Cài bằng npm thì chạy lại lệnh cài ở trên. Cài bằng plugin thì làm hai bước:
# 1. Update the marketplace clone
/plugin marketplace update omc
# 2. Re-run setup to refresh configuration
/omc-setupNếu sau khi cập nhật có trục trặc, README gợi ý chạy /omc-doctor để dọn bộ nhớ đệm plugin cũ.
IV.Kiểm tra đã chạy được chưa
README không có một lệnh "kiểm tra phiên bản" riêng, nên mình đưa ra các cách kiểm tra dựa trên những gì tài liệu có:
- Mở Claude Code và gõ
/omc-setup. Nếu lệnh được nhận ra và chạy, plugin đã vào. - Ở terminal, gõ
omc setup. Nếu máy báo không tìm thấy lệnhomc, nghĩa là bản npm chưa cài hoặc thư mục lệnh toàn cục chưa nằm trong PATH. - Chạy
/omc-doctornếu nghi ngờ cài lỗi hoặc cache cũ. - Thử một yêu cầu nhỏ:
/autopilot "build a REST API for managing tasks"Nếu Claude Code bắt đầu lập kế hoạch và làm việc theo yêu cầu, bạn đã cài thành công. README cũng cho phép gõ tắt theo kiểu lời nói trong phiên: autopilot: build a REST API for managing tasks.
Autopilot và Team có thể dùng nhiều lượt gọi mô hình cùng lúc, nên chi phí và hạn mức tài khoản có thể tăng nhanh hơn một phiên chat thường. Hãy thử với việc nhỏ trước. Tài liệu không đưa ra con số chi phí cụ thể nên bạn nên tự theo dõi mức dùng.
V.Dùng vào việc thật
A.Dev mới dựng thử một API từ ý tưởng
Bạn là lập trình viên mới và được giao dựng nhanh một API quản lý công việc. Thay vì tự chia từng bước, bạn mở Claude Code trong thư mục dự án rồi gõ:
/autopilot "build a REST API for managing tasks"OMC tự đi qua các giai đoạn lập kế hoạch, thực thi và kiểm tra. Kết quả là một bộ mã bạn có thể đọc và chạy thử, thay vì một đống câu trả lời rời rạc. Bạn vẫn nên đọc lại mã trước khi dùng thật.
B.Người có ý tưởng nhưng chưa rõ cần gì
Bạn là chủ cửa hàng muốn có một công cụ quản lý đơn nhưng chưa biết nên làm những gì. Bắt đầu bằng phỏng vấn thay vì lao vào làm:
/deep-interview "I want to build a task management app"OMC hỏi bạn từng câu để làm rõ yêu cầu và đo mức độ rõ ràng theo nhiều tiêu chí. Khi đã rõ, bạn mới chuyển sang autopilot hay team. Kết quả là bớt cảnh làm xong rồi mới nhận ra mình hiểu sai.
Đừng học thuộc Claude Code, hãy bắt đầu bằng việc nói rõ mình muốn gì.
Ông T
C.Sửa hàng loạt lỗi bằng nhóm agent
Dự án của bạn đang báo nhiều lỗi TypeScript. Dùng chế độ Team để chia nhau xử lý:
/team 3:executor "fix all TypeScript errors"3 agent executor cùng làm, rồi pipeline kiểm tra và sửa lặp lại. Bạn nhận về một lượt sửa có kiểm chứng, thay vì phải ngồi sửa từng file.
D.Xem lại mã bằng nhiều "con mắt"
Trước khi gộp một đoạn mã quan trọng, bạn muốn có thêm ý kiến từ công cụ khác. Nếu máy đã cài Codex CLI và đang trong phiên tmux:
omc team 2:codex "review auth module for security issues"
omc team status auth-review
omc team shutdown auth-reviewDòng đầu mở 2 worker Codex xem lại mô-đun đăng nhập. Dòng hai xem trạng thái, dòng ba tắt worker khi xong. Tên auth-review là tên phiên theo ví dụ trong README, bạn đối chiếu với tên thật mà lệnh trả về. Bạn có thể kết hợp với /ask codex và /ask antigravity để lấy hai góc nhìn rồi nhờ Claude tổng hợp.
VI.Lỗi hay gặp và cách xử lý
Dán hai lệnh /plugin cùng lúc rồi bị lỗi. README đã cảnh báo điều này. Hãy nhập từng lệnh một, chờ lệnh đầu xong mới nhập lệnh sau.
Gõ omc báo không tìm thấy lệnh. Có thể bạn mới cài plugin mà chưa cài bản npm, vì lệnh omc ở terminal đến từ gói npm. Cài bằng npm i -g oh-my-claude-sisyphus@latest, rồi mở lại terminal. Nếu vẫn không được, kiểm tra Node đã đúng phiên bản yêu cầu chưa.
Gõ omc autopilot hay omc ralph không chạy. README nói rõ các lệnh này không tồn tại ở dạng lệnh terminal. Autopilot, Ralph, Execute và Deep Interview chỉ chạy dưới dạng lệnh gạch chéo bên trong phiên Claude Code. Tương tự, đừng dựa vào các lệnh gạch chéo trong CI, vì chúng cần một phiên Claude Code đang mở.
omc team không mở được worker. Kiểm tra bạn đang ở trong phiên tmux và CLI tương ứng (codex, gemini, agy, grok, cursor-agent) đã cài, đã đăng nhập. Trên Windows, tmux không có sẵn nên nhiều khả năng bạn cần môi trường như WSL. README không hướng dẫn riêng phần này nên bạn nên xem thêm tài liệu của dự án.
Cài xong nhưng hành vi lạ sau khi cập nhật. Làm theo gợi ý của README: cập nhật marketplace, chạy lại /omc-setup, và dùng /omc-doctor để dọn cache plugin cũ.
Dùng --workflow bị từ chối. Tính năng này cần Linux có flock. Trên môi trường khác, lệnh bị từ chối trước khi tạo hay đổi trạng thái nào. Bạn vẫn dùng autopilot không có --workflow bình thường.
VII.Có nên dùng không
Điểm mạnh. OMC cho bạn một quy trình sẵn: lập kế hoạch, làm song song, kiểm tra, sửa lại. Bạn nói bằng lời thường là đủ. Repo có giấy phép MIT, đang được cập nhật, có tài liệu nhiều ngôn ngữ (có cả bản tiếng Việt trong repo) và một cộng đồng đáng kể.
Giới hạn. Công cụ này đặt trên nền Claude Code, nên bạn cần dùng Claude Code trước. Một số tính năng đòi hỏi môi trường cụ thể: tmux cho omc team, Linux với flock cho --workflow. Team mode phụ thuộc một biến thử nghiệm của Claude Code nên có thể thay đổi theo thời gian. README không có phần giải thích mức chi phí, và phần lớn nội dung chạy theo kiểu tự động nên bạn cần đọc lại kết quả trước khi dùng thật. README cũng nói rõ OMC không có tiện ích mở rộng cho VS Code.
Khi nào nên chọn cách khác. Nếu việc của bạn nhỏ, chỉ cần hỏi đáp hay sửa một file, Claude Code thường là đủ và đơn giản hơn. Nếu bạn dùng Codex CLI thay vì Claude Code, tác giả có repo anh em tên oh-my-codex. Còn nếu thấy OMC hơi nặng, tác giả cũng gợi ý một repo khác tên gajae-code, được mô tả là nhanh, rẻ và đơn giản hơn. Mình chưa kiểm chứng điều này, bạn nên tự đọc và thử.
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 nên bạn dùng và sửa được. Tuy nhiên OMC chạy trên Claude Code và có thể gọi các CLI khác như Codex hay Gemini, nên chi phí của các dịch vụ đó vẫn theo gói của từng bên. Tài liệu không nêu số tiền cụ thể.
Cài oh-my-claudecode bằng cách nào nhanh nhất?
Trong Claude Code, nhập từng dòng: /plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode rồi /plugin install oh-my-claudecode. Sau đó chạy /omc-setup. Nếu thích dùng terminal, bạn có thể cài bằng npm i -g oh-my-claude-sisyphus@latest rồi chạy omc setup.
Tại sao tên repo là oh-my-claudecode mà gói npm lại là oh-my-claude-sisyphus?
README giải thích dự án mang thương hiệu oh-my-claudecode (repo, plugin, lệnh), còn gói npm được xuất bản dưới tên oh-my-claude-sisyphus. Khi cài bằng npm, bạn nhậ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. Nếu bạn chỉ cài qua plugin của Claude Code thì README không nêu rõ yêu cầu Node riêng, nên bạn xem thêm tài liệu của dự án nếu gặp lỗi.
Có chạy được trên Windows không?
README không có phần nói riêng về Windows. Lệnh omc team cần tmux, và tính năng quy trình đặt tên (--workflow) cần Linux với flock, nên một số tính năng có thể không dùng được trên Windows thuần. Chưa có thông tin chính thức về WSL trong tư liệu mình đọc.
Cần GPU không?
Tư liệu không nhắc đến yêu cầu GPU hay cấu hình phần cứng. OMC điều phối các công cụ như Claude Code, Codex hay Gemini qua dòng lệnh, nên phần tính toán nặng do các dịch vụ đó đảm nhiệm.
OMC khác gì dùng Claude Code trực tiếp?
Claude Code là công cụ nền. OMC thêm lớp điều phối: autopilot, chế độ Team với quy trình lập kế hoạch, thực thi và kiểm tra, cùng khả năng mở nhiều worker song song. Bạn dùng Claude Code thuần cho việc nhỏ, còn OMC có lợi hơn khi việc lớn và cần chia nhỏ.


