Vấn đề nó giải quyết

Claude Code chạy đơn agent gặp giới hạn với tasks phức tạp. Bạn có một feature fullstack chạm vào 15 files. Claude Code làm tuần tự: file 1… file 5… đến file 8 thì nó quên mất decisions từ file 1. Bạn giải thích lại. Nó hiểu. File 11 — quên tiếp.

Bạn trở thành người trông trẻ: tự chia tasks, mở nhiều terminal sessions, merge outputs, bắt conflicts. BẠN là orchestrator, và nó mệt kinh khủng.

OMC bổ sung layer còn thiếu. Nó phân tích task của bạn, delegate cho agents chuyên biệt (architect, executor, reviewer, designer), chạy song song hoặc tuần tự, và phối hợp kết quả. Bạn chuyển từ “developer trông AI” sang “tech lead điều phối team AI.”

Cách cài đặt

Yêu cầu: Claude Code CLI đã cài, Claude Max/Pro subscription hoặc Anthropic API key, tmux (cho Team mode và rate-limit detection).

Bước 1 — Cài qua plugin marketplace:

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

Bước 2 — Chạy setup:

/omc-setup

Cập nhật sau này:

/plugin marketplace update omc
/omc-setup

Lưu ý: npm package tên là oh-my-claude-sisyphus (khác với tên project). Nếu cần CLI tools global: npm i -g oh-my-claude-sisyphus@latest.

Kiểm tra hoạt động: gõ /oh-my-claudecode: để thấy các slash commands của OMC. HUD statusline ở cuối terminal xác nhận mode đang chạy và số agents.

Các execution modes — framework quyết định

Đây là core của OMC. Đừng nghĩ chúng là “features” — hãy coi là công cụ đúng cho từng loại công việc.

Autopilot — Tự động hoàn toàn, tuần tự

Dùng cho tasks rõ ràng, scope xác định. Autopilot tự xử lý planning, execution, testing, và validation.

autopilot: Build trang login theo auth patterns có sẵn

Khi KHÔNG nên dùng: Features nhiều files cần tốc độ (quá tuần tự), hoặc requirements mơ hồ (sẽ chạy vòng vòng).

Team — Pipeline nhiều giai đoạn có verification

Orchestrator multi-agent chính thức từ v4.1.7. Chạy pipeline có cấu trúc: plan → PRD → execute → verify → fix loop. Agents chuyên biệt được route theo từng giai đoạn.

/team 3:executor "Build dashboard feature — API, components, và tests"

Khi KHÔNG nên dùng: Tasks đơn giản mà overhead của staged pipeline không đáng.

Ultrapilot — Song song, tới 5 workers

Autopilot song song với file ownership partitioning. Mỗi worker nhận files không overlap để tránh conflict.

ultrapilot: Build toolkit feature — schema, overview page, detail page, seed content

Khi KHÔNG nên dùng: Tasks có dependencies chặt giữa các files (agents sẽ đạp lên nhau).

Ralph — Kiên trì cho đến khi verified

Ralph không dừng cho đến khi Architect agent xác nhận hoàn thành. Bao gồm ultrawork cho parallelism. Tên lấy từ Sisyphus — “the boulder never stops.”

ralph: Refactor auth middleware — all tests pass, zero type errors

Khi KHÔNG nên dùng: Scope mơ hồ, không có done criteria rõ. Ralph sẽ loop vô tận cải thiện những thứ không cần cải thiện.

Pipeline — Chuỗi tuần tự, output truyền tiếp

Output của mỗi stage trở thành input cho stage tiếp theo. Có sẵn presets cho workflows phổ biến.

pipeline: explore → architect → executor → qa-tester

Khi KHÔNG nên dùng: Khi các stages không tách biệt rõ ràng hoặc cần parallelism.

Ecomode — Song song tối ưu chi phí

Route tasks về model rẻ nhất có khả năng xử lý: lookups đơn giản → Haiku, công việc chuẩn → Sonnet, reasoning phức tạp → Opus.

eco: Viết docs cho 10 functions này

Khi KHÔNG nên dùng: Khi chất lượng quan trọng hơn chi phí.

Bảng tra nhanh magic keywords

Execution modes

KeywordChức năngDùng khi
autopilotTự động hoàn toàn, single threadTask rõ ràng, scope xác định
ralphKiên trì đến khi verifiedPhải đúng, có done criteria rõ
ulwParallelism tối đa (ultrawork)Tốc độ quan trọng nhất
ecoParallelism tiết kiệm tokensBatch work độ phức tạp khác nhau
/team N:roleN agents phối hợpFeatures phức tạp nhiều giai đoạn
pipelineChuỗi agents tuần tựWorkflows nhiều bước
planInterview lập kế hoạchRequirements chưa rõ
ralplanPlanning consensus (Planner + Architect + Critic)Quyết định kiến trúc quan trọng

Utility commands

CommandChức năngDùng khi
/omc-setupSetup wizard — cấu hình preferencesCài lần đầu hoặc cần cấu hình lại
/omc-doctorChẩn đoán và sửa lỗi OMCCó gì đó không hoạt động
/cancelDừng mode đang chạyXong việc, hoặc cần dừng gấp
/noteLưu thông tin vào notepad (survive compaction)Context quan trọng cần giữ lại
/learnerTrích xuất skill tái sử dụng từ session hiện tạiBạn giải quyết được gì đáng lưu lại
/deepinitTạo AGENTS.md phân cấp cho codebaseOnboarding repo mới với OMC
/hudCấu hình HUD statuslineTùy chỉnh thanh trạng thái
/traceXem timeline và tóm tắt agent flowTìm hiểu agents đã làm gì và tại sao

