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

11 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 (OMC) là plugin và bộ công cụ dòng lệnh giúp Claude Code chạy theo kiểu nhiều agent phối hợp, ưu tiên chế độ Team. Bạn cài bằng hai lệnh plugin hoặc một lệnh npm, chạy bước setup rồi dùng các lệnh như /autopilot, /team, /deep-interview. Cài không khó, nhưng một số tính năng như omc team cần thêm tmux và các CLI khác.

oh-my-claudecode (gọi tắt là OMC) là một plugin cho Claude Code, giúp Claude làm việc theo kiểu "cả đội" thay vì một mình. Bạn nói bạn muốn gì, OMC điều phối nhiều agent để lập kế hoạch, viết code, kiểm tra và sửa lỗi. Tác giả đặt khẩu hiệu là "Don't learn Claude Code. Just use OMC" (đừng học Claude Code, cứ dùng OMC).

Bạn nên xem repo này nếu đã dùng Claude Code và thấy mỗi lần phải tự dặn dò từng bước khá mệt. Lập trình viên mới, người làm sản phẩm hay chủ doanh nghiệp nhỏ có ý tưởng phần mềm đều dùng được. Repo hiện có khoảng 40.802 sao và 3.645 fork, giấy phép MIT, viết chủ yếu bằng TypeScript và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là bạn không phải nhớ nhiều lệnh. Chỉ cần một câu như /autopilot "build a REST API for managing tasks" là chạy được một quy trình hoàn chỉnh. Nếu ý tưởng còn mơ hồ, có lệnh /deep-interview để OMC hỏi ngược lại bạn trước khi viết dòng code nào.

Plugin

Yeachan-Heo/oh-my-claudecode

Plugin điều phối nhiều agent cho Claude Code: gõ một câu lệnh như /autopilot hoặc /team, các agent tự chia việc, chạy song song và kiểm tra kết quả.

★ 41kTypeScriptMIT
Xem repo trên GitHub

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

Dưới đây là các nhóm tính năng chính theo README. Mình chỉ nói những gì tư liệu có.

A.Chế độ Team: nhiều agent chạy theo một quy trình

Team là cách điều phối chính của OMC. Lệnh mẫu: /team 3:executor "fix all TypeScript errors". Team chạy như một dây chuyền: lập kế hoạch, viết yêu cầu, thực thi, kiểm tra, rồi sửa và lặp lại nếu chưa đạt (team-plan → team-prd → team-exec → team-verify → team-fix). Lợi ích là việc lớn được chia nhỏ, có bước kiểm tra riêng, bạn không phải tự canh từng bước.

B.Autopilot: giao một việc, để nó tự đi

/autopilot nhận một mô tả bằng ngôn ngữ tự nhiên rồi tự chạy. README cũng cho phép gõ kiểu rút gọn trong phiên: autopilot: build a REST API for managing tasks. Bạn còn có thể cấu hình các hồ sơ giai đoạn (stage profile) như lập kế hoạch rồi thực thi rồi kiểm thử, nhưng đó là phần nâng cao.

C.Deep Interview: hỏi cho rõ ý trước khi làm

Khi bạn chưa biết mình cần gì, /deep-interview đặt câu hỏi kiểu Socrates để lộ ra các giả định ngầm và đo độ rõ ràng của yêu cầu. Với người không chuyên, đây là phần dễ hiểu và có ích nhất.

D.Chạy worker bằng nhiều CLI khác nhau trong tmux

Lệnh omc team mở các ô tmux, mỗi ô là một worker thật. Worker có thể là codex, gemini, antigravity, grok, cursor hoặc claude. Bạn có thể giao việc review bảo mật cho Codex, việc giao diện cho Antigravity, tùy thế mạnh. README nói worker chỉ sinh ra khi cần và tự tắt khi xong việc, nên không tốn tài nguyên lúc rảnh.

E.Hỏi ý kiến model khác

