OMC(oh-my-claudecode) - Claude Code를 자연어로 다루는 다중 에이전트 플러그인

Claude Code 플러그인 큐레이션 시리즈 · 1편 OMC

이 글에서 다루는 내용

OMC(oh-my-claudecode)는 Claude Code 위에 얹는 다중 에이전트 조율 플러그인입니다. 슬래시 명령을 새로 외우는 대신 자연어 한 줄로 기획·설계·구현·검토 단계를 병렬 실행하도록 도와줍니다. 이 글은 OMC의 정체와 동작 방식, 마켓플레이스·npm 두 가지 설치 경로, 핵심 명령어(/autopilot·/team·/trace·/ultrawork 등), 29개 에이전트 카테고리, Telegram·Discord 알림 연동, 비용 주의 사항까지 한 번에 정리합니다. 라이선스는 MIT 오픈소스이고 기준 시점은 2026년 4월입니다.

---

1. OMC가 정확히 무엇인가

OMC의 공식 슬로건이 정체를 잘 요약합니다.

"Multi-agent orchestration for Claude Code. Zero learning curve."
"Don't learn Claude Code. Just use OMC."

핵심 포인트 두 가지입니다. 첫째, OMC는 별도 도구가 아니라 Claude Code의 플러그인입니다. Claude Code의 에이전트 하네스 위에 한 겹의 조율층을 더 얹어, 사용자가 "이거 만들어 줘" 한 줄을 던지면 OMC가 그 작업을 작은 단위로 쪼개 여러 에이전트에 나눠 맡기고 결과를 모아 줍니다.

둘째, 사용자는 슬래시 명령을 새로 외우지 않아도 됩니다. /autopilot "todo 앱 만들어 줘" 한 줄이면 분석·설계·구현·테스트가 자동으로 흘러갑니다. Claude Code 자체의 학습 곡선을 한 단계 낮추는 것이 OMC가 노리는 자리입니다.

---

2. 설치 - 두 가지 경로

설치 경로는 두 가지가 있습니다. 마켓플레이스 방식이 가장 권장되고, npm 방식은 CLI 도구를 따로 쓰고 싶을 때 보조로 사용합니다.

2-1. 마켓플레이스 방식 (권장)

Claude Code 세션 안에서 다음 두 명령을 차례로 실행합니다.

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

첫 명령은 OMC 저장소를 마켓플레이스 소스로 등록하고, 두 번째 명령이 실제 플러그인을 끌어와 설치합니다. /plugin marketplace update omc 명령으로 이후 업데이트를 받을 수 있습니다.

2-2. npm 방식 (선택)

터미널에서 OMC CLI 도구도 같이 쓰고 싶다면 npm으로 설치할 수 있습니다.

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

⚠️ 마켓플레이스 + npm을 둘 다 설치하면 스킬과 에이전트가 중복 등록될 수 있습니다. 한쪽만 쓰는 게 가장 안전하고, 둘 다 필요하면 설치 후 /omc-doctor로 점검합니다.

2-3. 초기 셋업

설치가 끝났다면 Claude Code 세션 안에서 셋업 명령을 한 번 돌립니다.

/omc-setup

셋업이 진행되면서 OMC가 사용할 디렉터리(.omc/skills/)와 기본 설정 파일들이 만들어집니다. 이후 학습된 패턴(스킬)이 자동으로 이 폴더에 누적되어 다음 세션의 컨텍스트로 자동 주입됩니다.

---

3. 가장 먼저 써 볼 명령 - /autopilot

OMC의 간판 기능입니다. 자연어 한 줄을 받아 분석 → 설계 → 구현 → 테스트의 전 흐름을 자동으로 돌립니다.

/autopilot "투두 앱 만들어 줘"
/autopilot "할 일 관리용 REST API 만들어 줘. FastAPI로 작성하고 SQLite 사용."
/autopilot "이 저장소의 인증 모듈 보안 취약점 점검해 줘"

실행 시 OMC는 작업을 작은 단계로 쪼개 적합한 에이전트에 분배합니다. 분석에는 explorer, 설계엔 architect, 구현엔 executor, 검증엔 qa-tester가 들어가는 식입니다. 사용자는 결과만 받습니다.

💡 처음에 가장 익숙해져야 할 한 줄이 바로 이 /autopilot "..."입니다. 다른 명령은 이 한 명령에서 더 좁히거나 더 넓히는 변형이라고 보면 됩니다.

---

