[AI] oh-my-claude code 개념 (클로드코드, 클로드코드 플러그인, omc, oh my claude code)

oh-my-claude code란?

• = omc(oh my claude code)라고 지칭
• claude code를 위한 멀티 에이전트 오케스트레이션 플러그인
• 여러 명의 전문 AI 에이전트가 협업하여 복잡한 코딩 작업을 수행하도록 설계
• claude code의 market이라는 오픈소스 마켓에 존재

핵심 기능

 

• 32개의 전문 에이전트: 아키텍처 설계(Architect), 코드 실행(Executor), 디자인(Designer), 테스트(Tester), 보안 리뷰(Security) 등 역할이 세분화된 에이전트들이 협업
• 자동 위임: 사용자가 명령을 내리면 시스템이 작업의 성격에 맞는 최적의 에이전트를 자동으로 선택하여 배정

 

설치 방법

• vscode에서 클로드코드를 쓰고 있다면 클로드코드 챗에서 manage plugins 진입
  • "/plugin" 입력

• manage plugins가 뜨면 Marketplaces 탭 클릭

• omc 레포 주소 입력 후 add 버튼 클릭

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

주의) 만약 xcode 관련 오류가 나오면 아래 명령어 실행

sudo xcodebuild -license accept

• 다시 Plugins 탭을 누르면 생성된 것을 확인 -> Install 버튼 클릭

• 설치와 활성화가 완료된것을 확인

 

주요 명령어

1. 자율 실행 모드 (Autonomous)

• /autopilot: 아이디어 제시부터 최종 코드 완성까지 전 과정 자율 수행
  • 예시: /autopilot 로그인 페이지에 소셜 로그인(Google, Apple) 기능을 추가해줘
• /ralph: 아키텍트 검증 기반의 반복 최적화 루프 실행
  • 예시: /ralph API 응답 시간을 50% 개선해줘. 프로파일링부터 최적화까지 진행해
• /ultrawork: 대규모 다중 작업을 병렬로 고속 처리
  • 예시: /ultrawork 모든 API 엔드포인트에 입력 검증 추가, 에러 핸들링 통일, 로깅 추가

2. 팀 및 병렬 실행 (Collaboration)

• /team: 역할이 분담된 여러 에이전트 간의 협업 수행
  • 예시: /team 프론트엔드 리팩토링과 백엔드 API 마이그레이션을 동시에 진행해줘
• /omc-teams: Claude, Codex, Gemini 등 이기종 모델을 tmux에서 동시 실행
  • 예시: /omc-teams claude로 테스트 작성, codex로 리팩토링, gemini로 문서 생성해줘
• /ccg: 3개 모델(Claude, Codex, Gemini)을 동시에 활용한 오케스트레이션
  • 예시: /ccg 사용자 대시보드 페이지를 만들어줘. 백엔드 API와 프론트 UI 모두 필요해

3. 계획 및 분석 (Planning)

• /plan: 복잡한 아키텍처 전환 등 전략적 실행 계획 수립
  • 예시: /plan 모놀리식 아키텍처를 마이크로서비스로 전환하려면 어떻게 해야 할까?
• /analyze: 메모리 누수 등 심층적인 코드 베이스 조사
  • 예시: /analyze 현재 프로젝트의 메모리 누수 원인을 찾아줘
• /ralph-init: 요구사항 명세서(PRD) 및 문서 초기화
  • 예시: /ralph-init 실시간 채팅 기능에 대한 요구사항 문서를 만들어줘

4. 코드 품질 및 검증 (Quality & QA)

• /code-review: 코드 품질 및 보안 취약점 종합 점검
  • 예시: /code-review 최근 커밋에서 변경된 파일들을 리뷰해줘
• /security-review: 보안 취약점 집중 리뷰
  • 예시: /security-review 인증/인가 관련 코드에 보안 취약점이 있는지 확인해줘
• /simplify: 복잡한 코드를 클린 코드로 리팩토링
  • 예시: /simplify 방금 작성한 코드를 더 깔끔하게 정리해줘
• /build-fix: 빌드 에러 및 TypeScript 타입 오류 자동 수정
  • 예시: /build-fix TypeScript 컴파일 에러 전부 고쳐줘
• /tdd: 테스트 주도 개발 기반 기능 구현
  • 예시: /tdd 장바구니 기능을 TDD 방식으로 구현해줘
• /ultraqa: 테스트 → 검증 → 수정을 성공할 때까지 무한 반복
  • 예시: /ultraqa 전체 테스트 스위트를 돌리고, 실패하는 것들을 모두 수정해줘

5. 유틸리티 및 설정 (Utility)

• /note: 세션이 종료되어도 유지되는 중요 정보 메모
  • 예시: /note DB 마이그레이션 시 반드시 백업 먼저 실행할 것
• /deepinit: 프로젝트 구조 분석 및 가이드 문서(AGENTS.md) 자동 생성
  • 예시: /deepinit 이 프로젝트의 구조를 분석하고 AGENTS.md를 생성해줘
• /skill: 에이전트의 로컬 스킬 관리 (list, add, remove)
  • 예시: /skill add # 새 스킬 추가
• /external-context: 외부 공식 문서 등 외부 컨텍스트 조회
  • 예시: /external-context SwiftUI의 최신 NavigationStack 사용법을 찾아줘
• /omc-setup / /omc-doctor: 환경 설정 및 설치 문제 진단
  • 예시: /omc-setup # 최초 설치 마법사 시작

---

✅ 권장 워크플로우

1. /omc-setup: 초기 환경 설정 수행
2. /plan: 구현 전 구체적인 작업 계획 수립
3. /autopilot: 세워진 계획에 따라 자율 구현 시작
4. /code-review: 최종 결과물의 품질 및 에러 확인

 

* 참고

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