Agent shortcuts

CommandChức năngDùng khi
/analyzePhân tích sâu (debugger agent)“Tại sao cái này lỗi?”
/build-fixSửa lỗi build và type errorstsc hoặc build bị hỏng
/code-reviewReview code toàn diệnTrước khi merge PR
/security-reviewQuét lỗ hổng bảo mậtĐụng vào auth, payments, user data
/tddQuy trình test-driven developmentViết tests trước, rồi mới implement

Chỉ cần dùng các keywords này tự nhiên trong prompt — OMC tự nhận diện và kích hoạt mode phù hợp.

Cách sử dụng — ví dụ thực tế

Dưới đây là các workflows thực tế từ trải nghiệm hàng ngày. Mỗi ví dụ cho thấy prompt chính xác và OMC xử lý nó như thế nào.

Ví dụ 1: Build feature từ đầu

autopilot: Thêm form đăng ký newsletter vào landing page.
Dùng ConvertKit API, validate email phía client, hiển thị success toast.

OMC kích hoạt autopilot: analyst phân tích requirements → architect thiết kế component → executor implement form, API call, và toast → verifier xác nhận hoạt động. Bạn nhận feature hoàn chỉnh mà không cần quản lý từng bước.

Ví dụ 2: Sửa nhiều bugs song song

/team 3:executor "Sửa 3 bugs này:
1. Dark mode toggle không lưu khi reload trang
2. Mobile nav menu không đóng khi click link
3. Search results hiển thị draft posts"

OMC tạo 3 executor agents, mỗi agent nhận một bug, làm độc lập, kết quả được verify. Ba bugs sửa xong trong thời gian sửa một.

Ví dụ 3: Refactor đảm bảo chất lượng

ralph: Migrate tất cả API routes từ Express sang Hono.
Done criteria: all tests pass, zero type errors, không còn Express imports.

Ralph tiếp tục iterate — migrate routes, sửa type errors, chạy tests — cho đến khi architect verify cả ba criteria đều đạt. Không có migration dở dang.

Ví dụ 4: Lên kế hoạch trước khi code

plan: Cần thêm multi-tenancy cho app.
Mỗi tenant có data riêng, custom subdomain, và billing riêng.

OMC bắt đầu planning interview: hỏi về database strategy (shared vs separate), auth flow, billing integration. Tạo plan document trước khi viết code. Sau đó bạn chạy autopilot hoặc ralph trên plan đó.

Ví dụ 5: Review code về chất lượng và bảo mật

/code-review
/security-review

Chạy cả hai trên changes hiện tại. Code review kiểm tra logic defects, anti-patterns, naming. Security review quét OWASP top 10, secrets bị lộ, auth bypasses. Cả hai cho ra findings với severity ratings cụ thể.

Mẹo từ người dùng hàng ngày

Mẹo 1: CLAUDE.md là bộ khuếch đại. Multi-agent mà không có shared context = hỗn loạn. CLAUDE.md trở thành “team agreement” mà tất cả agents tuân theo. Thiếu nó, hai agents sẽ đặt tên khác nhau, dùng patterns khác nhau, mâu thuẫn nhau. Viết CLAUDE.md trước khi chạy multi-agent.

Mẹo 2: Plan trước khi làm features phức tạp. Dành 5 phút trong planning interview tiết kiệm 30 phút rework. Dùng plan trước bất kỳ feature nào chạm 5+ files. Consensus của planner + architect + critic cho ra implementation plan chắc chắn.

Mẹo 3: Ralph cần đích đến. Luôn cho ralph done criteria rõ: “All tests pass”, “No TypeScript errors”, “Lint clean.” Thiếu criteria, ralph sẽ loop vô tận đánh bóng những thứ đã tốt rồi.

Mẹo 4: Bắt đầu với autopilot, nâng lên team. Học cách OMC suy nghĩ với autopilot (dễ đoán, tuần tự) trước khi chạy song song. Debug 5 agents song song rất khó nếu chưa hiểu 1 agent làm gì.

Mẹo 5: Ecomode cho content tasks. Viết docs, tạo test data, tạo markdown files — không cần Opus. Ecomode route chúng về Haiku/Sonnet, tiết kiệm đáng kể tokens.

Khi KHÔNG nên dùng OMC

  • Tasks nhỏ (1-2 files): Claude Code vanilla nhanh hơn. Overhead OMC > lợi ích.
  • Code liên quan bảo mật: Multi-agent = ít control hơn trên mỗi agent. Review thủ công code nhạy cảm.
  • Repos không có CLAUDE.md: Agents không có shared context. Setup CLAUDE.md trước.
  • Ralph + scope mơ hồ: Ralph loop mãi. Định nghĩa done criteria hoặc đừng dùng ralph.
  • Budget tokens eo hẹp + ultrapilot: Agents song song nhân tokens. Dùng ecomode thay thế.

Tools liên quan