Claude Code를 팀처럼 쓰는 법: oh-my-claudecode 설치와 활용

Anthropic의 Claude Code는 본질적으로 한 번에 한 명만 일하는 에이전트다. 파일 하나 고치는 데는 충분한데, 40개 React 컴포넌트를 한꺼번에 함수형으로 바꿔야 한다면 이야기가 달라진다. 사용자가 작업을 잘게 쪼개서 순서대로 던지거나, 서브에이전트를 매번 정의해서 호출해야 한다. 이 불편함을 한 줄짜리 자연어 명령으로 압축한 서드파티 플러그인이 oh-my-claudecode(이하 OMC)다.

핵심 요약

OMC는 Claude Code 위에서 단일 에이전트를 5가지 모드의 멀티 에이전트 팀으로 확장하는 MIT 오픈소스 플러그인이다.

설치는 슬래시 커맨드 3줄로 끝난다. /plugin marketplace add → /plugin install → /omc-setup.

마케팅 카피의 ‘3-5배 속도, 30-50% 토큰 절감’은 자체 수치다. 도입 결정은 자체 워크로드 파일럿으로 검증하는 게 낫다.

OMC가 풀려는 문제는 단일 에이전트 한계다

Claude Code는 Anthropic 공식 페이지에서 “터미널·IDE·데스크톱·브라우저에서 동작하는 agentic coding tool”로 정의된다. 관련 소스 파일을 읽고, 변경을 추론하고, 여러 파일에 걸쳐 코드를 작성하고, 테스트를 돌려 실패를 수정하는 루프를 자율적으로 수행한다. 다만 한 번에 한 명의 에이전트가 움직인다는 게 한계다.

서브에이전트를 직접 정의하면 우회는 가능하다. Anthropic 공식 문서는 서브에이전트를 YAML frontmatter가 붙은 마크다운 파일로 정의하도록 안내하고, 무한 중첩을 막기 위해 서브에이전트가 컨텍스트 수집 중에 또 다른 서브에이전트를 만들지 못하도록 제약한다. 실험적 기능인 ‘Agent Teams’를 통해 독립 Claude Code 인스턴스 간 메시지 전달도 연구 프리뷰로 열려 있다. 문제는 이걸 매번 손으로 짜야 한다는 것이다.

OMC는 이 공식 메커니즘 위에 사용자 경험 레이어를 얹어, 자연어 한 줄과 키워드만으로 같은 효과를 내도록 추상화했다. 서브에이전트 정의부터 훅 설정, MCP 연결까지 사용자가 신경 쓰지 않아도 적절한 모드를 골라 굴려준다.

OMC 확산을 만든 건 Anthropic 인프라 정비다

OMC는 진공 상태에서 등장한 게 아니다. Anthropic은 2025년 10월 9일 Claude Code 플러그인을 public beta로 출시해 마켓플레이스 인프라의 기반을 깔았다. 2026년 1분기에는 enterprise 영역으로 확장됐고, 같은 해 3월에는 GitLab·Harvey·Lovable·Replit·Rogo·Snowflake 같은 파트너사 도구를 묶은 ‘Claude Marketplace’까지 발표됐다.

두 마켓플레이스는 역할이 다르다. 전자는 Claude Code 내부에서 /plugin 명령으로 검색·설치하는 카탈로그고, 후자는 enterprise 결제 채널을 통합한 파트너 도구 카탈로그다. OMC는 전자에 속한다. 즉 OMC를 쓴다는 건 Anthropic이 표준화한 플러그인 인프라 위에서 동작하는 서드파티 확장을 쓴다는 뜻이다. 공식 인프라가 정비될수록 OMC 같은 서드파티가 더 빠르게 퍼질 자리가 만들어진 셈이다.

