oh-my-claudecode 가이드

OMC란?

oh-my-claudecode는 Claude Code를 위한 다중 에이전트 오케스트레이션 시스템입니다. 명시적 명령어 대신 자연어와 매직 키워드를 사용하여 복잡한 작업을 자동으로 처리합니다.

핵심 철학

"명령어를 배울 필요가 없다!" - 자연스럽게 말하면 OMC가 자동으로 최적의 에이전트와 모드를 선택합니다.

SuperClaude vs OMC

SuperClaude

명시적 명령어: /sc:analyze
플래그 기반: --think-hard
구조화된 워크플로우
학습 곡선이 있음

oh-my-claudecode

자연어: "ralph: 버그 다 고쳐줘"
매직 키워드 기반
자동 에이전트 선택
즉시 사용 가능

둘 다 사용 가능!

SuperClaude와 OMC는 함께 설치하여 사용할 수 있습니다. 상황에 따라 편한 방식을 선택하세요.

설치 방법

npm 패키지 설치

npm install -g oh-my-claude-sisyphus

스킬 복사

                        # 스킬 디렉토리로 복사

                        cp -r /usr/local/lib/node_modules/oh-my-claude-sisyphus/skills/* ~/.claude/skills/

Hooks 설정 (settings.json에 추가)

// ~/.claude/settings.json
{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node /usr/local/lib/node_modules/oh-my-claude-sisyphus/scripts/keyword-detector.mjs",
            "timeout": 5000
          },
          {
            "type": "command",
            "command": "node /usr/local/lib/node_modules/oh-my-claude-sisyphus/scripts/skill-injector.mjs",
            "timeout": 3000
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node /usr/local/lib/node_modules/oh-my-claude-sisyphus/scripts/session-start.mjs",
            "timeout": 5000
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node /usr/local/lib/node_modules/oh-my-claude-sisyphus/scripts/persistent-mode.mjs",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}
                    

Claude Code 재시작

새 세션을 시작하면 OMC가 자동으로 활성화됩니다.

주의사항

hooks 설정 후 반드시 새 Claude Code 세션을 시작해야 적용됩니다.

매직 키워드

자연어 문장에 키워드를 포함하면 해당 모드가 자동 활성화됩니다:

키워드	효과	사용 예시
ralph	완료까지 지속 실행	"ralph: 모든 테스트 통과시켜줘"
ralplan	반복적 계획 수립	"ralplan 새 기능 설계해줘"
ulw	최대 병렬 처리	"ulw API 전체 리팩토링"
plan	계획 인터뷰 시작	"plan 인증 시스템 구축"
stop / cancel	현재 작업 중지	"stop" 또는 "cancel"

키워드 조합

"ralph ulw: 데이터베이스 마이그레이션" - 지속 모드 + 최대 병렬 처리

주요 스킬 (36개)

🔄

/ralph

지속 실행 모드

🚀

/ultrawork

최대 병렬 처리

🤖

/autopilot

완전 자동 실행

🐝

/swarm

다중 에이전트 협업

📋

/plan

계획 인터뷰

🔍

/analyze

심층 분석

🔬

/research

병렬 리서치

🛡️

/security-review

보안 검토

📝

/code-review

코드 리뷰

🧪

/tdd

테스트 주도 개발

🎨

/frontend-ui-ux

UI/UX 설계

🔧

/build-fix

빌드 오류 수정

전체 스킬 목록

analyze, autopilot, build-fix, cancel, code-review, deepinit, deepsearch,
doctor, ecomode, frontend-ui-ux, git-master, help, hud, learn-about-omc,
learner, local-skills-setup, mcp-setup, note, omc-setup, orchestrate,
pipeline, plan, project-session-manager, ralph, ralph-init, ralplan,
release, research, review, security-review, skill, swarm, tdd,
ultrapilot, ultraqa, ultrawork
                

에이전트 시스템 (32개)

OMC는 작업에 따라 최적의 에이전트를 자동 선택합니다:

에이전트	역할	변형
Architect	시스템 설계 및 아키텍처	low, medium, high
Planner	작업 계획 수립	standard
Executor	실제 코드 실행	low, standard, high
Explorer	코드베이스 탐색	standard, medium, high
Scientist	심층 연구 및 분석	low, standard, high
Designer	UI/UX 설계	low, standard, high
Code Reviewer	코드 품질 검토	low, standard
Security Reviewer	보안 취약점 분석	low, standard
Build Fixer	빌드 오류 해결	low, standard
QA Tester	품질 보증 테스트	standard, high
Critic	계획/코드 비평	standard
Writer	문서 작성	standard

자동 행동

OMC는 상황에 따라 자동으로 최적의 행동을 선택합니다:

상황	자동 행동
복잡한 작업 요청	병렬화 및 전문 에이전트에 위임
계획 요청	계획 인터뷰 시작
완료 요청	검증될 때까지 지속 실행
UI/프론트엔드 작업	디자인 감각 활성화
"stop" / "cancel"	현재 작업 지능적 중단

사용 예시

기본 사용

1. 버그 수정 (지속 모드)

# 모든 버그를 찾아서 수정할 때까지 계속
ralph: 이 프로젝트의 모든 테스트를 통과시켜줘
                

→ 테스트 실패 → 수정 → 재실행 → 성공할 때까지 반복

2. 대규모 리팩토링 (병렬 처리)

# 여러 에이전트가 동시에 작업
ulw 전체 API 레이어를 TypeScript로 마이그레이션해줘
                

→ 여러 파일을 동시에 변환, 타입 정의 자동 생성

3. 기능 설계 (계획 인터뷰)

# 단계별 질문을 통해 요구사항 명확화
plan 사용자 인증 시스템을 처음부터 구축하고 싶어
                

→ "어떤 인증 방식?" → "소셜 로그인 필요?" → "세션 vs JWT?" 등 질문

4. 복합 모드 (지속 + 병렬)

# 지속 + 병렬 조합
ralph ulw: 레거시 코드를 현대적인 패턴으로 전환하고
테스트 커버리지 80% 이상 달성해줘
                

→ 병렬로 리팩토링하면서, 커버리지 목표 달성까지 지속

개발 워크플로우

5. 새 프로젝트 시작

# 프로젝트 구조부터 기본 설정까지 자동 생성
autopilot: Next.js 14 + TypeScript + Tailwind 프로젝트 만들어줘
ESLint, Prettier, Husky도 설정하고 기본 레이아웃까지 구현해줘
                

6. 코드 리뷰 및 개선

# 코드 품질 분석 후 자동 개선
ralph: src/components 폴더의 모든 컴포넌트를 리뷰하고
발견된 문제점을 직접 수정해줘
                

7. TDD 방식 개발

# 테스트 먼저 작성 후 구현
/tdd 장바구니 기능을 만들어줘
- 상품 추가/삭제
- 수량 변경
- 총 금액 계산
                

8. 보안 점검

# 보안 취약점 검사 및 수정
/security-review 이 프로젝트의 보안 취약점을 찾아서
OWASP Top 10 기준으로 리포트해줘
                

복잡한 작업

9. 다중 에이전트 협업 (Swarm)

# 여러 전문 에이전트가 협력
/swarm 이커머스 사이트의 결제 모듈을 구현해줘
- 아키텍트: 시스템 설계
- 개발자: 코드 구현
- 테스터: 테스트 작성
- 보안전문가: 취약점 점검
                

10. 반복적 계획 수립 (Ralplan)

# Planner, Architect, Critic이 합의할 때까지 반복
ralplan: 마이크로서비스 아키텍처로 전환하는 계획을 세워줘
현재 모놀리식 구조에서 단계적으로 분리하고 싶어
                

→ 계획 수립 → 비평 → 수정 → 재검토 → 합의까지 반복

11. 심층 연구 (Research)

# 병렬 리서치 에이전트 활용
/research 2024-2025년 가장 효과적인 React 상태관리 라이브러리 비교해줘
- 성능 벤치마크
- 번들 사이즈
- 학습 곡선
- 커뮤니티 활성도
                

12. 프론트엔드 UI/UX 구현

# 디자인 감각이 활성화된 에이전트
/frontend-ui-ux 대시보드 페이지를 만들어줘
- 다크모드 지원
- 반응형 레이아웃
- 차트와 통계 카드
- 모던한 그라데이션 스타일
                

운영 및 유지보수

13. 빌드 오류 수정

# 빌드 에러 자동 해결
/build-fix TypeScript 빌드 에러 전부 고쳐줘
                

→ 타입 에러, 누락된 import, 호환성 문제 등 자동 수정

14. 코드베이스 탐색

# 프로젝트 구조 파악
/deepsearch 이 프로젝트에서 사용자 인증 관련 코드가 어디있어?
로그인, 세션, 토큰 관련 모든 파일 찾아줘
                

15. Git 작업

# 스마트한 커밋 메시지 및 브랜치 관리
/git-master 현재 변경사항을 feature 브랜치로 분리하고
의미있는 커밋 단위로 나눠서 커밋해줘
                

16. 문서화

# API 문서 자동 생성
ralph: src/api 폴더의 모든 엔드포인트에 대해
JSDoc 주석과 README 문서를 작성해줘
                

자연어로 그냥 말하기

17. 키워드 없이 자연스럽게

# OMC가 자동으로 적절한 모드 선택
이 버그 좀 고쳐줘. 로그인하면 세션이 유지가 안 돼

# 복잡한 작업은 자동으로 병렬화
이 프로젝트 전체적으로 코드 품질 개선해줘

# 계획이 필요한 작업은 자동으로 인터뷰
결제 시스템을 처음부터 구축하고 싶어
                

→ OMC가 작업 복잡도를 분석하여 자동으로 적절한 에이전트와 모드 선택

팁: 명시적 vs 자동

명시적 키워드: 특정 모드를 강제하고 싶을 때 (예: ralph:)
자동 선택: 그냥 자연어로 말하면 OMC가 알아서 판단

문제 해결

스킬이 인식되지 않는 경우

# 스킬 디렉토리 확인
ls ~/.claude/skills/

# 스킬이 없으면 다시 복사
cp -r /usr/local/lib/node_modules/oh-my-claude-sisyphus/skills/* ~/.claude/skills/
                

Hooks가 동작하지 않는 경우

# settings.json 확인
cat ~/.claude/settings.json | jq '.hooks'

# 스크립트 실행 테스트
node /usr/local/lib/node_modules/oh-my-claude-sisyphus/scripts/keyword-detector.mjs
                

OMC 버전 확인

npm list -g oh-my-claude-sisyphus

참고 자료

GitHub 저장소 - 소스 코드 및 이슈
npm 패키지 - 설치 및 버전 정보