Oh-My-ClaudeCode: 단일 AI에서 AI 팀으로

Claude Code는 강력하다. 그런데 혼자다. Oh-My-ClaudeCode는 그 혼자인 Claude에게 팀을 붙여준다.

1. Oh-My-ClaudeCode란?

"Zero learning curve. Just describe what you want."

OMC는 Claude Code 위에서 동작하는 소프트웨어 개발 전용 다중 에이전트 오케스트레이션 프레임워크다. 코드 작성·리뷰·테스트·문서화 같은 개발 작업에 특화되어 있으며, 사용자가 자연어로 목표를 제시하면 OMC가 이를 분해해 적합한 에이전트에 위임하고 결과를 통합한다. 에이전트는 분석가, 구현가, 검수자, 보안 리뷰어 등 29개 전문 역할로 나뉘어 있다.

이름은 쉘 생태계의 oh-my-zsh에서 영감을 받았고, 구조적으로는 oh-my-opencode의 개념을 Claude Code에 이식한 것이다.

2. 왜 Plain Claude Code만으로는 부족한가?

한계 1: 순차 실행의 병목

기본 Claude Code는 한 번에 하나의 태스크만 처리한다. 요구사항 분석 → 설계 → 구현 → 테스트 → 문서화를 모두 직렬로 진행해야 한다. 규모가 커질수록 사람이 중간 조율을 해야 한다.

한계 2: 컨텍스트 윈도우 휘발

긴 세션에서 초기 결정사항, 아키텍처 근거, 기술 부채 메모는 컨텍스트 압축 시 사라진다. 다음 세션에서 같은 내용을 다시 설명해야 한다.

한계 3: 전문성 없는 범용 응답

Claude Code는 보안 전문가이기도 하고, UI 디자이너이기도 하고, DevOps 엔지니어이기도 하다. 한 에이전트가 모든 도메인을 담당하면 깊이가 얕아진다.

3. 내부 구조: 어떻게 동작하는가?

핵심 아키텍처: Hook → Skill → Agent

사용자 입력
    ↓
Hooks (UserPromptSubmit, PreCompact 등 이벤트 감지)
    ↓
Skills (autopilot, ultrawork, ralph 등 행동 주입)
    ↓
Agent Routing (태스크 타입 → 최적 에이전트 선택)
    ↓
State Persistence (.omc/ 디렉토리에 영구 저장)
    ↓
결과 통합 및 보고

3계층이 핵심이다.

1. Hooks: Claude Code의 이벤트를 감지해 자동 동작을 트리거한다
2. Skills: 36개의 재사용 가능한 행동 패턴. 프로젝트 간에도 재사용된다
3. Agents: 29개 전문 에이전트, 4개 계층으로 조직화

에이전트 4계층 조직

계층	담당 역할	예시 에이전트
Build/Analysis	탐색·분석·디버깅	analyzer, debugger, planner
Review	보안·코드 품질 게이트	security-reviewer, code-reviewer
Domain	전문 도메인	tester, ui-designer, documenter, devops
Coordination	다른 계획에 도전해 합의 도출	challenger, coordinator

모델 자동 선택

에이전트별로 Haiku(빠른 단순 작업) / Sonnet(코드 구현) / Opus(전략적 분석)가 자동으로 할당된다. 비용 효율과 품질을 동시에 잡는 방식이다.

상태 영구 저장

.omc/ 디렉토리가 프로젝트 루트에 생성된다.

• .omc/state/ — 오케스트레이션 메타데이터, 에이전트 큐, 워커 할당
• .omc/plans/ — PRD, 설계 문서
• .omc/notepads/ — 아키텍처 결정, 발견된 기술 부채, 패턴 메모

컨텍스트가 압축되어도 notepads는 살아있다.

4. 실행 모드: 5가지 오케스트레이션 전략

OMC는 작업의 성격에 따라 모드를 선택한다.

모드	특징	적합한 상황
Autopilot	확장 → 계획 → 실행 → QA → 검증 5단계 자동	신규 기능 개발
Team	plan → prd → exec → verify → fix 정식 파이프라인	복잡한 스펙이 있는 작업
Ralph	검증 루프 내장 지속 실행	반복적 수정이 필요한 버그 수정
Ultrawork	최대 병렬화	독립적 태스크 다수 병렬 처리
Pipeline	커스텀 워크플로우	팀 특화 반복 패턴

Notepad Wisdom System

Autopilot 실행 중 발견한 패턴, 결정, 기술 부채를 자동으로 notepads에 기록한다. "이 프로젝트에서는 왜 이 구조를 택했는가"가 자동으로 문서화된다.

