Oh My ClaudeCode(OMC) 완벽 가이드: Claude Code를 멀티에이전트 팀으로 만드는 법

Claude Code 혼자서는 부족할 때

Claude Code는 혼자서도 충분히 강력하다. 하지만 프로젝트가 커지면 한계가 보이기 시작한다.

파일 10개를 동시에 리팩토링해야 할 때, 테스트를 돌리면서 동시에 문서를 업데이트해야 할 때, 코드 리뷰와 구현을 병렬로 진행하고 싶을 때. Claude Code 하나로는 순차적으로 처리할 수밖에 없다.

**Oh My ClaudeCode(OMC)**는 이 문제를 해결한다. Claude Code에 멀티에이전트 시스템을 얹어서, 여러 전문 에이전트가 동시에 작업하게 만든다. 혼자 일하던 개발자에게 팀을 붙여주는 셈이다.

OMC가 뭔가

Yeachan Heo가 만든 오픈소스 Claude Code 플러그인이다. GitHub에서 13,000개 이상의 스타를 받았고, Claude Code 플러그인 마켓플레이스에 등록되어 있다.

핵심은 세 가지다.

• 멀티에이전트 오케스트레이션: 여러 에이전트가 작업을 나눠서 병렬 처리한다
• 전문 에이전트 팀: 코드 리뷰어, 아키텍트, 디버거 등 역할별 전문 에이전트를 제공한다
• 고급 도구 통합: LSP, AST 검색, 프로젝트 메모리 같은 개발 도구를 MCP 서버로 통합한다

이름에서 알 수 있듯이 Oh My Zsh에서 영감을 받았다. Zsh에 Oh My Zsh를 깔면 쉘이 강력해지듯, Claude Code에 OMC를 깔면 AI 에이전트가 강력해진다.

설치 방법

플러그인 마켓플레이스에서 설치 (추천)

Claude Code를 실행한 상태에서 아래 명령어를 입력한다.

/install-plugin oh-my-claudecode

설치가 끝나면 초기 설정을 실행한다.

/omc-setup

이 과정에서 LSP 서버 설정, 프로젝트 메모리 초기화 등이 자동으로 진행된다.

npm으로 설치

npm을 선호한다면 이 방법도 있다.

npm install -g oh-my-claudecode
omc install

설치 확인

Claude Code에서 OMC가 제대로 동작하는지 확인한다.

/omc-doctor

문제가 있으면 진단 결과와 함께 해결 방법을 알려준다.

핵심 모드

OMC의 진가는 다양한 실행 모드에 있다. 상황에 따라 적합한 모드를 골라 쓸 수 있다.

Autopilot — 처음부터 끝까지 자동

가장 강력한 모드다. 목표만 주면 브레인스토밍, 계획 수립, 구현, 테스트, 검증까지 알아서 한다.

/autopilot 블로그에 댓글 기능 추가해줘

이렇게 던져놓으면 혼자서 파일을 분석하고, 필요한 컴포넌트를 만들고, API를 구현하고, 테스트까지 돌린다. 간단한 기능이라면 커피 한 잔 마시고 돌아오면 끝나 있다.

다만 복잡한 기능에서는 중간에 방향이 틀어질 수 있으니, 중요한 작업에서는 team 모드나 ultrawork가 더 적합하다.

Ultrawork — 병렬 처리의 끝판왕

여러 에이전트를 동시에 띄워서 독립적인 작업을 병렬로 처리한다.

/ultrawork 아래 5개 컴포넌트를 각각 리팩토링해줘: Header, Footer, Sidebar, Nav, Card

순차적으로 하면 5배 걸릴 작업을 거의 동시에 끝낸다. 각 에이전트가 서로 다른 파일을 담당하니까 충돌도 없다. 대규모 리팩토링, 마이그레이션, 일괄 수정 작업에서 특히 빛난다.

Team — 작업 목록 기반 협업

N개의 에이전트가 공유 작업 목록을 보면서 하나씩 가져가서 처리한다. Ultrawork와 비슷하지만 더 체계적이다.

/team 아래 작업들을 처리해줘:
1. 사용자 인증 API 구현
2. 인증 미들웨어 추가
3. 로그인 페이지 UI 작성
4. 테스트 코드 작성

에이전트 간 의존성이 있으면 자동으로 순서를 조절한다. 코드 충돌이 발생하면 해결하고 넘어간다.

Deep Interview — 시작 전에 제대로 물어보기

코드를 쓰기 전에 소크라테스식 질문으로 요구사항을 파고든다.

/deep-interview 결제 시스템을 만들려고 하는데

"어떤 결제 수단을 지원할 건가요?", "환불 정책은?", "PG사는 결정됐나요?" 같은 질문을 던지면서 애매한 부분을 명확하게 만든다. 질문이 끝나면 정리된 요구사항 문서를 만들어준다.

Ralph — 될 때까지 반복

목표를 주면 달성할 때까지 자기 참조 루프를 돈다. 중간에 에러가 나면 알아서 고치고, 테스트가 실패하면 알아서 수정한다.

/ralph 모든 테스트가 통과할 때까지 이 버그 고쳐줘

"고쳤습니다"가 아니라 실제로 테스트가 통과하는 것을 확인할 때까지 반복한다. 검증자(reviewer)를 설정하면 더 엄격하게 확인할 수도 있다.

