oh-my-claudecode(OMC) 6개월 사용 후기 — 도움 된 곳·안 된 곳·vanilla로 충분한 곳
OMC(oh-my-claudecode) v4.x를 Jekyll 콘텐츠 파이프라인에 6개월간 적용한 사용자 시각 후기. 도움된 영역·사용자 환경 미스매치 영역·vanilla Claude Code로 충분한 영역·OMC가 필수인 영역을 비교표·호출 예시·Mermaid 의사결정 다이어그램으로 정리한다.
이 글의 범위
이 글은 Jekyll 정적 블로그 콘텐츠 파이프라인을 운용하는 단일 사용자 관점에서 oh-my-claudecode(OMC) v4.x를 6개월간 사용한 경험을 정리한다.12 코드베이스 규모나 팀 구조가 다른 환경에서는 결론이 달라질 수 있다.
이 블로그의 파이프라인은 다음과 같다: GitHub Issues에 포스트 명세 작성 → AQ(AI-Quartermaster) 봇이 이슈를 읽고 Phase를 생성 → Claude Code + OMC가 worktree에서 포스트를 작성 → PR로 머지. 비교적 반복성이 높고 파일 수가 적은 워크플로우다.
이 리뷰는 “OMC가 좋다/나쁘다”를 판정하는 것이 아니다. 어떤 환경에서 효과적이고, 어떤 환경에서는 vanilla Claude Code로 충분한지를 사용자 경험 기준으로 정리하는 것이 목적이다.
1. OMC란 무엇인가 — v4.x 아키텍처 개요
oh-my-claudecode는 Claude Code 위에 올라가는 멀티에이전트 오케스트레이션 레이어다.1 Claude Code가 제공하는 기본 에이전트 기능(Agent 도구, Skills, Hooks)을 그대로 쓰되, 다음 세 가지를 추가로 제공한다.
- Tier-0 워크플로우 —
autopilot,ralph,ultrawork,team,ralplan등 사전 정의된 고수준 실행 모드 - 트리거 키워드 매핑 — “ralph”, “ulw”, “autopilot” 등의 자연어 키워드를 자동으로 해당 스킬로 라우팅
- 상태 관리 인프라 —
.omc/state/,.omc/notepad.md,.omc/plans/등 세션 간 영속 상태
v4.x에서 특히 눈에 띄는 변경:
ralplan— ralph/autopilot 앞에 계획 검증 게이트를 삽입. 모호한 요청을 실행 전에 인터뷰로 구체화ultrawork— 독립 태스크를 병렬 에이전트로 분산 처리team— N개의 조율된 에이전트가 공유 태스크 목록에서 협력 실행
vanilla Claude Code와의 핵심 차이점:
| 항목 | vanilla Claude Code | OMC (v4.x) |
|---|---|---|
| 에이전트 라우팅 | 사용자가 직접 Agent 도구 호출 | 키워드 트리거로 자동 라우팅 |
| 병렬 실행 추상화 | 수동 다중 Agent 호출 | ultrawork / team으로 추상화 |
| 계획 검증 게이트 | 없음 (사용자가 CLAUDE.md에 명시) | ralplan이 실행 전 인터뷰 진행 |
| 세션 간 상태 | CLAUDE.md + auto-memory만 | .omc/state/, notepad, plans |
| 스킬 트리거 | /skill-name 명시 호출만 | 키워드 자동 감지 + 명시 호출 병행 |
| 추가 비용 | 기본 Claude Code 비용만 | 스킬 오버헤드 + 추가 에이전트 토큰 |
2. 도움된 영역
2-1. 멀티파일 일괄 변환
이 블로그에서 효과가 가장 컸던 사례는 29편 포스트의 카테고리·태그 일괄 정규화였다. 파일 수가 많고, 각 파일에서 독립적으로 같은 패턴 변환이 필요하며, 검증까지 자동화하고 싶은 상황 — ultrawork 패턴이 잘 맞는 경우다.
1
2
3
/oh-my-claudecode:ultrawork
29개 포스트의 categories/tags를 CLAUDE.md 컨벤션에 맞게 일괄 정규화하세요.
각 파일은 독립적으로 처리 가능합니다.
ultrawork는 각 파일을 독립 에이전트에 배분하고 결과를 취합한다. 수작업으로 했다면 30분 이상 걸렸을 작업이 병렬로 처리됐다.
2-2. 반복 검증 루프
콘텐츠 파이프라인에서 “날짜 형식 일관성 검증 후 수정”처럼 검증 → 수정 → 재검증 사이클이 필요한 태스크에 ralph가 유용했다.
1
2
3
/oh-my-claudecode:ralph
_posts/ 내 모든 포스트의 date 필드가 +0900 오프셋을 포함하는지 검증하고,
누락된 파일만 수정한 뒤 커밋하세요.
ralph는 완료 조건에 도달할 때까지 루프를 유지하며 사용자 개입 없이 반복한다. vanilla에서 같은 작업을 하려면 매 사이클마다 결과를 확인하고 다음 단계를 지시해야 한다.
2-3. 불명확한 요구사항의 구조화
이슈 명세가 모호하거나 Phase 분해가 복잡한 경우, ralplan이 실행 전에 인터뷰를 진행해 범위를 구체화했다. 첫 시도 성공률이 높아지고 재작업이 줄었다. 특히 “어디서부터 시작해야 할지 모르는” 대규모 리팩토링 요청에서 효과적이었다.
3. 미스매치 영역 — 사용자 환경 관점
3-1. 단일 파일 생성 태스크에서의 오버헤드
이 블로그의 포스트 작성 Phase는 대부분 단일 .md 파일 생성이다. 이 경우 OMC의 스킬 트리거·상태 관리 레이어가 추가 컨텍스트 비용을 발생시키는 반면, 실제 이점은 크지 않다. vanilla Claude Code에서 Write 도구로 직접 파일을 생성하는 것과 결과 품질 차이가 없다.
이것은 OMC의 결함이 아니라 파이프라인 유형의 미스매치다. OMC가 설계된 핵심 유스케이스(대규모 코드베이스, 팀 워크플로우, 복잡한 의존성)와 “포스트 한 편 쓰기”는 태스크 특성이 다르다.
3-2. 이슈별 worktree 환경에서의 상태 단절
OMC의 .omc/state/와 notepad는 저장소 루트를 기준으로 동작한다. 이 블로그처럼 이슈마다 별도 worktree를 생성하는 경우, 각 worktree가 독립적인 상태 공간을 갖게 되어 세션 간 컨텍스트 공유가 원활하지 않다.
메인 브랜치에서 축적된 project-memory나 notepad가 이슈 worktree에서는 보이지 않거나, worktree의 .omc/ 변경이 메인으로 전파되어야 하는 상황이 발생한다. vanilla Claude Code + CLAUDE.md 조합이 이 환경에서는 더 단순하게 동작한다.
3-3. 짧은 태스크에서의 훅 메시지 밀도
OMC의 훅이 PreToolUse, PostToolUse 등 다양한 시점에 메시지를 주입하면, 단순한 단발 태스크에서는 시스템 메시지 비율이 실제 작업 메시지 비율을 넘어서는 경우가 생긴다. 훅 트리거 조건을 세밀하게 설정하면 완화할 수 있지만, 초기 설정 비용이 따른다.
4. vanilla Claude Code로 충분한 영역
다음 조건을 모두 만족하면 vanilla Claude Code로 충분하다:
- 단일 파일 또는 2~3개 파일 변경
- 반복 패턴이 없는 일회성 태스크
- 검증 루프가 1~2회로 충분한 작업
- 팀 협업이 없는 솔로 워크플로우
이 블로그 콘텐츠 파이프라인의 70% 이상이 이 범주다. 개별 포스트 초안 작성, 단발 교정, 설정 파일 1개 수정 — 이 작업들에 OMC를 올리면 오버헤드가 이득을 압도한다.
vanilla Claude Code도 Skills, Hooks, CLAUDE.md를 모두 지원한다. OMC 없이도 상당한 자동화가 가능하다. Claude Code Skills 시스템 2026 포스트에서 vanilla Skills의
context: fork나disable-model-invocation같은 필드만으로도 많은 시나리오를 커버할 수 있음을 확인했다.
vanilla에서 먼저 시도할 수 있는 자동화 기법은 Claude Code Hooks 완전 가이드와 Claude Code MCP 서버 가이드에 정리해뒀다. OMC를 고려하기 전에 이 두 레이어를 먼저 활용해보길 권한다.3
5. OMC가 필수인 영역
5-1. N개 독립 태스크의 병렬 처리
vanilla Claude Code에서 병렬 에이전트를 실행하려면 Agent 도구를 수동으로 여러 번 호출해야 한다. OMC의 ultrawork는 태스크 목록을 받아 자동으로 에이전트를 분산하고 완료 조건을 집계한다. 파일 수가 10개를 넘거나 독립 태스크가 5개 이상인 경우 수작업 오케스트레이션 비용이 빠르게 커진다.
1
2
3
4
5
6
7
/oh-my-claudecode:team
다음 5개 포스트를 동시에 작성하세요. 각 포스트는 독립적입니다.
- 2026-07-01-topic-a.md
- 2026-07-02-topic-b.md
- 2026-07-03-topic-c.md
- 2026-07-04-topic-d.md
- 2026-07-05-topic-e.md
5-2. 검증 루프가 긴 태스크
빌드 → 테스트 → 수정 → 재빌드 사이클이 3회 이상 반복될 가능성이 있는 태스크는 ralph가 적합하다. ralph는 사용자 개입 없이 완료 조건에 도달할 때까지 루프를 유지한다. 이 패턴을 vanilla로 구현하면 매 사이클마다 사용자가 결과를 확인하고 다음 단계를 지시해야 한다.
5-3. 대규모 코드베이스에서 탐색 + 수정 복합
Claude Code 서브에이전트 설계 패턴에서 다룬 Orchestrator-Worker 패턴은 코드베이스가 크고 탐색(Explore)과 수정(Executor)을 분리해야 할 때 OMC의 planner + executor 라우팅이 자연스럽게 동작한다. 단일 에이전트가 대규모 코드베이스를 탐색하면서 동시에 수정하면 컨텍스트가 오염되기 쉽다. 바이브 코딩 피로에서 다룬 Agentic Fatigue 를 줄이는 핵심 패턴이기도 하다.
6. v4.14.0 — ultragoal 기능 예고
현재 OMC 최신 배포 버전은 v4.13.6이며, v4.14.0이 준비 중이다.4 v4.14.0에서 주목하는 기능은 ultragoal — 장기 목표를 정의하고 세션이 끊겨도 목표를 향한 진행 상태를 유지하는 워크플로우다.
현재 ralph/autopilot는 단일 세션 내에서 루프를 유지한다. 세션이 컴팩션되거나 새 세션으로 시작하면 루프가 초기화된다. ultragoal은 .omc/state/에 목표 상태를 저장하여 세션 간 목표 연속성을 제공할 것으로 예상된다.
콘텐츠 파이프라인 관점에서 기대 포인트: “이 마일스톤 내 30편 포스트 완료”를 ultragoal로 설정하면, 각 이슈 worktree 세션이 전체 목표를 인식하면서 작업할 수 있다. 현재는 이 연속성이 없어서 이슈 단위로 컨텍스트가 단절된다. ultragoal이 이 미스매치를 줄여줄 수 있을지 관심 있게 보고 있다.
ultragoal은 아직 배포 전 기능이므로 실제 동작은 달라질 수 있다.
7. 6개월 후 도입 기준 — 의사결정 매트릭스
6개월의 경험에서 도출한 OMC 도입 판단 기준이다. 아래 플로우차트를 따라가면 어느 레이어가 적합한지 판단할 수 있다.
flowchart TD
A[태스크 시작] --> B{변경 파일 수?}
B -- "1~3개" --> C{반복 패턴 있음?}
B -- "4~9개" --> D{태스크 간 독립?}
B -- "10개+" --> G[OMC ultrawork 권장]
C -- 아니오 --> V1[vanilla 충분]
C -- 예 --> E{검증 루프 3회 이상?}
D -- 아니오 --> F{검증 루프 3회 이상?}
D -- 예 --> G
E -- 아니오 --> V2[vanilla Skills + Hooks]
E -- 예 --> H[OMC ralph 권장]
F -- 아니오 --> V3[vanilla + CLAUDE.md]
F -- 예 --> H
G --> I{팀 협업 필요?}
I -- 예 --> J[OMC team 권장]
I -- 아니오 --> K[OMC ultrawork / autopilot]
style V1 fill:#69db7c,color:#1a1a1a
style V2 fill:#69db7c,color:#1a1a1a
style V3 fill:#69db7c,color:#1a1a1a
style H fill:#4dabf7,color:#1a1a1a
style G fill:#4dabf7,color:#1a1a1a
style J fill:#cc5de8,color:#fff
style K fill:#4dabf7,color:#1a1a1a
판단 기준 요약:
| 상황 | 권장 레이어 |
|---|---|
| 파일 1~3개, 비반복 일회성 | vanilla Claude Code |
| 파일 1~3개, 반복 패턴, 루프 짧음 | vanilla Skills + Hooks |
| 파일 1~3개, 반복 패턴, 루프 김 | OMC ralph |
| 파일 4~9개, 독립 태스크 | OMC ultrawork |
| 파일 10개+, 독립 태스크 | OMC ultrawork (사실상 필수) |
| 팀 협업 필요 | OMC team |
| 탐색 + 수정 복합, 불명확한 요구사항 | OMC ralplan + executor |
vanilla Claude Code의 Skills/Hooks/CLAUDE.md 조합을 먼저 소진한 뒤 OMC를 올리는 것이 권장 순서다. OMC는 비용과 복잡성을 함께 올리므로, 그 비용을 정당화할 만한 태스크에서 도입하는 것이 효과적이다.
맺음말
6개월간 OMC를 콘텐츠 파이프라인에 올려놓고 얻은 핵심 결론은 두 가지다.
OMC는 오케스트레이션 레이어다. vanilla Claude Code를 대체하는 것이 아니라, vanilla가 이미 제공하는 기능 위에 멀티에이전트 조율과 세션 상태 관리를 얹는다. vanilla의 한계에 부딪히기 전에 OMC를 먼저 도입할 이유는 없다.
파이프라인 유형이 결정적이다. 반복성 높고 파일 수 많은 코드베이스에서 OMC의 이점이 극대화된다. 단일 파일 생성이 주를 이루는 콘텐츠 파이프라인은 vanilla가 더 단순하고 비용 효율적이다. 이것은 OMC의 한계가 아니라, 사용 환경이 OMC의 핵심 유스케이스와 어긋난 것이다.
참고
관련 포스트
- Claude Code Skills 시스템 2026 — vanilla Skills의
context: fork·frontmatter 완전 정리 - Claude Code 서브에이전트 설계 패턴 — Orchestrator-Worker·Reviewer-Verifier 패턴
- Claude Code Hooks 완전 가이드 — 라이프사이클 이벤트와 settings.json 구조
- Claude Code MCP 서버 가이드 — vanilla 확장 레이어로서의 MCP
- 바이브 코딩 피로(Vibe Coding Fatigue) — AI 에이전트 과잉 도입의 부작용
Yeachan Heo, oh-my-claudecode GitHub 저장소. https://github.com/Yeachan-Heo/oh-my-claudecode. “Teams-first Multi-agent orchestration for Claude Code” 자기 정의. ↩︎ ↩︎2
oh-my-claudecode 공식 사이트. https://ohmyclaudecode.com/. “Ship 3× Faster with a Team of AI Agents” 슬로건. ↩︎
Anthropic, “Extend Claude with skills” 공식 문서. https://code.claude.com/docs/en/skills. vanilla Claude Code Skills 시스템 명세 — OMC 추가 레이어와 역할 분리 기준. ↩︎
oh-my-claudecode 릴리스 페이지. https://github.com/Yeachan-Heo/oh-my-claudecode/releases. v4.14.0(2026)의 Durable Multi-Goal Workflow
omc ultragoal도입 등. ↩︎