# 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 OMC) là plugin và công cụ dòng lệnh thêm khả năng điều phối nhiều agent vào Claude Code, có giấy phép MIT. Bạn dùng nó để giao việc lớn cho một nhóm agent làm song song thay vì chat từng bước. Cài bằng hai lệnh plugin hoặc một lệnh npm, rồi chạy bước setup; người đã quen Claude Code sẽ làm được trong vài phút.

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

oh-my-claudecode (gọi tắt là OMC) là một plugin cho Claude Code, giúp bạn điều phối nhiều agent AI làm việc cùng lúc trên một nhiệm vụ. Tác giả mô tả nó là công cụ điều phối đa agent "theo nhóm" (teams-first), với khẩu hiệu "không cần học Claude Code, cứ dùng OMC". Repo hiện có khoảng 40802 sao và 3645 fork, viết chủ yếu bằng TypeScript, giấy phép MIT.

Vấn đề nó giải quyết khá đời thường. Dùng Claude Code thuần, bạn phải tự chia việc, tự nhắc từng bước, tự kiểm tra kết quả. OMC gói sẵn các quy trình đó thành lệnh ngắn. Bạn gõ một dòng mô tả việc cần làm, còn lập kế hoạch, giao việc, chạy song song và kiểm tra thì plugin lo.

Ai nên dùng? Lập trình viên mới và người làm sản phẩm đã có Claude Code, muốn dựng thử ứng dụng hay sửa lỗi hàng loạt mà không phải tự thiết kế quy trình. Điểm đáng giá nhất là lệnh `/autopilot` để giao cả việc, và `/team` để chạy nhiều agent cùng lúc. Nếu bạn còn mơ hồ về yêu cầu, có thêm `/deep-interview` để được hỏi lại trước khi viết code.

```repo
- repo | Yeachan-Heo/oh-my-claudecode
- kind | Plugin
- desc | oh-my-claudecode (OMC) là plugin giúp Claude Code chạy nhiều agent phối hợp theo nhóm, có sẵn lệnh như /autopilot, /team, /deep-interview.
- stars | 41k
- lang | TypeScript
- license | MIT
```

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

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

### Autopilot: giao một câu, nhận cả quy trình

Lệnh `/autopilot` nhận một mô tả bằng ngôn ngữ tự nhiên, ví dụ "xây một REST API quản lý công việc". Bạn không cần nhớ cú pháp phức tạp. Trong phiên làm việc, bạn cũng có thể gõ kiểu `autopilot: ...` như một lối tắt.

Ngoài ra có thể chọn "hồ sơ giai đoạn" (stage profile) bằng `--workflow <tên>`. Hồ sơ cho phép bạn chọn trình tự các giai đoạn như lập kế hoạch, thực thi, kiểm thử. README ghi rõ hồ sơ này hiện yêu cầu Linux có tiện ích `flock`. Bạn không dùng `--workflow` thì autopilot cũ vẫn chạy bình thường.

### Team: nhiều agent chạy song song

README gọi Team là cách điều phối chính được khuyên dùng. Lệnh `/team 3:executor "fix all TypeScript errors"` chạy một nhóm làm việc ngay trong phiên Claude Code. Quy trình chạy theo chuỗi: lập kế hoạch, viết PRD, thực thi, kiểm tra, sửa lỗi (lặp lại nếu cần). Lợi ích thực tế là việc lớn được chia nhỏ và có bước kiểm tra, thay vì một agent làm từ đầu đến cuối.

### Chạy worker bằng các CLI khác qua tmux

Lệnh `omc team` mở các ô tmux và mỗi ô chạy một CLI AI khác nhau: Codex, Gemini, Antigravity, Grok, Cursor hoặc Claude. README gợi ý Codex hợp với review code và phân tích bảo mật, Antigravity hợp với thiết kế giao diện và tài liệu. Worker sinh ra khi cần và tắt khi xong việc, nên không chiếm tài nguyên lúc rảnh.

### Hỏi ý kiến nhiều "cố vấn" AI