전문 에이전트

OMC는 역할별로 특화된 에이전트를 제공한다. 각 에이전트는 적합한 모델(Opus, Sonnet, Haiku)로 라우팅되어 비용과 성능의 균형을 맞춘다.

예를 들어 아키텍처 설계는 Opus가 맡고, 단순 구현 작업은 Sonnet이 처리하고, 문서 작성은 Haiku가 담당한다. 비싼 모델을 모든 작업에 쓰지 않으니 토큰 비용이 절약된다.

에이전트는 자동으로 선택되기도 하고, 직접 지정할 수도 있다.

아키텍처 리뷰 좀 해줘
→ architect 에이전트가 자동으로 담당
 
이 PR 코드 리뷰해줘
→ code-reviewer 에이전트가 자동으로 담당

고급 도구

OMC는 에이전트 모드 외에도 개발에 유용한 도구들을 MCP 서버로 제공한다.

LSP 통합

Language Server Protocol을 통해 코드의 구조적 분석이 가능하다.

• 정의로 이동: 함수나 변수의 선언 위치를 정확히 찾는다
• 참조 검색: 특정 심볼이 어디서 사용되는지 찾는다
• 진단: 타입 에러, 린트 경고를 실시간으로 확인한다
• 리네임: 심볼 이름을 프로젝트 전체에서 안전하게 변경한다

단순 텍스트 검색이 아니라 코드의 의미를 이해하고 분석하는 거라서 정확도가 다르다.

AST 검색

코드를 추상 구문 트리(AST) 수준에서 검색하고 치환할 수 있다.

모든 console.log 호출을 logger.debug로 바꿔줘

정규식으로는 놓치기 쉬운 패턴도 AST 기반이면 정확하게 잡아낸다.

프로젝트 메모리

세션 간에 프로젝트 컨텍스트를 유지한다. 이전 세션에서 내린 결정, 프로젝트 구조에 대한 이해, 코딩 컨벤션 등이 다음 세션에도 이어진다. 매번 처음부터 설명할 필요가 없다.

실전에서 어떻게 쓰는가

나는 이 블로그를 만들면서 OMC를 쓰고 있다. 실제로 도움이 됐던 시나리오를 몇 가지 공유한다.

블로그 글 작성 파이프라인

OMC의 에이전트 시스템을 활용해서 블로그 글 작성 스킬을 만들었다. 키워드 분석 → 자료 조사 → 팩트 체크 → 글 작성 → 편집 순서로 5개 에이전트가 순차적으로 작업한다. 각 단계의 산출물이 다음 단계로 넘어가는 파이프라인이다.

컴포넌트 일괄 생성

블로그에 시각화 컴포넌트가 여러 개 필요했는데, ultrawork로 병렬 생성했다. CompareCard, PlanCard, FlowCard 등을 동시에 만들어서 시간을 크게 줄였다.

코드 리뷰 자동화

PR을 만들기 전에 code-reviewer 에이전트로 셀프 리뷰를 돌린다. 보안 취약점, 성능 이슈, 스타일 일관성을 체크하고 수정 사항을 제안한다.

주의할 점

토큰 소비가 크다

멀티에이전트는 에이전트 수만큼 토큰을 쓴다. Ultrawork로 5개 에이전트를 돌리면 토큰도 5배 가까이 소모된다. Pro 플랜에서는 레이트 리밋에 빨리 도달할 수 있으니 Max 플랜이나 API 직접 연결을 고려해야 한다.

학습 곡선이 있다

autopilot, ultrawork, team, ralph 등 모드가 많아서 처음에는 어떤 걸 언제 써야 할지 헷갈린다. 시작할 때는 autopilot 하나만 써보고, 익숙해지면 상황에 맞는 모드로 넓혀가는 걸 추천한다.

간단한 작업에는 과하다

파일 하나 수정하는 데 멀티에이전트가 필요하지 않다. OMC의 가치는 여러 파일에 걸친 복잡한 작업, 대규모 리팩토링, 체계적인 워크플로우가 필요한 상황에서 나타난다.

Superpowers와 뭐가 다른가

이전 글에서 다뤘던 Superpowers와 비교하면, 초점이 다르다.

• Superpowers: 엔지니어링 규율에 집중. 브레인스토밍, TDD, 체계적 디버깅 같은 워크플로우를 강제한다.
• OMC: 멀티에이전트와 도구 통합에 집중. 병렬 처리, 전문 에이전트, LSP/AST 도구를 제공한다.

둘은 경쟁이 아니라 보완 관계다. 실제로 OMC에 Superpowers 스킬이 내장되어 있어서 함께 쓸 수 있다. Superpowers가 "어떻게 일할 것인가"를 정해주고, OMC가 "얼마나 빠르고 효율적으로 일할 것인가"를 담당하는 구조다.

정리

Oh My ClaudeCode는 Claude Code를 단독 에이전트에서 멀티에이전트 팀으로 확장해주는 플러그인이다. autopilot으로 자율 실행하고, ultrawork로 병렬 처리하고, 전문 에이전트가 역할별로 분담한다.

설치는 /install-plugin oh-my-claudecode 한 줄이면 끝난다. Claude Code를 이미 쓰고 있다면, OMC는 가장 먼저 깔아볼 플러그인이다.