# 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 (gọi tắt là OMC) là plugin kèm công cụ dòng lệnh, giúp Claude Code điều phối nhiều agent làm việc cùng lúc theo từng giai đoạn: lập kế hoạch, làm, kiểm tra, sửa. Bạn gõ yêu cầu bằng tiếng thường, OMC lo phần chia việc. Cài bằng hai lệnh trong Claude Code, hoặc một lệnh npm, rồi chạy bước setup nên khá dễ với người đã dùng Claude Code.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-30 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/oh-my-claudecode-dieu-phoi-nhieu-agent-claude-code-2

oh-my-claudecode (gọi tắt là OMC) là một plugin cho Claude Code, kèm công cụ dòng lệnh `omc`, chuyên điều phối nhiều agent AI cùng làm một việc. Thay vì bạn ngồi nhắn qua lại với một Claude duy nhất, OMC chia việc thành các giai đoạn và cho nhiều agent chạy theo nhóm: lập kế hoạch, viết yêu cầu, thực thi, kiểm tra, rồi sửa lỗi nếu cần.

Repo này hợp với ai? Với lập trình viên đã dùng Claude Code và thấy một phiên làm việc đơn lẻ hơi chậm khi gặp việc lớn. Với người mới cũng được, vì tác giả đặt khẩu hiệu "không cần học Claude Code, cứ dùng OMC". Bạn chỉ cần mô tả điều muốn làm bằng ngôn ngữ thường, ví dụ "xây một REST API quản lý công việc".

Điểm đáng giá nhất là hai thứ. Một là chế độ Team, nơi nhiều agent làm việc theo một quy trình có kiểm tra và vòng sửa lỗi. Hai là khả năng gọi thêm các công cụ AI khác như Codex hay Gemini làm "nhân viên" chạy song song. Hiện repo có khoảng 40.800 sao và khoảng 3.600 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.

```repo
- repo | Yeachan-Heo/oh-my-claudecode
- kind | Plugin
- desc | Plugin và CLI giúp Claude Code chạy nhiều agent song song theo kiểu làm việc nhóm, có lệnh /autopilot và /team để giao việc lớn.
- stars | 41k
- lang | TypeScript
- license | MIT
```

## OMC làm được gì

Dưới đây là các khả năng chính, theo đúng những gì README mô tả.

### Giao cả việc lớn bằng một lệnh

Lệnh `/autopilot` nhận một yêu cầu bằng câu thường, ví dụ "build a REST API for managing tasks". Bạn không phải tự chia nhỏ việc hay chọn agent. Lợi ích thực tế: bạn mô tả mục tiêu, phần còn lại README gọi là "tự động".

### Chế độ Team: nhiều agent làm theo quy trình

Team là cách điều phối chính của OMC. Nó chạy như một đường ống: lập kế hoạch, viết đặc tả sản phẩm, thực thi, kiểm tra, rồi sửa lỗi và lặp lại nếu chưa đạt. Cú pháp mẫu là `/team 3:executor "fix all TypeScript errors"`, nghĩa là dùng 3 agent thực thi để sửa hết lỗi TypeScript. Việc có bước kiểm tra riêng giúp bạn đỡ phải tự rà từng thay đổi.

### Gọi các công cụ AI khác chạy song song trong tmux

Lệnh `omc team` mở các ô tmux, mỗi ô là một worker chạy bằng Codex, Gemini, Antigravity, Grok, Cursor hoặc Claude. Ví dụ `omc team 2:codex "review auth module for security issues"` cho 2 worker Codex rà soát bảo mật. README nói worker chỉ chạy khi cần và tắt khi xong việc, nên không tốn tài nguyên lúc rảnh.

### Hỏi ý kiến nhiều mô hình

Lệnh `/ask codex "..."` (hoặc `omc ask codex "..."` trong terminal) hỏi một nhà cung cấp cụ thể. Danh sách nhà cung cấp trong README gồm claude, codex, gemini, antigravity, grok, cursor, muse. Bạn có thể hỏi Codex về kiến trúc, hỏi Antigravity về giao diện, rồi nhờ Claude tổng hợp.

### Phỏng vấn làm rõ yêu cầu trước khi viết code

Nếu ý tưởng còn mơ hồ, lệnh `/deep-interview` hỏ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 có dòng code nào. Rất hợp cho người không rành kỹ thuật.

### Quét cảnh báo trước khi chạy tự động