4. 핵심 명령어 묶음

OMC가 제공하는 슬래시 명령은 27개 이상이지만, 실제로 자주 쓰는 건 다음 묶음입니다.

명령	역할	언제 쓰는가
/autopilot	기획부터 검증까지 자동 실행	한 번에 끝내고 싶은 작업
/team	여러 에이전트가 협업하도록 명시	설계와 구현을 따로 맡길 때
/trace	증거 기반 추적 (병렬 tracer)	버그·장애 원인 분석
/deep-dive	2단계 trace + 질문 기반 발굴	코드베이스 깊이 탐색
/ultrawork	최대 병렬 처리 모드	큰 기능 한 번에 끝내고 싶을 때
/ralph	완료 검증 반복 루프	테스트 통과까지 반복 시도
/skill, /learner	재사용 스킬 추출·관리	반복 패턴을 자산화
/wiki	세션 간 누적되는 영구 지식 베이스	결정 기록·맥락 보존
/configure-notifications	Telegram·Discord·Slack 연동	긴 작업의 완료 알림
/hud	상태 라인에 진행 정보 표시	병렬 작업 모니터링
/omc-doctor	설치·설정 진단 및 수정	동작이 이상할 때

---

5. 에이전트 카테고리 - 누가 어떤 일을 맡는가

OMC의 강점은 단순히 명령이 많아서가 아니라 각 작업을 가장 적합한 모델·역할에 자동 분배한다는 점에 있습니다. 공식 REFERENCE 기준 약 29개 에이전트가 등록되어 있고, 같은 역할도 모델 계층(Haiku/Sonnet/Opus)에 따라 별도 에이전트로 갈라집니다.

역할군	대표 에이전트	담당
탐색·실행	explore / executor / architect (각 low~high 계층)	코드베이스 탐색, 구현, 구조 설계
기획·창작	planner, designer, writer, vision	기획 문서, UI 설계, 글, 시각 자료
분석·검토	critic, analyst, code-reviewer	결과 비평, 데이터 분석, 코드 리뷰
품질 보증	qa-tester, tracer, security-reviewer, debugger, test-engineer	테스트, 추적, 보안 점검, 디버깅
기타 전문	git-master, scientist	버전 관리, 실험·분석

예를 들어 explore는 빠른 검색이라 Haiku 계층, planner·code-reviewer처럼 깊은 사고가 필요한 역할은 Opus 계층으로 자동 매핑됩니다. 사용자가 모델을 일일이 지정할 필요가 없습니다.

---

6. 활용 시나리오 세 가지

6-1. 새 기능 한 사이클 - autopilot

요구사항만 있고 코드가 없는 상태에서 가장 빠르게 굴러갑니다. 분석·설계·구현·테스트가 한 번에 흘러가므로 사이드 프로젝트나 사내 도구 신규 기능에 적합합니다.

/autopilot "팀 일정 공유용 캘린더 뷰 추가. 기존 React 프로젝트에 컴포넌트로 끼워 넣고 주/월 전환 토글, 이벤트 클릭 시 모달 열림, 단위 테스트 포함."

6-2. 장애 원인 추적 - trace

이미 돌아가는 시스템에서 뭔가 어긋났을 때 사용합니다. 여러 tracer 에이전트가 병렬로 코드와 로그를 훑어 증거를 모아 옵니다.

/trace "어제 새벽 결제 API 5xx가 평균보다 4배 많이 발생했다. 관련 변경, 외부 의존성, 인프라 이벤트를 모두 모아서 가설을 세워줘."

6-3. 큰 기능 한 번에 - ultrawork

병렬 처리 강도를 끝까지 올린 모드입니다. 여러 화면이나 여러 모듈을 한 번에 수정해야 할 때, 일관성을 잃지 않으면서 동시에 진행할 수 있도록 도와줍니다.

/ultrawork "다크 모드 전체 적용. 8개 화면, 디자인 토큰은 design.md 기준,
모든 화면에 라이트/다크 스냅샷 테스트 추가."

---

7. 알림과 모니터링

병렬 에이전트는 작업 완료 시점이 들쭉날쭉하기 때문에 알림 연동이 의외로 큰 차이를 만듭니다.

7-1. Telegram

omc config-stop-callback telegram --enable --token <BOT_TOKEN>

7-2. Discord

omc config-stop-callback discord --enable --webhook <WEBHOOK_URL>

7-3. HUD - 터미널 상태 라인