이름이 비슷한 프로젝트도 많다. TechDufus/oh-my-claude는 ‘ultrawork’ 키워드로 병렬 실행을 유도하는 가벼운 프롬프트 모음이고, huangdijia/oh-my-claude-code-plugins는 별도 마켓플레이스를 표방하며, siteboon/claudecodeui는 웹·모바일 GUI다. 이 중 Yeachan-Heo/oh-my-claudecode가 ‘Claude Code 자체를 멀티 에이전트 팀으로 운영한다’는 좁고 깊은 영역을 가장 종합적으로 다룬다.

설치는 슬래시 커맨드 3줄로 끝난다

여기서부터가 진짜 실용 정보다. OMC 공식 README에 따른 설치 순서는 단순하다.

사전 조건은 두 가지다. Claude Code가 설치되어 있어야 하고, Claude Max/Pro 구독 또는 ANTHROPIC_API_KEY 환경 변수가 있어야 모델 호출이 된다. 이게 갖춰졌다면 Claude Code 세션 안에서 다음 세 줄만 실행하면 된다.

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

첫 줄은 마켓플레이스 카탈로그를 가져오는 단계라 아직 플러그인이 설치되지는 않는다. 두 번째 줄에서 실제 설치가 일어나며, User/Project/Local 3종 스코프 중 하나를 고를 수 있다. 팀 단위 공유가 필요하면 Project, 개인 전역 사용이면 User를 쓰면 된다. 세 번째 줄은 초기 구성이고, --local 플래그를 붙이면 프로젝트 폴더에 ./.claude/CLAUDE.md를, 안 붙이면 ~/.claude/CLAUDE.md를 생성한다.

터미널에서 omc CLI를 직접 쓰려면 별도 npm 패키지를 깔아야 한다. 여기가 헷갈리기 쉬운 지점이다. 저장소명은 oh-my-claudecode인데 npm 패키지명은 oh-my-claude-sisyphus다.

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

CLI 설치 후 omc team, omc ask, omc hud, omc doctor 같은 명령을 쓸 수 있다. 다만 omc team은 tmux 기반 워커를 실제 프로세스로 spawn하므로 tmux가 필수다. Windows라면 WSL2 환경에서 돌려야 한다는 게 REFERENCE.md의 명시적 안내다.

멀티 AI 오케스트레이션이 필요하다면 Gemini CLI와 Codex CLI를 추가로 설치한다.

npm install -g @google/gemini-cli
npm install -g @openai/codex

Gemini는 1M 토큰 컨텍스트를 살려 디자인·UI 리뷰에, Codex는 아키텍처 검증에 쓰인다. OMC가 결과를 합성하는 식이다.

5가지 실행 모드, 작업별 선택 기준

OMC가 다섯 가지 모드를 제공한다는 점이 핵심 차별점이다. 모드별로 적합한 작업이 다르니, 이게 곧 도입 가이드의 절반이다.

모드	동작 방식	적합한 작업
Autopilot	단일 리드 에이전트가 end-to-end 처리	단일 파일 편집, 작은 기능 추가
Ultrawork	최대 5개 워커 병렬 실행	대규모 리팩토링, 다중 파일 마이그레이션
Team	N개 워커를 역할별로 코디네이트	작업 단위가 명확히 분할 가능한 경우
Ralph	검증 통과될 때까지 멈추지 않는 루프	무중단 배포, 까다로운 검증 작업
Pipeline	plan→prd→exec→verify→fix 정형 흐름	PRD 생성이 필요한 정형 프로세스

호출은 슬래시 커맨드로 한다. /autopilot "build a todo app with auth", /ultrawork "build a fullstack SaaS with Stripe + Postgres", /team 3:executor "fix all TypeScript errors in /src" 같은 식이다. Ultrawork는 ulw, uw 같은 축약 키워드도 인식한다.

Ralph 모드는 살짝 독특하다. ‘돈’t stop’, ‘must complete’, ‘until done’ 같은 자연어 키워드가 들어가면 자동으로 발동된다. 아키텍처 변경이나 무중단 배포처럼 검증이 까다로운 작업에서 사용자 개입을 줄이는 게 목적이다.