Lệnh `omc lookout scan --brief "..."` quét bản mô tả việc cần làm và thư mục làm việc, rồi báo các dấu hiệu nguy hiểm trước khi bạn để máy chạy không người trông. README ghi rõ đây chỉ là cảnh báo tham khảo, không chặn gì cả.

## Cần chuẩn bị gì

Tư liệu repo nói những điều sau, mình chỉ nêu lại đúng như vậy:

- **Claude Code**: OMC là plugin của Claude Code, nên bạn cần có Claude Code để dùng các lệnh `/...`.
- **Node.js**: nếu cài bằng npm, `package.json` yêu cầu Node 20, 22, 23, 24, 25 hoặc 26 (các bản 20.x đến 26.x ghi trong file khai báo).
- **tmux**: chỉ cần khi dùng `omc team` để mở các worker. README yêu cầu có phiên tmux đang chạy và các công cụ tương ứng (`codex`, `gemini`, `agy`, `grok` hoặc `cursor-agent`) đã cài và đăng nhập.
- **Linux có tiện ích `flock`**: chỉ cần cho tính năng "named autopilot stage profiles" (cấu hình các giai đoạn đặt tên). Môi trường không hỗ trợ thì lệnh `/autopilot --workflow` bị từ chối, còn autopilot thông thường vẫn dùng được.
- **Khóa API hoặc đăng nhập**: chỉ khi chạy tự động trong CI, README bảo đặt `ANTHROPIC_API_KEY` hoặc đăng nhập của công cụ tương ứng trong môi trường chạy.

README chưa nói rõ về yêu cầu phần cứng hay gói đăng ký Claude cụ thể. Bạn xem thêm trong phần tài liệu của dự án.

```note
Một số tính năng gọi nhiều agent cùng lúc, nên có thể dùng nhiều lượt hơn bình thường. README không nêu chi phí cụ thể, hãy thử với việc nhỏ trước và theo dõi mức dùng trong tài khoản của bạn.
```

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

```steps
- Cài plugin | Thêm marketplace rồi cài oh-my-claudecode trong Claude Code
- Hoặc cài bằng npm | Dùng npm i -g oh-my-claude-sisyphus@latest nếu thích đường dòng lệnh
- Chạy setup | Gõ /omc-setup trong phiên Claude Code, hoặc omc setup trong terminal
- Bật team (tuỳ chọn) | Thêm biến môi trường vào ~/.claude/settings.json
- Thử việc đầu tiên | Chạy /autopilot với một yêu cầu nhỏ
```

### Cách 1: Cài bằng plugin (README khuyên dùng)

Mở Claude Code trong thư mục dự án của bạn. Hai lệnh dưới đây là lệnh gạch chéo của Claude Code, nên gõ vào khung chat của Claude Code chứ không phải terminal thường. Chỗ người mới hay vấp: 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.

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

Đợi lệnh đầu xong rồi mới gõ lệnh tiếp theo:

```bash
/plugin install oh-my-claudecode
```

### Cách 2: Cài bằng npm

Nếu bạn thích dùng lệnh `omc` ngay trong terminal, mở terminal (PowerShell, Terminal, hay cửa sổ lệnh đều được, miễn đã cài Node) và chạy:

```bash
npm i -g oh-my-claude-sisyphus@latest
```

Lưu ý về tên: dự án mang tên oh-my-claudecode, nhưng gói trên npm tên là `oh-my-claude-sisyphus`. Cài xong bạn có cả lệnh `oh-my-claudecode` và lệnh ngắn `omc`. 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 bên ngoài và không có nghĩa là cài thất bại.

### Chạy bước setup

Sau khi cài, bạn cần chạy setup một lần. Có hai cách, chọn một:

```bash
# Inside a Claude Code / OMC session
/omc-setup

# From your terminal
omc setup
```

Dòng đầu gõ trong khung chat Claude Code, dòng thứ hai gõ trong terminal. README có thêm lưu ý: 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 đặt 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 quan tâm đến phần này.

### Bật tính năng Team (tuỳ chọn)

Để dùng Team gốc của Claude Code, README yêu cầu thêm đoạn sau vào file `~/.claude/settings.json`. Nếu file đã có nội dung, hãy thêm khối `env` vào đúng chỗ chứ đừng xoá phần cũ:

```json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
```

Nếu chưa bật, README nói OMC sẽ cảnh báo và quay về chạy không theo nhóm khi có thể.

### 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 việc:

```bash
# 1. Update the marketplace clone
/plugin marketplace update omc

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

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

README không đưa ra một lệnh "kiểm tra phiên bản" hay màn hình thành công cụ thể. Cách kiểm tra thực tế dựa trên những gì tư liệu có:

1. Trong Claude Code, gõ `/omc-setup` và xem nó chạy hết không báo lỗi. Nếu bạn đã cài bằng npm, lệnh `omc setup` ở terminal có tác dụng tương tự.
2. Thử một việc nhỏ bằng `/autopilot "..."`. Nếu Claude Code nhận lệnh và bắt đầu lên kế hoạch, plugin đã hoạt động.
3. Nếu sau khi cập nhật có vấn đề lạ, README gợi ý chạy `/omc-doctor` để xử lý bộ nhớ đệm plugin cũ.

Về cảnh báo `prebuild-install` khi cài npm: đó không phải dấu hiệu lỗi, như README đã nói.

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

Các tình huống dưới đây bám theo những lệnh có trong README. Kết quả cụ thể phụ thuộc vào dự án của bạn, mình không hứa trước.

### Chủ shop muốn dựng công cụ nhỏ nhưng chưa rõ cần gì

Bạn là chủ một cửa hàng online, muốn có app quản lý đơn hàng nhưng mới chỉ có ý tưởng mơ hồ. Đừng vội giao việc. Hãy để OMC hỏi bạn trước:

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

Bạn thay câu trong ngoặc bằng ý tưởng của mình. OMC sẽ hỏi lần lượt để làm rõ bạn muốn gì, và theo README, mục đích là bạn biết chính xác mình cần xây gì trước khi bắt đầu viết code. Kết quả là một bản yêu cầu rõ ràng hơn để giao tiếp tiếp.

> Đừng học Claude Code, cứ mô tả việc bạn cần và để OMC lo phần chia việc.
>
> — Ông T

### Lập trình viên mới dựng nhanh một API

Bạn đã có ý tưởng rõ, muốn có bộ khung dự án. Trong phiên Claude Code, gõ:

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

Hoặc dùng cách gõ tự nhiên trong phiên: `autopilot: build a REST API for managing tasks`. OMC sẽ tự đi qua các giai đoạn của nó. Nếu muốn chọn trình tự giai đoạn, README có tính năng cấu hình đặt tên (cần Linux có `flock`), ví dụ `/autopilot --workflow plan-build-qa "..."`, với cấu hình khai báo trong `.claude/omc.jsonc` của dự án.

### Nhóm nhỏ dọn lỗi TypeScript hàng loạt

Dự án của bạn đang có hàng chục lỗi TypeScript sau khi nâng cấp thư viện. Dùng Team để chia nhau:

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

Ba agent thực thi sẽ nhận việc, sau đó đến bước kiểm tra và vòng sửa. Bạn chỉ cần xem kết quả cuối thay vì ngồi sửa từng lỗi.

### Rà soát chéo bằng nhiều mô hình

Bạn đã có sẵn Codex hoặc Antigravity và muốn có ý kiến thứ hai về một pull request. Mở tmux, rồi dùng:

```bash
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 rà soát bảo mật, dòng hai xem trạng thái, dòng ba tắt khi xong. Tên `auth-review` ở đây là tên mẫu trong README. Nếu muốn ý kiến từ hai mô hình khác nhau trong cùng phiên, dùng `/ask codex` và `/ask antigravity` rồi nhờ Claude tổng hợp.

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

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

Đây là điểm chính README cảnh báo. Hãy gõ `/plugin marketplace add ...` trước, đợi xong rồi mới gõ `/plugin install oh-my-claudecode`.

### Gõ `omc autopilot` trong terminal báo không có lệnh

Ý tưởng này rất dễ nhầm. README ghi rõ không có lệnh con `omc autopilot`, `omc ralph` hay `omc execute`. Các lệnh `/autopilot`, `/ralph`, `/execute`, `/deep-interview` là skill gõ trong phiên Claude Code. Ngược lại, `omc setup`, `omc ask`, `omc team` mới là lệnh terminal.

### Cài npm báo cảnh báo "deprecated"

Cảnh báo `deprecated prebuild-install@7.1.3` là bình thường theo README. Nó đến từ thư viện phụ thuộc bên ngoài. Cứ kiểm tra xem `omc setup` có chạy được không, nếu chạy được thì bỏ qua cảnh báo.