/ask codex "review this patch" trong phiên, hoặc omc ask codex "review this patch" từ terminal. Các provider được liệt kê: claude, codex, gemini, antigravity, grok, cursor, muse. Hai cách đi qua cùng một luồng tư vấn.

F.Quét cảnh báo trước khi chạy không người giám sát

omc lookout scan --brief "..." quét bản mô tả công việc và thư mục làm việc để báo các rủi ro. README ghi rõ đây chỉ là cảnh báo tham khảo, không chặn gì cả.

G.Dùng từ chương trình Node.js

Gói npm xuất các hàm TypeScript như createOmcSession() cho chương trình Node.js cục bộ dùng @anthropic-ai/claude-agent-sdk. Đây là phần cho lập trình viên, người mới có thể bỏ qua.

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

  • Claude CodeOMC là plugin cho Claude Code nên bạn cần có Claude Code và dùng được nó. README không nói rõ loại tài khoản hay gói cước nào, bạn xem thêm trong tài liệu của Claude Code.
  • Node.jsnếu cài theo đường npm, package.json yêu cầu Node 20, 22, 23, 24, 25 hoặc 26 (các bản 20.x, 22.x, 23.x, 24.x, 25.x, 26.x).
  • tmux và CLI phụchỉ cần khi dùng omc team. README nói cần một phiên tmux đang chạy và CLI bạn chọn (codex, gemini, agy, grok hoặc cursor-agent) đã cài và đã đăng nhập.
  • Linux và flockchỉ cần cho tính năng hồ sơ giai đoạn có tên (/autopilot --workflow ...). Nếu không đủ điều kiện, lệnh này bị từ chối còn autopilot thường vẫn chạy.
  • Khóa APIchạy tự động trên CI thì đặt ANTHROPIC_API_KEY hoặc đăng nhập theo từng CLI trong môi trường chạy. Dùng cá nhân bình thường, README không yêu cầu bạn tự nhập khóa.
  • Hệ điều hànhREADME chưa nói rõ Windows hay macOS có chạy đầy đủ không, ngoài các điều kiện Linux ở trên. Phần này chưa có thông tin.

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

  1. Cài pluginThêm marketplace rồi cài oh-my-claudecode trong Claude Code
  2. (Tùy chọn) Cài CLI npmCài gói oh-my-claude-sisyphus để có lệnh omc trong terminal
  3. Chạy setupDùng /omc-setup trong phiên hoặc omc setup trong terminal
  4. Bật Team (nếu dùng /team)Thêm biến môi trường vào ~/.claude/settings.json
  5. Thử một việcChạy /autopilot với một mô tả ngắn

A.Cài plugin từ marketplace (cách README khuyên dùng)

Mở Claude Code. Hai lệnh dưới đây là lệnh gạch chéo của Claude Code, không phải lệnh terminal thường. Bạn gõ trong khung chat của Claude Code. Chỗ người mới hay vấp: phải nhập từng dòng một, dán cả hai dòng cùng lúc sẽ lỗi.

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

Xong dòng trên thì mới gõ dòng tiếp theo:

Terminal
/plugin install oh-my-claudecode

B.Cài thêm CLI bằng npm (tùy chọn)

Nếu bạn muốn dùng lệnh omc ngay trong terminal (ví dụ omc team, omc ask), hoặc thích đường npm hơn marketplace, chạy lệnh sau trong terminal (PowerShell, Terminal hoặc bất kỳ cửa sổ dòng lệnh nào):

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

Lưu ý tên: dự án mang tên oh-my-claudecode nhưng gói npm tên là oh-my-claude-sisyphus. Gói này cài cả hai lệnh oh-my-claudecode và omc. Khi cài, npm có thể in cảnh báo deprecated prebuild-install@7.1.3. README cho biết cảnh báo này đến từ thư viện better-sqlite3 phía trên và tự nó không có nghĩa là cài lỗi.

C.Chạy setup

Bước này cấu hình OMC. Chọn một trong hai cách tùy bạn đang ở đâu:

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

# From your terminal
omc setup

Nếu bạn chạy OMC qua omc --plugin-dir hoặc claude --plugin-dir, README dặn thêm cờ --plugin-dir-mode cho 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 mà plugin đã có sẵn. Người dùng bình thường không cần phần này.

D.Bật chế độ Team gốc của Claude Code (nếu muốn dùng /team)

Mở file ~/.claude/settings.json và thêm khối sau. Nếu file đã có nội dung, bạn gộp phần env vào cho đúng cú pháp JSON, đừng dán đè mất cấu hình cũ.

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

README nói nếu Team bị tắt, OMC sẽ cảnh báo và chuyển sang chạy không theo nhóm khi có thể.

E.Thử một việc đầu tiên

Trong phiên Claude Code có OMC, gõ:

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

Hoặc dạng gõ tắt bằng ngôn ngữ tự nhiên:

Terminal
autopilot: build a REST API for managing tasks

OMC cho nhiều agent tự chạy và có thể sửa file trong thư mục dự án. Hãy thử trên một thư mục mẫu hoặc dự án đã có sao lưu/git trước. Mỗi agent cũng dùng thêm lượt dùng Claude (và các CLI khác nếu bạn gọi), nên chi phí có thể tăng nhanh. README chưa nêu mức chi phí cụ thể.

F.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 marketplace thì làm hai bước, lần lượt từng dòng:

Terminal
# 1. Update the marketplace clone
/plugin marketplace update omc

# 2. Re-run setup to refresh configuration
/omc-setup

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

README không đưa ra một lệnh "xác nhận thành công" riêng cho lần cài đầu. Cách thực tế là kiểm tra từng lớp:

  1. Plugin: sau /plugin install oh-my-claudecode và /omc-setup không báo lỗi, gõ thử /autopilot hoặc /deep-interview trong Claude Code. Nếu lệnh được nhận ra và OMC bắt đầu làm việc là ổn.
  2. CLI npm: mở terminal mới và gõ omc setup. Nếu máy báo không tìm thấy lệnh omc, xem phần lỗi bên dưới.
  3. Khi nghi ngờ hỏng cấu hình: README gợi ý chạy /omc-doctor để dọn plugin cũ sau khi cập nhật.

Với omc team, bạn kiểm tra bằng omc team status <tên> như ở phần ví dụ bên dưới.

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

A.Người có ý tưởng nhưng chưa rõ mình cần gì

Bạn là chủ một cửa hàng nhỏ, muốn có công cụ quản lý đơn nhưng chưa biết nên gồm những gì. Thay vì viết yêu cầu dở dang rồi để Claude đoán, bạn chạy:

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

OMC hỏi bạn lần lượt nhiều câu để làm rõ mục tiêu và các giả định. Kết quả là bạn hiểu mình định xây gì trước khi bất kỳ dòng code nào được viết, nên đỡ phải làm lại.

Đừng học thuộc lệnh. Hãy tả việc bạn muốn bằng một câu rõ ràng, rồi để cả đội agent lo phần còn lại.

Ông T

B.Lập trình viên mới muốn có bản chạy thử nhanh

Bạn đã có ý tưởng đủ rõ và cần một khung API ban đầu. Gõ:

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

OMC tự đi qua các giai đoạn thay bạn. Bạn nhận về một dự án để đọc, chạy thử và chỉnh tiếp. Hãy luôn đọc lại kết quả trước khi dùng thật.

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

Dự án có một đống lỗi biên dịch lặp lại. Dùng chế độ Team để chia việc:

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

Con số 3 là số worker thực thi. Dây chuyền plan, PRD, exec, verify, fix sẽ lặp cho tới khi bước kiểm tra qua. Bạn tiết kiệm được thời gian ngồi sửa từng file.

D.Review chéo bằng nhiều model