여기에 보조 스킬도 있다. /deep-interview는 Socratic 방식으로 요구사항을 명확화하고, /ralplan은 반복 계획 합의를, /ask claude|codex|gemini는 공급자별 어드바이저 질의를 담당한다.

한국 개발자 블로그 ROBOCO가 정리한 대표 사례를 보면 감이 잡힌다. 통상 2~3일 걸리는 ’40개 클래스 기반 React 컴포넌트의 함수형+Hooks 변환’ 작업을 Ultrawork 모드에서 5개 워커 병렬로 단축한 사례가 보고된다. 같은 패턴은 TypeScript strict 모드 전환에 따른 다수 파일 타입 보강, Jest에서 Vitest로의 테스트 프레임워크 마이그레이션, 모노레포 패키지 일괄 업데이트 같은 작업에 그대로 적용된다.

동작 원리: 훅 시스템과 4단계 피드백 루프

OMC가 마법처럼 보이지만 내부 로직은 Anthropic 공식 권장 패턴을 충실히 따른다. Anthropic 엔지니어링 블로그는 에이전트의 4단계 피드백 루프로 ‘gather context → take action → verify → repeat’을 권장한다. OMC의 Ultrawork와 Team 모드는 이 루프를 사용자가 별도 설계 없이 누리도록 묶어 놓은 구현이다.

내부적으로는 Claude Code의 훅 시스템을 광범위하게 활용한다. Anthropic 공식 Hooks 가이드는 훅을 “LLM의 선택에 의존하지 않고 특정 동작이 결정론적으로 실행되도록 보장하는 사용자 정의 셸 명령”으로 정의한다. Claude Code는 PreToolUse, PostToolUse, Notification, Stop, SubagentStop 등 총 12개의 라이프사이클 이벤트를 노출하는데, OMC는 이 중 11개 이벤트에 걸쳐 20개의 훅 스크립트를 등록한다.

대표적으로 keyword-detector.mjs는 사용자가 입력한 ‘ultrawork’, ‘autopilot’, ‘ralph’ 같은 단어를 감지해 해당 스킬을 자동 활성화한다. skill-injector.mjs는 매칭되는 트리거가 나타나면 스킬을 컨텍스트에 자동 주입한다. permission-handler.mjs는 Bash 권한 요청을 처리하고, post-tool-verifier.mjs는 도구 실행 결과를 검증한다. 마치 비서가 회의 키워드를 듣고 적절한 자료를 슬쩍 책상 위에 올려놓는 것에 가깝다.

MCP(Model Context Protocol) 측면에서도 표준을 따른다. ~/.claude/settings.json 또는 프로젝트 스코프의 .claude/omc.jsonc에서 원격 MCP 서버를 표준 방식으로 연결한다. 사내 컨텍스트 MCP 툴을 폴백 정책과 함께 지정하는 companyContext 필드도 제공한다. 코드 인텔리전스 쪽으로는 LSP와 ast-grep을 통합해 lsp_hover, lsp_goto_definition, lsp_find_references, lsp_diagnostics, lsp_rename 등 12개 도구와 ast_grep_search, ast_grep_replace를 노출한다. 단순 grep 기반 탐색보다 정밀한 IDE급 코드 탐색이 에이전트 차원에서 가능하다는 의미다.

도입 가치가 높은 워크로드와 그렇지 않은 워크로드

여기가 의사결정에서 가장 중요한 부분이다. 마케팅 카피만 보고 도입했다가 작업 성격이 안 맞으면 그냥 무거운 도구가 된다.

가치가 높은 경우는 세 가지다. 첫 번째는 다중 파일·다중 역할 작업이다. 프론트엔드 컴포넌트 일괄 마이그레이션, 모노레포 전반의 타입 에러 수정, 다중 서비스 인증 흐름 리팩토링처럼 작업을 쪼개서 병렬로 굴려야 하는 경우 Ultrawork와 Team 모드의 가성비가 살아난다.