5. 직접 해보기 (시작 가이드)

1) 설치

Claude Code 플러그인 방식 (권장)

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

npm CLI 방식

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

Node.js 20.0.0 이상, Claude Max/Pro 구독 또는 ANTHROPIC_API_KEY 필요.

2) 첫 실행

autopilot build me a hello world web app

이 한 문장으로 5단계 파이프라인이 시작된다. 요구사항 분석부터 구현, 테스트, 문서화까지 자동이다.

3) 팀 모드로 복잡한 작업 위임

/team 3:executor "결제 모듈 리팩토링 — stripe SDK v3으로 마이그레이션"

3개의 executor 에이전트가 병렬로 작업을 분담한다.

4) 설정 커스터마이징

프로젝트 루트에 .claude/omc.jsonc 생성:

{
  "executor": "sonnet",
  "documenter": "haiku",
  "security-reviewer": "opus"
}

작업 복잡도와 비용 우선순위에 따라 에이전트별 모델을 지정할 수 있다.

부가 설명: Magic Keywords

프롬프트 안에 특정 키워드가 있으면 모드가 자동 활성화된다.

• ultrawork → 최대 병렬 처리 모드
• deep-analyze → 심층 분석 에이전트 우선 배정
• tdd → 테스트 주도 워크플로우 활성화
• security review → 보안 전문 에이전트 강제 포함

6. Plain Claude Code vs. Oh-My-ClaudeCode: 핵심 비교

구분	Plain Claude Code	Oh-My-ClaudeCode
에이전트 수	1개	29개 전문 에이전트
실행 방식	순차	병렬 (Ultrawork)
위임 방식	수동 명령어	자연어 자동 위임
상태 보존	컨텍스트 윈도우 내	.omc/ 영구 저장
도메인 전문성	범용	역할별 특화
비용 최적화	수동	모델 자동 선택
학습 비용	낮음	거의 없음

한 줄 요약: Plain Claude Code = 혼자 뛰는 만능 선수, OMC = 포지션별 분업 팀

7. 한계: 타 도구 대비 상대적 제약

Anthropic 생태계 종속. OMC는 Claude Code 위에서만 동작한다. Cursor, GitHub Copilot Workspace, OpenHands처럼 모델이나 IDE를 자유롭게 선택할 수 없다. Claude Max/Pro 구독 또는 Anthropic API 키가 전제 조건이므로, 이미 다른 AI 코딩 도구에 투자한 팀에는 전환 비용이 발생한다.

완전 자율 실행 미지원. Devin이나 OpenHands는 로컬 환경 없이 클라우드에서 headless로 장시간 작업을 처리한다. OMC는 Claude Code가 실행 중인 로컬 세션에 의존하므로 CI/CD 파이프라인에 직접 통합하거나 비동기로 장시간 위임하는 시나리오에는 적합하지 않다.

팀 단위 오케스트레이션 미지원. 개인 개발자 워크플로우 최적화에 초점을 맞춘 설계다. 여러 사람이 동일한 OMC 오케스트레이션을 공유하거나 팀 단위로 에이전트를 분산 실행하는 구조는 아직 지원하지 않는다.

기존 오케스트레이터와의 충돌. OMC는 UserPromptSubmit 훅을 등록해 프롬프트 단계에서 개입한다. 이미 CLAUDE.md 기반 워크플로우나 자체 훅을 운용하는 팀이라면 오케스트레이션 주도권이 충돌할 수 있다. 어느 쪽이 먼저 프롬프트를 가로채느냐에 따라 의도하지 않은 에이전트 위임이 발생하므로, 기존 자동화 규칙이 있는 환경에서는 격리 테스트가 필수다.

8. 마치며

Oh-My-ClaudeCode는 Claude Code를 "잘 쓰는 방법"이 아니라 "다르게 쓰는 방법"을 제안한다. 단일 에이전트의 범용성 대신 29개 전문 에이전트의 분업을, 수동 지시 대신 자연어 위임을, 세션 종료와 함께 사라지는 컨텍스트 대신 영구 notepads를 선택한 설계다.

아직 토큰 오버헤드와 문서화 미흡이라는 한계가 있다. 하지만 개발 생산성 도구의 방향이 "더 좋은 프롬프트"가 아니라 "더 잘 조직된 에이전트 팀"으로 향하고 있다는 것을 OMC는 명확하게 보여준다.

직접 써보고 싶다면 autopilot build me a hello world app 한 줄로 시작하면 된다.

참조

• Oh-My-ClaudeCode GitHub
• npm 패키지
• Claude Code 공식 문서
• oh-my-opencode (영감 원천)