Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi các chế độ chạy nhiều agent (team, autopilot, ralph chạy tới khi kiểm tra xong, ultrawork chạy song song), 19 agent chuyên việc và 48 skill trong plugin. | README, Features |
|---|---|---|
| Ưu | Khi bạn đã có ~/.claude/CLAUDE.md riêng, setup cho chọn giữ nguyên file đó và đặt cấu hình OMC sang CLAUDE-omc.md, kèm bản sao lưu và đường lùi. | omc-setup phase 1 |
| Ưu | Gói npm 5.7.19 trỏ đúng commit mã nguồn mình đọc (gitHead e10206d), nên đọc repo là đọc đúng thứ được cài. | npm registry, 5.7.19 |
| Nhược | 30 hook chạy node ở mỗi prompt, mỗi lần gọi tool và mỗi lần dừng. Mỗi lỗi trong một hook có thể chặn hoặc làm chậm phiên làm việc. | hooks/hooks.json |
| Nhược | Một người dùng báo chạy 6 agent song song bằng OMC hay bị ngắt, còn tính năng Agent Team có sẵn của Claude Code chạy 16 agent không lỗi (issue đã đóng). | Issue #455 |
| Nhược | Cập nhật nhiều lần gặp lỗi: xóa cache rồi khởi động lại vẫn tải bản cũ (#411), cài cả plugin lẫn npm thì mỗi lệnh hiện hai lần (#2252). Cả hai đã đóng. | Issue #2252, #411 |
| Nhược | HUD đọc token đăng nhập Claude Code của bạn để hỏi mức dùng từ api.anthropic.com; từng bị trả lỗi 429 vì hỏi quá dày (issue đã đóng). | Issue #1414 |
| Chưa rõ | README ghi định tuyến model "tiết kiệm 30–50% token" nhưng không kèm cách đo hay số liệu. | README, Why oh-my-claudecode? |
| Chưa rõ | Tháng 4/2026 có issue phản ánh dự án đòi star repo mới xử lý issue, trái quy định của GitHub; issue đã đóng. Ở commit mình đọc, bước setup chỉ hỏi bạn có muốn star không. Chưa rõ quy định xử lý issue hiện nay ra sao. | Issue #2235 |
| Chưa rõ | Cách cài qua plugin marketplace tự cập nhật và không ghim được bản 5.7.19; chỉ cách cài npm ghim được phiên bản. | README, Updating |
Khi nên dùng
- Bạn dùng Claude Code hằng ngày, chấp nhận nhiều hook chạy nền, và muốn chia một việc lớn cho nhiều agent chạy song song.
Khi không nên dùng
- Bạn muốn giữ Claude Code gọn, không muốn plugin ghi vào ~/.claude/CLAUDE.md và settings.json, hoặc chỉ cần một vài skill lẻ.
Cách cài
Claude Code (plugin)
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode → /plugin install oh-my-claudecode → /omc-setupClaude Code (npm CLI)
npm i -g [email protected] → omc setupNó chạm vào những gì
- File đọc và ghi
- omc setup ghi ~/.claude/CLAUDE.md (hoặc .claude/CLAUDE.md của dự án); khi file đã có, nó hỏi và gắn nhãn Recommended cho lựa chọn ghi đè, lựa chọn còn lại ghi sang CLAUDE-omc.md và có bản sao lưu. Ghi ~/.claude/settings.json (statusLine, hook) và ~/.claude/hud/omc-hud.mjs. Trạng thái, kế hoạch, log, bản ghi phiên nằm trong .omc/ của dự án, hoặc ~/.omc/ khi ngoài git. HUD đọc token OAuth của Claude Code (~/.claude/.credentials.json hoặc Keychain trên macOS) và có thể ghi lại token mới sau khi làm mới.
- Gọi mạng
- registry.npmjs.org để kiểm tra bản mới (lúc mở phiên, lưu đệm 24 giờ); api.github.com và raw.githubusercontent.com cho tự cập nhật; api.anthropic.com/api/oauth/usage cho HUD; Telegram, Discord, Slack chỉ khi bạn bật thông báo; api.kimi.com, z.ai, minimax.io chỉ khi ANTHROPIC_BASE_URL trỏ tới đó. Bước setup hỏi bạn có muốn star repo không và gọi gh api nếu bạn đồng ý.
- Script lúc cài
- postinstall của gói npm chạy scripts/postinstall-contained-fs.mjs: chỉ build một native addon trên macOS, các hệ khác thoát ngay. Plugin đăng ký 30 hook (UserPromptSubmit, SessionStart, PreToolUse, PostToolUse, Stop, SessionEnd…), mỗi hook chạy một script node.
- Tiến trình
- Một MCP server cục bộ (bridge/mcp-server.cjs) chạy suốt phiên. Chế độ team mở nhiều phiên Claude Code, Codex hoặc Gemini trong tmux (psmux trên Windows).
Đọc từ: hooks.json, .mcp.json, postinstall-contained-fs.mjs, session-start.mjs, usage-api.ts, auto-update.ts, 01-install-claude-md.md, 04-welcome.md
Plugin này chạy 30 hook và một MCP server trên máy bạn, với quyền của bạn, ở gần như mọi bước của Claude Code. Đọc hooks/hooks.json và scripts/ trước khi cài.
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin