oh-my-claudecode: Claude Code 위에 32개 전문 에이전트를 얹은 오케스트레이션 레이어

AI 기반 소프트웨어 개발 도구가 빠르게 진화하면서, 단일 에이전트의 한계를 넘어 다수의 전문화된 에이전트를 조율하는 멀티 에이전트 오케스트레이션(Multi-Agent Orchestration)이 주목받고 있다. oh-my-claudecode(OMC)는 Anthropic의 Claude Code CLI 위에서 동작하는 팀 기반 멀티 에이전트 오케스트레이션 플러그인으로, 32개의 전문 에이전트와 40개 이상의 스킬을 통해 복잡한 개발 작업을 자동으로 병렬화하고 완료까지 지속적으로 추적하는 도구다.

무엇을 해결하려고 나왔나

oh-my-claudecode는 Claude Code CLI 환경에서 다수의 전문 에이전트를 조율해 소프트웨어 개발 작업을 자동화하는 오케스트레이션 레이어로, Yeachan Heo(허예찬)가 오픈소스로 개발 및 유지보수한다. Claude Code 단독 사용 시 복잡한 멀티파일 변경, 디버깅, 리팩토링 작업에서 수동 개입이 빈번히 필요했고, 이를 해결하기 위해 전문 에이전트 위임 패턴이 등장했다. 핵심 철학은 "You are the conductor, not the performer" — 사용자는 지휘자로서 작업을 조율하고, 실제 수행은 전문 에이전트에게 위임한다는 것이다.

이 철학이 겨냥하는 문제는 네 가지다. 하나의 Claude 인스턴스로 복잡한 작업을 수행하면 컨텍스트 윈도우 부족과 정확도 저하가 발생하는 단일 에이전트 한계, 개발자가 직접 파일 탐색·코드 리뷰·테스트 실행을 지시해야 하는 수동 워크플로우, 모든 작업에 동일한 고비용 모델을 쓰는 토큰 낭비, 복잡한 멀티스텝 작업에서 진행 상황과 완료 여부를 확인하기 어려운 작업 추적 부재다.

오케스트레이션 레이어의 뼈대

oh-my-claudecode는 Claude Code의 네이티브 기능 위에 오케스트레이션 레이어를 추가하는 구조로 설계되어 있다.

⤢✕

이를 계층으로 정리하면, 사용자 인터페이스 계층은 CLI·매직 키워드·슬래시 커맨드로 자연어 명령을 입력받고, 오케스트레이션 계층은 모델 라우팅·에이전트 디스패치·스킬 매칭으로 작업을 분배·조율하며, 에이전트 계층은 5개 기능 레인에 걸친 32개 전문 에이전트가 실제 작업을 수행하고, 인프라 계층은 State·Notepad·Project Memory로 상태 관리와 지속성을 담당한다.

작업 복잡도에 맞춰 모델을 바꿔 끼운다

oh-my-claudecode의 차별화된 핵심 기능 중 하나는 작업 복잡도에 따라 자동으로 최적 모델을 선택하는 스마트 모델 라우팅(Smart Model Routing)이다. 파일 탐색, 간단한 조회, 문서 작성 등 가벼운 작업은 Haiku에 할당해 비용을 절감하고, 코드 구현·디버깅·테스트 엔지니어링 같은 표준 개발 작업은 Sonnet에, 아키텍처 설계·심층 코드 분석·보안 리뷰처럼 고도의 추론이 필요한 작업은 Opus에 할당한다.

수동 모델 설정 없이 자동 라우팅이 이뤄지며, 이를 통해 토큰 사용량을 30~50% 절감하면서도 작업 품질은 유지한다.

5개 레인에 나뉜 32개 에이전트

oh-my-claudecode는 5개 기능 레인(Functional Lane)에 걸쳐 32개의 전문 에이전트를 제공한다.

기능 레인	에이전트	기본 모델	주요 역할
탐색/분석	explore, analyst	Haiku, Opus	코드베이스 탐색, 요구사항 분석
설계/계획	planner, architect, critic	Opus	구현 계획, 아키텍처 설계, 비평
구현	executor, designer, test-engineer	Sonnet	코드 작성, UI 설계, 테스트 구현
검증/리뷰	verifier, code-reviewer, security-reviewer, qa-tester	Sonnet, Opus	코드 리뷰, 보안 검토, 품질 검증
유틸리티	writer, git-master, document-specialist, debugger, code-simplifier, scientist	Haiku~Opus	문서화, Git 관리, 디버깅, 코드 간소화

위임 원칙은 명확하다. 멀티파일 변경, 리팩토링, 디버깅, 리뷰, 계획 수립, 조사, 검증 같은 복잡한 작업은 위임하고, 사소한 연산이나 작은 설명, 단일 명령 실행 같은 간단한 작업은 직접 수행한다. SDK 사용이 불확실할 때는 document-specialist 에이전트로 공식 문서를 확인한 뒤 작업한다.

Autopilot부터 Deep Interview까지, 작업 성격에 맞춘 실행 모드

oh-my-claudecode는 작업 유형과 복잡도에 따라 다양한 실행 모드를 제공한다.

Autopilot 모드는 고수준 아이디어에서 동작하는 코드까지 완전 자율 실행하며, 수동 개입 없이 계획 수립 → 구현 → 테스트 → 검증까지 자동 수행한다. 키워드 "autopilot"으로 활성화한다.

Ralph 모드는 작업이 검증 완료될 때까지 지속적으로 반복 실행하며, Architect 에이전트가 최종 검증을 수행한다. 키워드 "ralph"로 활성화한다.

Ultrawork 모드는 다수의 에이전트를 병렬로 실행해 최대 처리량을 달성하며, 독립적인 작업을 동시에 수행해 전체 소요 시간을 단축한다. 키워드 "ulw"로 활성화한다.

Team 모드는 N개의 조율된 에이전트가 공유 태스크 리스트 기반으로 협업하며, Claude Code 네이티브 팀 기능을 활용해 실시간 메시징과 태스크 조율을 지원한다. /team 명령으로 활성화한다.

Deep Interview 모드는 소크라테스식 질문법으로 모호한 요구사항을 명확화하고, 숨겨진 가정을 노출해 명확도를 수학적으로 측정한다. 코드 작성 전 요구사항 정제에 활용하며, 키워드 "deep interview"로 활성화한다.

매직 키워드로 움직이는 스킬 시스템

oh-my-claudecode는 40개 이상의 스킬을 제공하며, 매직 키워드(Magic Keyword) 패턴으로 사용자 의도를 자동 감지한다. 워크플로우 스킬로는 autopilot, ralph, ultrawork, team, ccg, ultraqa, ralplan, sciomc가 있고, 계획/분석 스킬로는 omc-plan, deep-interview, external-context, deepinit이, 유틸리티 스킬로는 ask-codex, ask-gemini, cancel, note, learner, skill, writer-memory가, 설정 스킬로는 omc-setup, mcp-setup, hud, configure-notifications, omc-doctor가 있다.

CCG(Claude-Codex-Gemini) 트리 모델 오케스트레이션은 Claude, Codex(OpenAI), Gemini(Google) 세 가지 AI 모델에 동시 질의하고, 각 모델의 응답을 Claude가 종합해 최적 결과를 도출한다. 다양한 관점의 교차 검증이 가능하다.

설치는 플러그인 한 줄

사전 요구사항은 Claude Code CLI 설치 완료, Claude Max/Pro 구독 또는 Anthropic API 키 보유이며 추가 의존성은 없다.

# Claude Code 내에서 플러그인 추가
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# 플러그인 설치
/plugin install oh-my-claudecode

# 설정 마법사 실행
/oh-my-claudecode:omc-setup

npm CLI 도구는 다음과 같이 설치한다.

npm install -g oh-my-claude-sisyphus