두 번째는 컨텍스트가 자주 끊기는 장기 세션이다. Anthropic SDK 블로그가 강조하는 ‘자동 컴팩션’과 ‘컨텍스트 격리’의 가치를 OMC가 별도 설계 없이 제공한다. 각 서브에이전트가 자체 컨텍스트 윈도우를 유지하고 관련 정보만 오케스트레이터에 반환하므로, 메인 세션의 컨텍스트가 빠르게 소진되는 문제를 우회한다.

세 번째는 계획 집약적 작업이다. 아키텍처 변경, 데이터 모델 재설계, 보안 정책 재구성처럼 ‘계획→실행→검증→수정’ 사이클이 여러 번 도는 작업에서 Ralph와 Pipeline 모드가 사용자 개입을 줄인다.

반대로 가치가 제한적인 경우도 솔직히 짚어야 한다. 단일 파일의 짧은 기능 추가, 1회성 스크립트 작성, 실험적 프로토타이핑처럼 한 에이전트로 충분한 작업은 일반 Claude Code 세션이 더 가볍고 직관적이다. OMC가 작은 작업에 오버킬이 되는 순간을 인지하는 것도 중요하다.

도입 전 짚어야 할 4가지 리스크

기술 자체가 좋다고 그냥 깔면 되는 건 아니다. enterprise 도입을 고민한다면 네 가지 리스크는 미리 점검해야 한다.

가장 먼저 보안과 거버넌스다. Anthropic 공식 문서는 “플러그인과 마켓플레이스는 사용자 권한으로 임의 코드를 실행할 수 있는 고도로 신뢰된 컴포넌트”라고 경고한다. OMC는 MIT 라이선스 오픈소스로 코드가 공개되어 있긴 하지만 커뮤니티 프로젝트(메인테이너 Yeachan-Heo)다. enterprise 도입이라면 소스 코드 정기 리뷰, private fork 운영으로 자동 업데이트 제어, OMC_SKIP_HOOKS 환경 변수로 위험도 높은 훅 선별 차단, DISABLE_OMC로 전체 비활성화 옵션 같은 거버넌스 장치를 정책에 포함시키는 게 합리적이다.

호환성과 플랫폼 한계도 짚어야 한다. REFERENCE.md는 “OMC requires tmux, which is not available on native Windows”라고 명시한다. Windows 사용자는 WSL2가 필수다. VentureBeat가 Claude Code 데스크톱 앱을 테스트하면서 일부 서드파티 플러그인이 터미널이나 메인 뷰에서 표시되지 않는 문제를 보고하기도 했다. 데스크톱과 CLI 환경별 호환성은 사전 검증이 필요하다.

비용 모니터링은 더 실무적인 이슈다. OMC 자체는 무료지만 모델 호출은 사용자의 Claude Max/Pro 한도나 Anthropic API 청구에서 차감된다. 특히 Ultrawork 모드의 5개 병렬 워커는 단일 세션 대비 모델 사용량이 크게 증가한다. 스마트 모델 라우팅(Haiku/Sonnet/Opus)이 비용을 낮춰주지만 워크로드가 커지면 월간 사용량 모니터링이 따라가야 한다. CLI의 omc hud와 omc session search를 비용 추적 도구로 활용할 수 있다.

마지막은 성능 주장 검증이다. 공식 홈페이지는 ‘3-5× 빠른 출시’와 ’30-50% 토큰 절감’을 내세운다. 그런데 이 수치는 OMC 측 자체 마케팅 수치이며 SWE-Bench-Pro 같은 표준 벤치마크의 독립 검증은 공개되지 않았다. 솔직히 이 부분은 자체 워크로드의 파일럿 없이 그대로 믿을 근거가 약하다. 팀의 실제 리팩토링 작업 한 주치를 Claude Code 단독 모드와 OMC 모드로 각각 처리해 처리 시간과 토큰 사용량을 비교해보는 게 합리적이다.

어디서부터 시작하면 좋을까

도입을 진지하게 고민한다면 단계적으로 접근하는 게 낫다. 한 번에 5개 모드를 다 익히려 들면 학습 곡선이 가파르다.

오늘 안에 할 일은 개인 계정에 설치하고 작은 사이드 프로젝트에서 /autopilot을 한 번 실행해보는 것이다. 30분이면 충분하다.

이번 주 안에 할 일은 /deep-interview + /ralplan + /team의 계획-실행 분리 플로우를 한 차례 거쳐본 뒤, 가장 자주 발생하는 ‘다중 파일 리팩토링’ 작업 한 건을 /ultrawork로 처리해 시간과 토큰을 측정하는 것이다.

이번 달 안에 할 일은 enterprise 도입이 목표라면 private fork를 만들어 자동 업데이트를 제어하고, OMC_SKIP_HOOKS와 DISABLE_OMC 정책, 비용 모니터링 대시보드를 거버넌스 문서에 포함시키는 것이다. 같은 기간 동안 자체 워크로드에서 ‘3-5× 속도, 30-50% 토큰 절감’ 주장이 재현되는지 한 주 단위로 기록하면 된다.

OMC는 Claude Code의 단일 에이전트 한계를 가장 종합적으로 추상화한 서드파티 멀티 에이전트 오케스트레이션 레이어다. Anthropic 공식 마켓플레이스 claude-plugins-official(외부 서비스 통합·LSP·워크플로우 큐레이션)과는 경쟁이 아니라 직교 관계이며 동시에 활성화도 가능하다. 공식 인프라가 정비될수록 OMC 같은 서드파티가 더 빠르게 확산될 위치에 있다.

한 가지 확실한 건, ‘Claude Code를 단일 에이전트로만 써본 사용자’와 ‘팀 단위로 굴려본 사용자’의 생산성 격차가 점점 벌어지고 있다는 점이다. Claude Max 구독이 이미 있다면 오늘 저녁에 30분만 투자해 /autopilot 한 번 돌려보길 추천한다. 그 다음 결정은 자체 워크로드 파일럿이 알려줄 것이다.

자주 묻는 질문

Q1. OMC는 Anthropic 공식 도구인가?

아니다. OMC는 Yeachan-Heo가 메인테이너인 MIT 라이선스 커뮤니티 프로젝트다. 다만 Anthropic이 공식 발표한 플러그인 마켓플레이스 인프라 위에서 표준적인 방식으로 설치·운영된다.

Q2. 설치에 필요한 최소 요건은?

세 가지다. Claude Code CLI 설치, Claude Max/Pro 구독 또는 ANTHROPIC_API_KEY 환경 변수, omc team 같은 tmux 기반 CLI 기능을 쓰려면 tmux. Windows 사용자는 WSL2 권장이다.

Q3. 비용은 얼마인가?

OMC 자체는 무료(MIT)다. 모델 호출 비용은 사용자의 Claude Max/Pro 한도 또는 Anthropic API에서 차감된다. 스마트 모델 라우팅으로 비용을 낮추지만 워크로드 규모에 따라 모니터링이 필요하다.

Q4. ‘3-5× 빠르고 30-50% 저렴하다’는 수치는 믿을 만한가?

OMC 측 자체 마케팅 수치이며 표준 벤치마크의 독립 검증은 공개되지 않았다. 자체 워크로드에서 파일럿으로 검증해야 한다.

Q5. 어떤 모드부터 써봐야 하나?

Autopilot으로 단일 작업 체감 → Ultrawork로 다중 파일 리팩토링 → Team으로 역할 분담 → Ralph로 검증 루프 자동화 → Pipeline으로 정형 프로세스 순서가 무난하다.

참고 자료

Anthropic 공식

OMC 1차 출처

[인물] oh-my-claudecode – Teams-first Multi-agent orchestration for Claude Code
출처: oh-my-claudecode – Ship 3× Faster with a Team of AI Agents