oh‑my‑claudecode

그것은 무엇인가

• Claude Code(Anthropic의 코드 중심 LLM 어시스턴트) 위에 위치한 멀티 에이전트 오케스트레이션 도구입니다. 자연어 명령으로 REST API 구축, 코드 리뷰, 리팩토링과 같은 작업을 실행할 수 있습니다.
• 두 가지 표면을 제공합니다:
  1. 세션 내 슬래시 명령(/omc-setup … / /autopilot … / /team … …)을 Claude Code 채팅 창에 입력합니다.
  2. 터미널 기반 CLI(omc …)는 동일한 오케스트레이션 엔진과 통신하며 스크립트나 CI 파이프라인에서 사용할 수 있습니다.
• 이 프로젝트는 npm에 oh-my-claude-sisyphus 로 게시되었으며 Claude Code 마켓플레이스 플러그인으로도 제공됩니다.

---

빠른 시작(README가 보여주는 3단계 흐름)

1. 설치
   • Claude Code 사용자에게 권장: 마켓플레이스에서 플러그인을 추가하고 /plugin install oh-my-claudecode를 실행합니다.
   • 또는 CLI를 전역으로 설치: npm i -g oh-my-claude-sisyphus@latest.
2. 설정

   /omc-setup          # Claude Code 채팅 내에서
   # 또는 셸에서
   omc setup
   

   이렇게 하면 구성 파일(.claude/omc.jsonc 또는 ~/.config/claude-omc/config.jsonc)이 생성되고 내장 스킬이 등록됩니다.
3. 작업 실행

   /autopilot "작업 관리를 위한 REST API 구축"
   

   명령이 파싱되고 Claude 에이전트의 팀이 생성되어 계획, 구현, 테스트, 검증을 수행하며 HUD와 같은 실시간 상태 줄이 표시됩니다.

---

핵심 개념 및 용어

용어	의미
Autopilot	기본 자율 워크플로우로, 계획 → 실행 → 검증 단계를 단일 리드 에이전트로 실행합니다(선택적으로 QA 단계 포함). Claude에게 "그냥 해"라고 요청하는 가장 간단한 방법입니다.
Team	단계별 파이프라인(team-plan → team-prd → team-exec → team-verify → team-fix)으로 tmux 창을 사용하여 여러 에이전트를 병렬로 실행할 수 있습니다. 각 창은 제공자(Claude, Codex, Gemini, Antigravity, Grok, Cursor)의 실제 CLI 버전을 실행합니다.
/ask	특정 제공자(예: codex 또는 antigravity)에 질의하고 Claude가 답변을 종합하도록 하는 단축키입니다.
Workflow / profile	실행할 단계(ralplan, execution, qa, …)와 선택적 모델 라우팅을 정의하는 JSON-C 구성(.claude/omc.jsonc)입니다.
HUD	Claude Code UI에 표시되는 작은 상태 줄로 현재 단계, 활성 에이전트, 토큰 사용량 및 오류를 보고합니다.
플러그인 디렉터리 플래그	옵션(--plugin-dir, --plugin-dir-mode)으로 런타임이 이미 스킬을 제공하는 경우 스킬을 중복하지 않도록 설치 프로그램에 플러그인 위치를 알려줍니다.

---

주요 기능

• 제로 구성 시작 – 설치하고 /omc-setup을 실행하면 대부분의 프로젝트에서 기본값이 작동합니다.
• 팀 우선 오케스트레이션 – 권장 모드; 여러 LLM 에이전트 간에 작업을 병렬화합니다.
• 자연어 인터페이스 – 목표를 설명하기만 하면 됩니다. CLI 구문을 외울 필요가 없습니다.
• 비용 인식 라우팅 – 엔진이 특정 단계에 더 저렴한 모델을 선택하여 토큰 지출을 30-50% 절약할 수 있습니다.
• 지속적 실행 – 검증 검사(테스트, 린트, 타입 체크)가 통과할 때까지 시스템이 계속 시도합니다.
• 패턴 재사용 – 완료된 작업은 "아티팩트"로 저장되어 향후 실행에서 재사용할 수 있습니다.
• 실시간 HUD – 에이전트가 작업하는 동안 진행 상황, 토큰 사용량 및 실패를 표시합니다.

---

대상 사용자

• 반복적인 코딩 작업(스캐폴딩, 리팩토링, 코드 리뷰)을 사용자 정의 스크립트 없이 자동화하려는 개발자.
• 이미 Claude Code를 사용하고 있으며 멀티 에이전트 파이프라인을 실행하기 위한 더 높은 수준의 오케스트레이션 계층을 원하는 팀.
• Claude 기반 작업을 호출하기 위한 헤드리스, 결정적 CLI(omc …)가 필요한 CI/CD 파이프라인.

---

제한 사항 및 주의 사항

• 고급 Team 모드에는 Linux(flock 유틸리티)와 실행 중인 tmux 세션이 필요합니다.
• 일부 명령은 Claude Code 채팅 내에서만 존재하며(/autopilot, /team) CLI 하위 명령으로는 사용할 수 없습니다.
• npm 설치에는 네이티브 better-sqlite3 종속성이 포함되어 사용 중단 경고(prebuild-install@7.1.3)가 표시되지만 기능에는 영향을 미치지 않습니다.
• CLI 워커를 사용하려면 제공자별 CLI가 설치되고 인증되어 있어야 합니다(예: codex, gemini, cursor-agent).

---

최신 상태로 유지하는 방법

• npm 설치: npm i -g oh-my-claude-suffix…(README에서는 sisyphus라고 함).
• 마켓플레이스: /plugin marketplace update omc를 실행한 다음 /omc-setup.
• 플러그인 캐시가 오래된 경우 /omc-doctor를 실행합니다.

---

결론

oh-my-claudecode는 Anthropic의 Claude Code 위에 멀티 에이전트 오케스트레이션 계층을 추가하는 진정한, 활발히 유지 관리되는 오픈 소스 프로젝트입니다. Claude Code 내부 또는 터미널/CI 환경에서 높은 수준의 자연어 명령을 발행하고 조정된 LLM 에이전트 집합이 코드를 계획, 작성, 테스트, 검증하도록 하려는 개발자에게 유용합니다.