# 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 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.

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

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.

```repo
- repo | Yeachan-Heo/oh-my-claudecode
- kind | Plugin
- desc | 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.
- stars | 41k
- lang | TypeScript
- license | MIT
```

## 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.

## 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.json` yê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`, `grok` hoặc `cursor-agent`, đã cài và đăng nhập) nếu bạn muốn dùng `omc team` với worker bên ngoài.
- **Linux có tiện ích `flock`** nế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_KEY` hoặ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.

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

```steps
- Cài plugin | Thêm marketplace rồi cài plugin trong Claude Code
- (Tuỳ chọn) Cài bằng npm | Cài lệnh omc trên terminal
- Chạy setup | Cấ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ỏ
```

### 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:

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

Sau khi xong, gõ tiếp lệnh thứ hai để cài:

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

Chỗ 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.

### 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:

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

Sau 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.

### Chạy setup

Bước này cấu hình OMC. Có hai cách, tuỳ bạn đang ở đâu:

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

# From your terminal
omc setup
```

Nế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.

### 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`:

```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ể.

```note
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.
```

## 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õ:

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

README cũng cho phép gõ kiểu câu thường trong phiên:

```bash
autopilot: build a REST API for managing tasks
```

Nế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).

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

### 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:

```bash
/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

### 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.

### 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:

```bash
/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.

### 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:

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

Lệ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.

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

### 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.

### 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ả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.

### 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:

```bash
/omc-doctor
```

README 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`.

### `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.

## 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ể đã đủ.