Bạn vừa viết xong một module đăng nhập và muốn có ý kiến thứ hai. Nếu đã cài và đăng nhập Codex CLI và có tmux, chạy trong terminal:

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

Dòng đầu mở 2 worker Codex để review bảo mật. Dòng hai xem tiến độ, dòng ba tắt nhóm khi xong. Cái tên auth-review ở đây là tên mà README dùng làm ví dụ; bạn xem tên nhóm thật mà lệnh trả về để dùng cho đúng. Nếu chỉ muốn một ý kiến nhanh, dùng omc ask codex "review this patch" hoặc /ask codex "review this patch".

Trước khi để agent chạy lâu không ai trông, bạn có thể quét rủi ro:

Terminal
omc lookout scan --brief "..."

Thay phần trong ngoặc kép bằng mô tả công việc thật của bạn. Thêm --strict nếu muốn lệnh trả mã lỗi 1 khi có tín hiệu rủi ro cao, hoặc --json để lấy kết quả dạng máy đọc.

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ói rõ phải nhập từng lệnh một. Hãy gõ lệnh marketplace add trước, chờ xong rồi mới gõ install.

B.npm báo deprecated prebuild-install

Đây là cảnh báo đã biết, đến từ thư viện better-sqlite3 mà OMC phụ thuộc. README ghi chưa có cách sửa an toàn từ phía repo và cảnh báo này không có nghĩa là cài thất bại. Nếu sau đó omc chạy được thì bạn cứ dùng bình thường.

C.omc team không chạy

Lệnh này cần một phiên tmux đang hoạt động và CLI của worker bạn chọn phải được cài, đăng nhập sẵn (codex, gemini, agy, grok hoặc cursor-agent). Kiểm tra từng thứ: đang ở trong tmux chưa, CLI đó mở riêng có chạy được không.

D./team chạy nhưng không thấy chạy theo nhóm

Có thể Team gốc chưa được bật. Hãy kiểm tra ~/.claude/settings.json có khối env với CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS đặt bằng "1" không, rồi mở lại Claude Code.

E.Sau khi cập nhật thì có triệu chứng lạ

README gợi ý chạy /omc-doctor để xử lý plugin cache cũ. Nếu bạn cập nhật theo kiểu marketplace, nhớ chạy /plugin marketplace update omc rồi /omc-setup như ở phần cập nhật.

F.Dùng /autopilot trong CI bị lỗi

Các lệnh gạch chéo như /autopilot, /ralph, /execute, /team cần một phiên Claude Code đang mở. README khuyên với CI hoặc chạy tự động thì dùng lệnh terminal cố định như omc setup, omc ask và đặt ANTHROPIC_API_KEY hoặc đăng nhập CLI tương ứng.

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

Điểm mạnh. Cài gọn bằng hai lệnh, dùng bằng ngôn ngữ tự nhiên. Có sẵn quy trình nhiều bước (lập kế hoạch, thực thi, kiểm tra, sửa) nên bạn bớt phải tự điều khiển. Giấy phép MIT, cộng đồng lớn, tài liệu có nhiều ngôn ngữ trong đó có tiếng Việt, và repo được cập nhật thường xuyên.

Giới hạn. Có hai lớp cách dùng (lệnh trong phiên và lệnh terminal) nên người mới dễ lẫn. Ví dụ, README nói rõ không có lệnh omc autopilot hay omc ralph trong terminal. Một số tính năng đòi hỏi tmux, CLI khác, hoặc Linux. Repo không có tiện ích mở rộng cho VS Code. Chạy nhiều agent đồng nghĩa dùng nhiều lượt hơn, còn mức tiêu hao cụ thể thì README chưa nêu.

Khi nào chọn cách khác. Nếu bạn chỉ cần Claude Code làm việc nhỏ, một mình nó là đủ. Chính tác giả cũng giới thiệu hai hướng thay thế: oh-my-codex cho người dùng Codex CLI, và gajae-code cho người thấy OMC hơi nặng và muốn nhẹ hơn. Hãy thử OMC trên một dự án nhỏ trước khi dùng cho việc quan trọng.