계획부터 수정까지 이어지는 팀 파이프라인

oh-my-claudecode의 팀 모드는 구조화된 파이프라인을 통해 작업을 관리한다.

⤢✕

작업 분석과 구현 계획을 세우는 team-plan, 요구사항 문서(PRD)를 작성하는 team-prd, 계획에 따라 구현하는 team-exec, 구현 결과를 검증하는 team-verify, 검증 실패 시 최대 시도 횟수 제한 안에서 반복 수정하는 team-fix 순서로 진행된다.

알림은 어디로 보낼 수 있나

oh-my-claudecode는 작업 완료, 입력 필요, 오류 발생 시 알림을 제공한다. Discord는 웹훅 기반, Telegram은 봇 API 연동, Slack은 웹훅 연동으로 지원하며, 임의의 Custom Webhook 엔드포인트도 지정할 수 있다.

/oh-my-claudecode:configure-notifications

자연어로 알림 설정을 구성할 수 있어 별도의 설정 파일 편집이 필요 없다.

v4.7.x에서 달라진 것들

v4.7.x는 팀 오케스트레이션 런타임을 이벤트 기반으로 재설계하며 기존 watchdog/done.json 폴링 방식을 제거했고, tmux 없이도 외부 AI 모델을 활용할 수 있도록 비-tmux Codex/Gemini 스킬을 복원했다. 포괄적인 보안 하드닝을 적용했으며, 무한 팀 스포닝을 방지하고 명시적 /team 호출에서만 팀 모드가 활성화되도록 안정성을 개선했다.

생태계 측면에서는 Claude Code 플러그인 마켓플레이스 등록으로 설치 편의성이 높아졌고, ultrawork 전용 경량 버전인 TechDufus/oh-my-claude 같은 파생 프로젝트가 등장했으며, 커뮤니티 기반 스킬 개발이 활성화되고 있다.

다른 도구와 놓고 보면

특성	Claude Code (단독)	oh-my-claudecode	기타 에이전트 프레임워크
에이전트 수	1개	32개 전문 에이전트	프레임워크별 상이
모델 라우팅	수동	자동 (Haiku/Sonnet/Opus)	일부 지원
병렬 실행	제한적	Ultrawork, Team 모드	프레임워크별 상이
설치 복잡도	기본	플러그인 1줄 설치	별도 환경 구성 필요
학습 곡선	낮음	제로 (자연어 + 매직 키워드)	높음 (API/설정 학습 필요)
상태 관리	없음	Notepad, Project Memory, State	프레임워크별 상이
외부 모델 통합	없음	CCG (Codex + Gemini)	일부 지원

도입 전에 챙길 것

다수 에이전트를 병렬 실행하면 토큰 사용량이 늘어날 수 있어 스마트 라우팅으로 완화되긴 하지만 모니터링이 필요하다. API 키 없이 쓰려면 Claude Max/Pro 구독이 필요하고, 소규모 단일 파일 수정에는 오버킬이라 멀티파일·멀티스텝 작업에서 진가를 발휘한다. Team 모드 등 일부 기능은 tmux 세션 관리에 의존하며, 활발히 개발이 진행 중이라 주기적인 플러그인 업데이트가 권장된다.

oh-my-claudecode는 Claude Code의 단일 에이전트 한계를 극복하고, 32개의 전문 에이전트와 40개 이상의 스킬을 통해 소프트웨어 개발 워크플로우를 자동화하는 멀티 에이전트 오케스트레이션 플러그인이다. 스마트 모델 라우팅으로 비용을 최적화하면서도, Autopilot, Ralph, Ultrawork, Team 등 다양한 실행 모드를 통해 작업 복잡도에 맞는 유연한 에이전트 조율을 제공한다. 자연어와 매직 키워드 기반의 제로 학습 곡선 설계로, AI 기반 에이전트 개발 생태계에서 실용적인 오케스트레이션 도구로 자리매김하고 있다.