[AI] Oh My Claude Code (omc) 이해하기

oh my claude code의 컨셉

• "설계/실행/QA/검증"을 적절한 모델로 알아서 잘 하게끔 AI한테 쉽게 명령어하는 것

Multi-agent orchestration for Claude Code. Zero learning curve.

• 여러가지의 agent들을 지휘하며, 하나의 곡을 완성한다는 의미로 orchestration이라고 함
• oh my claude code의 역할
  • oh my claude code 없이 내가 새롭게 구현하려는 기능이 있을때, claude code에게 "기능을 구현해줘" 한 후 "테스트 해줘"라고 두 번 말해야 함
  • oh my claude code를 사용한다면, ralph모드를 사용하여 새로운 기능을 구현해주고 동시에 테스트까지 해주고, 복잡한 로직은 opus, 쉬운 작업은 haiku를 알아서 사용함

 ╔══════════════════════════════════════════════╗
 ║                                              ║
 ║    🎵  OH MY CLAUDE CODE  🎵                ║
 ║                                              ║
 ║   ┌─────────┐                                ║
 ║   │CONDUCTOR│  ──→  🎻 architect (Opus)     ║
 ║   │ (Claude) │  ──→  🎸 executor (Sonnet)   ║
 ║   │         │  ──→  🥁 designer (Sonnet)    ║
 ║   │    🎹   │  ──→  🎺 debugger (Sonnet)   ║
 ║   └─────────┘  ──→  🪈 explore (Haiku)     ║
 ║                                              ║
 ║   "1명의 AI → 28인 전문가 팀으로"            ║
 ║                                              ║
 ╚══════════════════════════════════════════════╝

agents들의 메모리 공유 방식

• oh my claude code를 사용하면 여러 agent들이 동시에 동작하는데, 내부적으로 효율적인 메모리 공유의 전략이 있음
• 메모리 공유 두 가지
  • 모든 메모리가 공유되는 중앙 상태 관리: 현재 작업의 진행 상황, 발견된 버그, 수정된 파일 목록 등을 중앙에서 관리
  • 공유 파일 (CLAUDE.md / MEMORY.md): 프로젝트의 전역 규칙(코딩 컨벤션, 아키텍처)을 모든 에이전트가 공유함
  • Auto-Memory: 에이전트가 작업을 수행하며 새로 알게 된 사실(예: "이 프로젝트는 커스텀 에러 핸들러를 씀")을 ~/.claude/projects/.../memory/에 기록하고, 다른 에이전트가 이를 참조
  • 컨텍스트 격리: 하위 에이전트가 수천 줄의 로그나 파일을 읽어도, 그 상세 내용은 메인 에이전트의 대화창을 오염시키지 않고 에이전트는 요약된 결과물만 메인에게 전달

병렬 처리

• oh my claude code에서 /ultrawork 하여 사용
• 아래와 같은 3가지 방법을 사용
• 1. 분산 워커 프로세스 (Worker Processes)
  • 메인 에이전트가 작업을 쪼개면, 각 작업은 별도의 자식 프로세스에서 독립적으로 돌아감
  • 이점: 한 에이전트가 무거운 연산을 해도 메인 인터페이스가 멈추지 않고, 각 프로세스는 할당된 메모리 범위 내에서만 자원을 사용함
• 2. 지능형 모델 라우팅
  • 모든 작업에 비싼 모델(Claude 3.5 Sonnet 등)을 쓰지 않음
  • 단순 파일 탐색은 가벼운 모델에게 맡기고, 복잡한 추론만 메인 모델이 처리하여 메모리 점유율과 비용을 동시에 최적화
• 3. 토큰 절약 모드
  • 병렬 작업 시 중복되는 컨텍스트를 제거하고 여러 에이전트가 동일한 라이브러리 문서를 읽어야 한다면, 이를 캐싱하거나 공통 참조 포인트로 연결해 토큰 소비를 30~50% 줄임

* 참고

- https://memoryhub.tistory.com/entry/%F0%9F%8E%BC-Oh-My-Claude-Code-%EC%95%84%ED%82%A4%ED%85%8D%EC%B2%98%EB%B6%80%ED%84%B0-%EC%8B%A4%EC%A0%84%EA%B9%8C%EC%A7%80-%EC%99%84%EC%A0%84-%ED%95%B4%EB%B6%80

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