Lệnh `/ask` (trong phiên) hoặc `omc ask` (từ terminal) gửi câu hỏi cho một nhà cung cấp như claude, codex, gemini, antigravity, grok, cursor, muse. Bạn có thể hỏi hai bên rồi để Claude tổng hợp, ví dụ một bên xem kiến trúc, một bên xem giao diện.

### Deep interview: làm rõ yêu cầu trước khi code

Lệnh `/deep-interview` hỏi bạn theo kiểu đặt câu hỏi dần, để lộ ra những giả định ngầm và đo mức độ rõ ràng của yêu cầu. Hợp với người có ý tưởng mơ hồ, chưa biết mình cần gì.

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

Lệnh `omc lookout scan` đọc bản mô tả nhiệm vụ 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 để agent tự chạy. README nói rõ đây chỉ là cảnh báo tham khảo.

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

Theo tư liệu:

- **Claude Code**: OMC là plugin của Claude Code, nên bạn cần có Claude Code và dùng được nó.
- **Node.js**: package.json yêu cầu Node 20, 22, 23, 24, 25 hoặc 26 (nếu cài bằng npm).
- **tmux và CLI phụ**: chỉ cần khi dùng `omc team` với Codex, Gemini, Antigravity, Grok hay Cursor. README yêu cầu CLI đó đã cài, đã đăng nhập, và bạn đang trong một phiên tmux.
- **Linux có flock**: chỉ cần nếu muốn dùng `/autopilot --workflow`.
- **Khoá API**: nếu chạy tự động trên máy chủ (CI), README nói đặt `ANTHROPIC_API_KEY` hoặc đăng nhập CLI theo nhà cung cấp trong môi trường chạy.

README phần được cung cấp chưa nêu rõ yêu cầu hệ điều hành chung, phần cứng hay GPU. Bạn xem thêm tài liệu trong repo nếu cần.

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

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

### Cách 1: Cài qua plugin (README khuyên cho đa số người dùng)

Mở Claude Code, rồi gõ hai lệnh dưới đây. Đây là lệnh gạch chéo của Claude Code, không phải lệnh terminal thường. README nhắc phải nhập **từng lệnh 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
```

Xong lệnh đầu thì gõ tiếp:

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

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

Nếu bạn muốn có lệnh `omc` ngay ở terminal, dùng lệnh sau. Cần có Node.js trước. Tên gói là `oh-my-claude-sisyphus`, khác với tên dự án. Gói này cài cả lệnh `oh-my-claudecode` lẫn bản rút gọn `omc`.

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

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 phụ thuộc bên thứ ba (better-sqlite3) và không có nghĩa là cài lỗi.

### Chạy setup

Sau khi cài, bạn cần chạy bước thiết lập. Có hai lối vào:

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

# From your terminal
omc setup
```

Dòng đầu gõ trong phiên Claude Code, dòng sau gõ ở terminal. Nếu bạn chạy Claude Code với `--plugin-dir`, README yêu cầu thêm `--plugin-dir-mode` cho `omc setup` (hoặc đặt biến `OMC_PLUGIN_ROOT` trước), để trình cài không nhân đôi skill và agent. Chi tiết nằm ở mục Plugin directory flags trong REFERENCE.md của repo.

### 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 đoạn sau. Nếu file đã có nội dung, hãy gộp vào cho đúng cú pháp JSON, đừng dán đè.

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

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

### Cài từ bản tải về (tuỳ chọn)

Nếu bạn muốn xem mã nguồn, có thể tải repo về. README đoạn được cung cấp chưa ghi lệnh build từ mã nguồn, bạn xem CONTRIBUTING.md trong repo.

```bash
git clone https://github.com/Yeachan-Heo/oh-my-claudecode.git
cd oh-my-claudecode
```

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

README không mô tả một màn hình "cài thành công" cố định. Bạn có thể tự kiểm tra theo các cách sau:

1. **Thử lệnh terminal** (nếu cài bằng npm): gõ `omc setup` và xem có chạy được không. Nếu terminal báo không tìm thấy lệnh `omc`, nghĩa là gói chưa cài đúng hoặc terminal chưa nhận lại đường dẫn.
2. **Thử trong Claude Code**: gõ `/omc-setup`. Nếu lệnh được nhận diện thì plugin đã vào.
3. **Chạy thử một việc nhỏ**:

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