### `omc team` không mở được worker

Theo README, lệnh này cần một phiên tmux đang chạy, và công cụ tương ứng (`codex`, `gemini`, `agy`, `grok`, `cursor-agent`) phải được cài và đăng nhập sẵn. Hãy kiểm tra từng điều kiện này trước. Với người dùng Windows thuần, tmux thường không có sẵn. README không nói rõ về Windows, nên mình khuyên bạn xem tài liệu dự án trước khi thử.

### Dùng `/autopilot --workflow` bị từ chối

Tính năng cấu hình giai đoạn đặt tên chỉ chạy trên Linux có tiện ích `flock`. Môi trường khác sẽ bị từ chối trước khi thay đổi bất cứ trạng thái nào. Bạn vẫn dùng `/autopilot` bình thường không kèm `--workflow`.

### Có vấn đề sau khi cập nhật

Chạy lại `/omc-setup`. Nếu vẫn lỗi, README gợi ý `/omc-doctor` để xử lý bộ nhớ đệm plugin cũ.

## Có nên dùng không

**Điểm mạnh.** OMC giúp bạn giao việc bằng câu thường mà không phải học nhiều lệnh. Quy trình Team có bước kiểm tra và vòng sửa nên ít phải làm tay hơn. Nó còn kết hợp được nhiều công cụ AI khác nhau và có giấy phép MIT, hiện được nhiều người quan tâm (khoảng 40.800 sao).

**Giới hạn.** Có nhiều bề mặt dễ nhầm: lệnh terminal và lệnh trong phiên Claude Code là hai thứ khác nhau, tên dự án và tên gói npm cũng khác nhau. Một số tính năng đòi hỏi tmux, Linux hay công cụ bên thứ ba đã đăng nhập. README cũng nói các lệnh gạch chéo như `/autopilot` không dùng được trong CI vì cần phiên Claude Code đang chạy. Tác giả còn ghi chú rằng ai thấy OMC hơi nặng có thể xem dự án gajae-code, nghĩa là chính tác giả cũng thừa nhận có người thấy nó quá tay.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần sửa vài dòng hay hỏi đáp nhanh, Claude Code thường là đủ. Nếu bạn dùng Codex CLI của OpenAI, README trỏ sang dự án oh-my-codex cùng tác giả. Còn nếu bạn mới làm quen, hãy bắt đầu với `/deep-interview` và một việc nhỏ trước khi giao cả dự án.

## 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 mã nguồn dùng tự do. Tuy nhiên OMC chạy trên Claude Code và có thể gọi các công cụ khác như Codex hay Gemini, nên chi phí phụ thuộc vào gói hoặc khóa API của các dịch vụ đó. README không nêu mức phí cụ thể.

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

README khuyên dùng cách plugin: 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`. Nhớ gõ từng dòng một, không dán cả hai cùng lúc.

### Tên gói npm là gì? Sao khác tên repo?

Gói npm tên là `oh-my-claude-sisyphus`, dù dự án mang tên oh-my-claudecode. Cài bằng `npm i -g oh-my-claude-sisyphus@latest` sẽ có cả lệnh `oh-my-claudecode` và lệnh ngắn `omc`.

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

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

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

README không có phần nào nói riêng về Windows. Tính năng cấu hình giai đoạn đặt tên của autopilot được ghi rõ là cần Linux với tiện ích `flock`, và `omc team` cần tmux. Chưa có thông tin về việc các phần còn lại chạy thế nào trên Windows, bạn nên xem tài liệu của dự án.

### OMC khác gì dùng Claude Code thông thường?

Claude Code thường là một phiên làm việc đơn lẻ. OMC thêm lớp điều phối: nhiều agent chạy theo quy trình lập kế hoạch, thực thi, kiểm tra, sửa lỗi, và có thể mở worker từ các công cụ AI khác trong tmux. Bạn vẫn dùng Claude Code như cũ, OMC là phần mở rộng.

### Có dùng được trong CI hoặc tự động hoá không?

Có một phần. README bảo dùng các lệnh terminal như `omc setup` hay `omc ask` và đặt `ANTHROPIC_API_KEY` hoặc đăng nhập của công cụ tương ứng trong môi trường chạy. Các lệnh `/autopilot`, `/ralph`, `/execute`, `/team` cần phiên Claude Code đang hoạt động nên không nên dùng trong CI.