4.8/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ở và dùng tự do. Tuy nhiên OMC chạy trên Claude Code và có thể gọi thêm các CLI khác, nên chi phí dùng các dịch vụ đó vẫn theo cách tính của từng nhà cung cấp. README không nêu chi phí cụ thể.

Cài oh-my-claudecode có khó không?

Không khó. Cách khuyên dùng là hai lệnh /plugin trong Claude Code (gõ từng lệnh một) rồi chạy /omc-setup. Nếu thích dùng terminal, bạn cài bằng npm i -g oh-my-claude-sisyphus@latest rồi chạy omc setup.

Tên repo là oh-my-claudecode nhưng gói npm lại là oh-my-claude-sisyphus, có nhầm không?

Không nhầm. README giải thích dự án mang tên oh-my-claudecode nhưng gói npm xuất bản dưới tên oh-my-claude-sisyphus. Gói này cài cả lệnh oh-my-claudecode và lệnh ngắn omc.

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

README không nói rõ về Windows nói chung. Chỉ có ghi chú là tính năng hồ sơ giai đoạn có tên của autopilot cần Linux có tiện ích flock, còn omc team cần tmux. Chưa có thông tin cụ thể hơn cho Windows.

Khác gì so với dùng Claude Code thông thường?

OMC thêm lớp điều phối nhiều agent lên Claude Code, với các lệnh như /autopilot, /team, /deep-interview. Bạn mô tả việc cần làm và quy trình nhiều bước được chạy giúp. Tác giả nhấn mạnh bạn không cần học thêm nhiều về Claude Code để dùng.

Có cần GPU hay máy mạnh không?

README không nhắc yêu cầu GPU hay cấu hình phần cứng. OMC điều phối các agent và CLI chạy qua dịch vụ của họ, nên phần cứng chưa được nêu là yêu cầu. Nếu mở nhiều worker tmux cùng lúc thì máy bạn vẫn phải đủ sức chạy các CLI đó, nhưng chưa có số liệu.

Có dùng được với Codex hoặc Gemini không?

Có, thông qua lệnh omc team (ví dụ omc team 2:codex) và /ask hoặc omc ask. Bạn cần cài và đăng nhập CLI tương ứng, và cần có phiên tmux đang chạy. Với Gemini, README ghi là phù hợp kiểu doanh nghiệp hoặc khóa API.

Chuyển nhanh tới mục

  1. I.OMC làm được gì
    1. A.Chế độ Team: nhiều agent chạy theo một quy trình
    2. B.Autopilot: giao một việc, để nó tự đi
    3. C.Deep Interview: hỏi cho rõ ý trước khi làm
    4. D.Chạy worker bằng nhiều CLI khác nhau trong tmux
    5. E.Hỏi ý kiến model khác
    6. F.Quét cảnh báo trước khi chạy không người giám sát
    7. G.Dùng từ chương trình Node.js
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài plugin từ marketplace (cách README khuyên dùng)
    2. B.Cài thêm CLI bằng npm (tùy chọn)
    3. C.Chạy setup
    4. D.Bật chế độ Team gốc của Claude Code (nếu muốn dùng /team)
    5. E.Thử một việc đầu tiên
    6. F.Cập nhật về sau
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Người có ý tưởng nhưng chưa rõ mình cần gì
    2. B.Lập trình viên mới muốn có bản chạy thử nhanh
    3. C.Dev sửa hàng loạt lỗi TypeScript
    4. D.Review chéo bằng nhiều model
  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.npm báo deprecated prebuild-install
    3. C.omc team không chạy
    4. D./team chạy nhưng không thấy chạy theo nhóm
    5. E.Sau khi cập nhật thì có triệu chứng lạ
    6. F.Dùng /autopilot trong CI bị lỗi
  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ỏ.