Nếu có sự cố sau khi cập nhật, README gợi ý chạy:

```bash
/omc-doctor
```

Lệnh này dùng để xử lý khi gặp vấn đề, theo README là để dọn plugin cache cũ.

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

Phần dưới là các tình huống mình dựng từ khả năng có trong README. Đây là ví dụ minh hoạ, kết quả cụ thể phụ thuộc dự án của bạn.

### Dựng thử một ứng dụng nhỏ từ ý tưởng

Bạn là chủ shop, muốn có một công cụ nhỏ quản lý đơn hàng nhưng chưa rành lập trình. Mở Claude Code trong một thư mục trống rồi giao việc:

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

Bạn thay phần trong ngoặc bằng mô tả của mình (README ví dụ bằng tiếng Anh). Autopilot sẽ đi qua các giai đoạn lập kế hoạch và thực thi. Kết quả là một khung dự án để bạn xem lại và chỉnh tiếp.

> Đừng cố học thuộc mọi lệnh. Mô tả việc cần làm cho rõ, phần còn lại để công cụ chia việc.
>
> — Ông T

### Làm rõ ý tưởng còn mơ hồ trước khi bắt tay vào

Bạn là nhân viên văn phòng được giao "làm cái app quản lý công việc cho nhóm" nhưng chưa rõ cần gì. Thay vì viết bừa, hãy chạy:

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

Công cụ hỏi bạn lần lượt để lộ các giả định và đo mức độ rõ ràng của yêu cầu. Kết quả là bạn có bức tranh rõ hơn về thứ cần xây, trước khi giao cho autopilot.

### Sửa lỗi TypeScript hàng loạt bằng một nhóm agent

Bạn là lập trình viên, dự án đang có hàng chục lỗi biên dịch TypeScript. Trong phiên Claude Code (đã bật Team):

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

Ba agent thực thi làm song song, sau đó có bước kiểm tra và sửa lại theo quy trình Team. Bạn nhận về một loạt thay đổi để tự rà soát trước khi chấp nhận.

### Nhờ model khác review code

Bạn đã có Codex CLI và đã đăng nhập, đang ở trong một phiên tmux. Muốn có ý kiến thứ hai về phần đăng nhập của dự án:

```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ở hai ô Codex để review, dòng hai xem trạng thái, dòng ba tắt nhóm. Tên `auth-review` là tên nhóm ví dụ trong README. Nếu chỉ muốn hỏi nhanh thay vì chạy cả nhóm, dùng `omc ask codex "review this patch"`.

```note
Trước khi để agent chạy một mình trong thời gian dài, bạn có thể thử omc lookout scan --brief "..." để quét cảnh báo. README chỉ nói đây là công cụ khuyến nghị, không thay thế việc bạn tự kiểm tra. Nhiều agent chạy song song cũng có thể dùng nhiều lượt Claude hơn; README phần được cung cấp chưa nói về chi phí, nên bạn hãy theo dõi mức dùng của tài khoản. Đừng đưa khoá API vào mô tả nhiệm vụ.
```

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

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

Đây là chỗ README nhắc riêng. Hai lệnh `/plugin marketplace add ...` và `/plugin install ...` phải gõ từng lệnh một, đợi lệnh đầu xong rồi mới gõ lệnh sau.

### Thấy cảnh báo deprecated khi chạy npm

Cảnh báo `deprecated prebuild-install@7.1.3` đến từ phụ thuộc của bên thứ ba. README nói nó không tự nó có nghĩa là cài thất bại. Nếu lệnh `omc` chạy được thì bạn cứ bỏ qua.

### /team báo bị tắt hoặc không chạy theo nhóm

Bạn chưa bật tính năng team thử nghiệm của Claude Code. Thêm biến `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` giá trị `1` vào phần `env` của `~/.claude/settings.json` như ở trên, rồi mở lại Claude Code.

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

Nguyên nhân hay gặp: chưa có phiên tmux, hoặc CLI được chọn (codex, gemini, agy, grok, cursor-agent) chưa cài hay chưa đăng nhập. Kiểm tra từng thứ, rồi chạy lại. Lưu ý `omc team` (mở ô tmux) khác với `/team` (chạy trong phiên Claude Code).

### --workflow bị từ chối

Hồ sơ giai đoạn đặt tên chỉ chạy trên Linux có `flock`. README ghi môi trường không hỗ trợ sẽ từ chối lệnh trước khi thay đổi trạng thái, và autopilot kiểu cũ vẫn dùng được. Nếu bạn không ở Linux, chạy `/autopilot` không kèm `--workflow`.

### Dùng lệnh gạch chéo trong CI

README nói rõ đừng dựa vào `/autopilot`, `/ralph`, `/execute`, `/team` trong CI, vì chúng cần một phiên Claude Code đang chạy. Trong CI hãy dùng lệnh terminal như `omc setup`, `omc ask`.

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

**Điểm mạnh**: cài nhanh (hai lệnh plugin hoặc một lệnh npm), lệnh ngắn bằng ngôn ngữ tự nhiên, có quy trình Team lập kế hoạch rồi kiểm tra, và kết nối được nhiều CLI AI khác trong cùng một công cụ. Repo còn được cập nhật trong vài tháng gần đây, giấy phép MIT.

**Giới hạn**: bạn vẫn cần có Claude Code. Phần dùng worker ngoài (Codex, Gemini, Cursor...) đòi hỏi tmux và các CLI đó đã cài, đã đăng nhập. Hồ sơ `--workflow` chỉ chạy trên Linux có `flock`. Autopilot, Ralph, Execute và Deep Interview là kỹ năng trong phiên, không có lệnh `omc autopilot` ở terminal. Ngoài ra 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 bạn chỉ cần hỏi đáp và sửa vài file nhỏ thì Claude Code thuần là đủ, không cần thêm lớp điều phối. Nếu bạn dùng OpenAI Codex CLI, tác giả có repo riêng tên oh-my-codex. Nếu thấy OMC hơi nặng so với nhu cầu, README đầu trang cũng giới thiệu một repo nhẹ hơn tên gajae-code. Hãy thử trên một dự án nhỏ trước, đọc kỹ những gì agent thay đổi, rồi mới dùng cho việc quan trọ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, mã nguồn mở. Tuy nhiên nó chạy trên Claude Code và có thể gọi thêm các CLI khác như Codex hay Cursor, nên chi phí của các dịch vụ đó vẫn theo tài khoản của bạn. README phần được cung cấp chưa nêu rõ về giá.

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

Trong Claude Code, gõ `/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode`, rồi gõ `/plugin install oh-my-claudecode`, từng lệnh một. Sau đó chạy `/omc-setup`. Nếu thích terminal, dùng `npm i -g oh-my-claude-sisyphus@latest` rồi `omc setup`.

### Tên gói npm sao lại là oh-my-claude-sisyphus?

Dự án mang tên oh-my-claudecode ở repo, plugin và lệnh, nhưng gói npm được đăng với tên oh-my-claude-sisyphus. README nói gói này cài cả lệnh `oh-my-claudecode` và lệnh rút gọn `omc`.

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

package.json yêu cầu Node 20, 22, 23, 24, 25 hoặc 26. Bạn chỉ cần Node nếu cài theo cách npm.

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

Tư liệu chưa có thông tin rõ về hệ điều hành nói chung. Chỉ biết hồ sơ `/autopilot --workflow` yêu cầu Linux có `flock`, và `omc team` cần tmux. Bạn nên xem tài liệu trong repo hoặc thử trên một thư mục nhỏ trước.

### 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. OMC điều phối các agent AI và CLI, chứ không tự chạy mô hình trên máy bạn theo những gì README nêu.

### OMC khác gì dùng Claude Code thuần?

Claude Code thuần là bạn tự nhắc từng bước. OMC thêm các quy trình sẵn có như autopilot, team, deep-interview để chia việc cho nhiều agent và có bước kiểm tra. Nếu việc nhỏ, bạn có thể không cần đến nó.
