🤖 Claude Code, 이제 팀으로 굴려야 한다 — oh-my-claudecode 완전 정복

 

혼자 쓰는 AI 코딩 도구, 이제 한계가 보이기 시작했다면

Claude Code 써보셨나요?

처음엔 정말 신기했죠. 자연어로 명령하면 코드가 뚝딱 나오고, 버그도 알아서 잡아주고. 그런데 조금 더 쓰다 보면 슬슬 한계가 느껴지는 순간이 옵니다.

"파일이 20개 넘어가는 리팩토링은 왜 이렇게 느리지?"

"설계, 구현, 테스트를 한 번에 돌리고 싶은데, 나한테 계속 물어보네."

"컨텍스트가 날아가면 처음부터 다시 설명해야 하는 거잖아?"

이 답답함을 정면으로 해결하려고 나온 도구가 있어요. 바로 오늘 이야기할 oh-my-claudecode, 줄여서 OMC입니다.

한 마디로 정리하면, Claude Code 혼자 하던 일을 팀이 나눠서 하게 만드는 플러그인이에요. 설계자, 실행자, QA 검증자가 동시에 굴러가는 구조입니다.

왜 이런 도구가 나왔을까? 배경부터 짚어보면

AI 코딩 도구 생태계는 2025~2026년 사이 정말 빠르게 변했어요.

Anthropic이 서드파티 앱이나 비공식 래퍼들이 Claude 웹 구독 플랜을 무단으로 연동하는 것을 정책적, 기술적으로 강하게 차단하기 시작했거든요. 그 흐름 속에서 커뮤니티가 주목한 건 Claude Code의 공식 플러그인 시스템이었습니다. 정책을 어기지 않으면서도 멀티 에이전트를 쓸 수 있는 유일한 합법 경로였으니까요.

OMC의 탄생 스토리도 꽤 흥미롭습니다. 한국 개발자 허연찬(Yeachan-Heo) 님이 oh-my-zsh가 Zsh 셸을 강화하듯 OpenCode에 멀티 에이전트 오케스트레이션을 더해주는 oh-my-opencode를 먼저 만들었어요. 그 과정에서 최적의 멀티 에이전트 구조를 연구하는 데 2만 4천 달러, 우리 돈으로 약 3,400만 원 상당의 토큰을 직접 태웠다고 합니다.

그 연구의 결정체가 Claude Code 기반으로 이식된 것이 바로 OMC입니다. 한국 개발자가 만든 오픈소스가 글로벌 개발자 커뮤니티에서 주목받고 있다는 점도 꽤 뿌듯한 이야기죠.

OMC가 기존 Claude Code와 다른 핵심 차이점

Claude Code를 평소처럼 쓰면 어떻게 되나요? 사용자가 명령을 입력하고, 결과를 받고, 수정하고, 또 입력하고... 이 사이클을 계속 반복합니다. AI가 혼자 일하고, 사람이 중간 중간 개입하는 구조예요.

OMC는 이 구조 자체를 바꿔버립니다.

핵심 철학은 자동 위임입니다. 사용자가 "복잡한 기능 구현해줘"라고 하면 OMC는 내부에서 설계, 리서치, 실행, QA 같은 전문 역할로 일을 쪼개서 병렬로 처리해요. 사용자가 서브 에이전트니 스킬이니 하는 개념을 하나씩 공부하지 않아도 됩니다.

OMC가 내세우는 슬로건도 이걸 잘 표현하고 있어요.

"Claude Code를 배우지 마세요. 그냥 OMC를 쓰세요."

그리고 Claude Code가 원래 대화의 마스터를 다른 에이전트로 교체하는 방식이 아니라, 고정된 마스터에 스킬을 주입하는 방식으로 동작한다는 점을 OMC는 제대로 이해하고 있어요. 모드를 갈아타는 게 아니라 행동을 겹겹이 쌓는 레이어 구조를 택한 이유가 바로 이것입니다.

32개 에이전트, 40개 이상 스킬 — 구조가 어떻게 생겼나

OMC는 엄청난 규모처럼 보이지만, 실제로 자주 쓰는 건 몇 가지 핵심 모드예요.

처음 봤을 때 압도되지 않으셔도 돼요. 실무에서 가장 많이 쓰는 모드 위주로 정리해 드릴게요.

ralph 모드는 계획 수립 후 끊임없는 실행을 조합한 것입니다. 복잡한 기능을 구현할 때 가장 강력하고, 스스로 계획을 세우고 실행하면서 막히면 다시 계획을 조정합니다.

autopilot 모드는 완전 자율 실행이에요. 명확한 작업을 맡기고 손을 떼고 싶을 때 씁니다. QA 사이클을 자율적으로 반복 실행하며 목표를 달성할 때까지 테스트와 수정을 반복해요.

deep-interview는 코딩을 시작하기 전에 소크라테스식 질문으로 생각을 명료화해주는 기능입니다. "뭘 만들고 싶은지는 알겠는데, 요구사항이 아직 불명확하다"는 상황에서 특히 유용합니다. 숨겨진 가정들을 드러내고 실행 전에 정확히 무엇을 만들어야 하는지 알 수 있게 해줘요.

그리고 v4.1.7부터는 Team 모드가 OMC의 표준 오케스트레이션 방식이 됐습니다. plan → PRD → execute → verify → fix의 단계적 파이프라인으로 복잡한 프로젝트를 체계적으로 다룹니다.

"레이어를 쌓는다"는 게 무슨 뜻인지 직접 보면

대부분이 오해하는 부분이 있어요. OMC는 모드를 갈아타는 게 아닙니다.