/hud 명령으로 상태 라인을 켜면 진행 중인 에이전트 수, 컨텍스트 사용률, todo 진행도 같은 정보가 화면에 상시 표시됩니다. /ultrawork처럼 병렬 강도가 높은 명령을 쓸 때 특히 도움이 됩니다.

---

8. 비용과 운영 시 주의

OMC 자체는 MIT 라이선스 오픈소스라 무료입니다. 다만 OMC가 호출하는 Claude API(또는 연동된 Codex·Gemini API) 비용은 별도이고, 병렬 에이전트 구조 특성상 단일 세션보다 토큰 소모가 빠릅니다. 다음 두 가지를 미리 알고 들어가는 편이 안전합니다.

• 모델 계층 자동 매핑 - 가벼운 작업은 Haiku, 깊은 사고는 Opus로 자동 분배되어 토큰 비용을 어느 정도 자체 최적화합니다. 그러나 /ultrawork는 그 최적화 위에서도 동시 실행량이 많아 비용이 빠르게 쌓입니다.
• OpenRouter 등 가성비 게이트웨이와 결합 가능 - Claude Code의 ANTHROPIC_BASE_URL을 OpenRouter로 돌려 두면 OMC가 그 위에서 그대로 동작합니다. 자세한 셋업은 Claude Code × OpenRouter 글을 참고하면 됩니다.

ℹ️ Pro/Max 같은 정액 플랜을 쓴다면 비용 자체보다 일일 한도와 rate limit 쪽이 먼저 영향을 받을 수 있습니다. 본격 작업 전에 가벼운 /autopilot 한 번으로 한도 소비 양상을 확인해 두면 좋습니다.

---

트러블슈팅

문제 1: 명령어가 인식되지 않는다

마켓플레이스 등록이 안 됐거나 설치가 절반에서 끊긴 경우입니다. 다음 명령으로 진단부터 합니다.

/plugins
/omc-doctor

/plugins 목록에 oh-my-claudecode가 보이지 않으면 설치 자체가 안 된 것이고, 보이는데 명령이 안 잡히면 /omc-setup이 누락된 경우가 많습니다.

문제 2: 스킬·에이전트가 중복으로 보인다

마켓플레이스 + npm을 둘 다 설치한 흔한 케이스입니다. /omc-doctor로 충돌 항목을 확인하고 둘 중 하나만 남기는 쪽으로 정리합니다.

문제 3: /ultrawork가 도중에 끊긴다

병렬 강도가 높은 명령은 일일 토큰 한도나 rate limit에 먼저 닿습니다. /team이나 /autopilot으로 같은 작업을 단계별로 쪼개 보내는 편이 안정적입니다.

문제 4: 알림이 오지 않는다

Telegram의 경우 봇 토큰뿐 아니라 메시지를 받을 chat_id 설정이 함께 있어야 합니다. /configure-notifications를 한 번 더 돌리면서 단계 안내를 끝까지 따라가면 보통 해결됩니다. Discord는 webhook URL 자체에 권한이 묶여 있어 채널 변경 시 새 webhook을 발급해야 합니다.

---

마무리

OMC의 의의는 새 기능을 더한다는 데 있지 않습니다. "Claude Code를 외우지 않아도 된다"는 인터페이스를 제공한다는 점이 핵심입니다. 슬래시 명령을 외우는 시간을 작업에 그대로 돌릴 수 있게 되고, 모델 계층과 에이전트 분배는 OMC가 자동으로 처리합니다. 사이드 프로젝트나 사내 도구처럼 빠르게 반복하는 환경에서 가장 빛납니다.

운영 환경이거나 결정적 동작이 중요한 워크플로우라면 자동 분배가 오히려 디버깅을 어렵게 만들 수 있어, 그땐 OMC를 끄고 평이한 Claude Code로 돌리는 편이 안전합니다. 도구를 켜고 끄는 두 모드를 함께 가져가는 것이 가장 균형 잡힌 사용법입니다.

 

• OMC GitHub: github.com/Yeachan-Heo/oh-my-claudecode
• 다음 편: 2편 ECC - 30 에이전트와 보안 스캐너까지 한 번에
• 시리즈 인덱스: Claude Code 플러그인 큐레이션 시리즈
• 관련 글: Claude Code 플러그인 가이드
• 관련 글: Claude Code 활용 매뉴얼 - 중요도 순으로 정리한 8가지 원칙
• 관련 글: Claude Code를 OpenRouter로 연결하기