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

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

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.

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

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

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

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

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

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

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

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

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

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

- **Claude Code**: OMC 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.js**: nế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à `flock`**: chỉ 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 API**: chạ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ành**: README 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

```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 để 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:

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

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

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

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

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

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

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

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

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