실행(기본) 레이어 위에 frontend-ui-ux, git-master 같은 보강 레이어를 얹는 방식이에요. 구조로 표현하면 이렇습니다.

실행 스킬 + 보강 스킬 0~N개 + 선택적 보장

예를 들어 "UI 작업 + 여러 파일 수정 + 커밋까지" 같은 복합 작업을 하나의 흐름에서 처리할 수 있어요. 모드를 바꾸면서 맥락이 끊기는 문제가 없습니다.

그리고 Claude가 이전 대화를 잊어버리는 컨텍스트 압축 문제는 3단계 메모리 시스템으로 대응합니다. 우선순위 메모리, 작업 메모리, 수동 노트 세 가지 계층으로 핵심 정보를 유지해요.

설치는 진짜 단 두 줄입니다

Claude Code 세션 안에서 이렇게 입력하면 끝이에요.

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

그 다음 /oh-my-claudecode:omc-setup을 실행하면 모든 설정이 자동으로 완료됩니다.

복잡한 환경 변수 설정도, 긴 설정 파일도 없어요. Node.js 훅 통합까지 전부 자동으로 처리됩니다. 진짜로 설치에 5분이 안 걸립니다.

npm을 통한 CLI 설치를 선호한다면 oh-my-claude-sisyphus라는 패키지명으로 설치하면 돼요. 브랜드명은 oh-my-claudecode인데 npm 패키지명이 다른 건 흥미로운 포인트입니다.

실무에서 어떤 상황에 가장 잘 맞을까

OMC가 진짜 빛나는 상황이 있고, 반대로 굳이 안 써도 되는 상황도 있어요.

이런 상황에서 쓰면 효과가 큽니다. 20개 이상의 파일을 건드리는 대규모 리팩토링, 설계와 구현과 검증이 동시에 굴러가야 하는 복잡한 기능 개발, 컨텍스트가 자주 날아가는 장기 세션, 계획이 필요한데 인터뷰할 시간이 없을 때가 여기 해당해요.

실제로 React 클래스 컴포넌트 40개를 함수형으로 마이그레이션하는 작업을 직접 해보면, 수작업으로는 2~3일 걸릴 일을 OMC의 병렬 실행으로 훨씬 단축할 수 있다는 보고들이 커뮤니티에 올라오고 있어요.

반대로 간단한 질문 하나, 단일 파일 수정, 짧은 스크립트 작업 같은 건 OMC 없이 그냥 Claude Code를 쓰는 게 낫습니다. 병렬화와 보강 스킬은 기본적으로 더 많은 토큰을 씁니다. 팀장, 설계자, 실행자를 전부 소집할 필요가 없는 일에 다 불러내는 건 오히려 낭비예요.

단순 작업은 Claude Haiku가 자동으로 처리하고, 복잡한 추론이 필요한 작업만 상위 모델을 쓰도록 자동 라우팅하는 기능도 있는데, 이게 토큰 비용을 30~50% 줄여준다는 보고도 있어요.

GitHub 스타가 말해주는 것 — 지금 이 생태계의 온도

이 저장소는 현재 GitHub 트렌딩 상위권을 계속 유지하고 있습니다. 24시간 만에 858개 스타가 쌓였다는 기록도 있고요. 영어, 한국어, 중국어, 일본어, 스페인어, 베트남어, 포르투갈어 다국어 문서까지 갖춘 글로벌 프로젝트로 성장했어요.

업데이트도 정말 활발합니다. 보안 취약점 21개 패치, HUD 토큰 실시간 추적 기능, 미션 보드를 통한 멀티 에이전트 진행 상황 시각화, 새로운 Tracer Agent 도입까지 계속 기능이 쌓이고 있어요.

한국 개발자가 씨앗을 뿌린 오픈소스가 글로벌 커뮤니티에서 이 정도 반응을 받는다는 게 사실 꽤 드문 일이에요. 그만큼 이 도구가 해결하는 문제가 보편적이라는 증거이기도 합니다.

이 도구가 바꾸는 건 개발 속도가 아니라 개발자의 역할

멀티 에이전트 시스템에서는 뭔가 달라집니다.

코드를 어떻게 짤지 고민하는 시간보다, 어떤 역할에 어떤 작업을 맡길지 설계하는 능력이 더 중요해지거든요. 개발자 역할이 점점 작업자에서 오케스트레이터로 이동하고 있다는 말이 과장이 아니에요.

AI가 구현과 테스트의 상당 부분을 가져가면, 사람은 이 기능이 사용자와 비즈니스에 어떤 영향을 주는가에 집중할 수 있게 됩니다. 레거시 리팩토링이나 문서화처럼 손대기 싫어서 미뤄두던 작업들도 AI에게 던지기 좋은 후보가 됩니다.

프롬프트를 잘 쓰는 능력보다, 일을 어떻게 쪼개고 어떤 흐름으로 맡길지 설계하는 능력이 더 중요해지는 시대입니다. OMC는 그 방향으로 가는 연습을 시작하기에 좋은 출발점이에요.

마무리

oh-my-claudecode는 Claude Code에 팀을 붙여주는 도구입니다. 혼자 일하던 AI를 팀장, 설계자, 실행자, 검증자로 나눠서 함께 굴리는 방식이에요.

단 두 줄 설치에, 별도 학습 없이, 자연어 명령만으로 멀티 에이전트 오케스트레이션을 경험할 수 있습니다. Claude Code를 쓰고 있다면, 지금이 팀플레이를 시도해볼 타이밍입니다.

한번 시도해보세요. 커피 한 잔 타러 갔다 오면 생각보다 많이 진행돼 있을 거예요.