Yeachan-Heo/oh-my-claudecode

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português

Codex 사용자를 위한 안내:
oh-my-codex를 확인해 보세요. OpenAI Codex CLI에 대한 동일한 오케스트레이션 경험을 제공합니다.

Claude Code용 다중 에이전트 오케스트레이션. 학습 곡선 없음.

Claude Code를 배우지 마세요. OMC만 사용하세요.

시작하기 • 문서 • CLI 참조 • 워크플로우 • 마이그레이션 가이드 • Discord

역할	이름	GitHub
제작자 및 리드	Yeachan Heo	@Yeachan-Heo

이름	GitHub
Sigrid Jin	@sigridjineth

이름	GitHub
devswha	@devswha

이름	GitHub	커밋
JunghwanNA	@shaun0927	65
...
1단계: 설치

마켓플레이스/플러그인 설치 (대부분의 Claude Code 사용자에게 권장).
이것들은 Claude Code 슬래시 명령어입니다. 한 번에 하나씩 입력하세요 (두 줄을 한꺼번에 붙여넣으면 실패합니다):

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

그런 다음:

/plugin install oh-my-claudecode

마켓플레이스 흐름 대신 npm CLI/런타임 경로를 선호하는 경우:

npm i -g oh-my-claude-sisyphus@latest

알려진 npm 경고:CLI 설치 중 deprecated prebuild-install@7.1.3가 출력될 수 있습니다. 이는 현재 상위 레벨의 better-sqlite3 네이티브 애드온 종속성(better-sqlite3 -> prebuild-install)에서 발생합니다. prebuild-install@7.1.3는 여전히 최신 게시 버전이므로, 경고를 제거하기 위한 안전한 저장소 측 종속성 상향 조정이나 재정의가 아직 없습니다. 이 경고는 #2913에서 추적되고 있으며, 그 자체로 OMC CLI 설치 실패를 의미하지 않습니다.

2단계: 설정

# Claude Code / OMC 세션 내부
/setup
/omc-setup
...

omc --plugin-dir <경로> 또는 claude --plugin-dir <경로>를 통해 OMC를 실행하는 경우, 플러그인이 런타임에 이미 제공하는 스킬/에이전트를 설치 프로그램이 중복하지 않도록 omc setup에 --plugin-dir-mode를 추가하거나 (또는 실행하기 전에 OMC_PLUGIN_ROOT 환경 변수를 내보내세요). 전체 결정 매트릭스와 사용 가능한 모든 플래그는 REFERENCE.md의 플러그인 디렉토리 플래그 섹션을 참조하세요.

3단계: 무언가 만들기

# Claude Code / OMC 세션 내부에서
/autopilot "작업 관리를 위한 REST API를 구축해줘"
# 세션 내 자연어 단축 명령어
...

끝입니다. 나머지는 모두 자동으로 이루어집니다.

OMC는 두 가지 서로 다른 인터페이스를 제공합니다:

터미널 CLI 명령어 (Terminal CLI commands): npm/런타임 경로(npm i -g oh-my-claude-sisyphus@latest)를 설치한 후 셸(shell)에서 omc ...를 실행하거나, 로컬 체크아웃(local checkout)에서 실행합니다.

세션 내 스킬 (In-session skills): 플러그인/설정 흐름(plugin/setup flow)을 설치한 후 Claude Code 세션 내부에서 /...를 실행합니다.

기능	터미널 CLI (Terminal CLI)	세션 내 스킬 (In-session skill)	비고
설정 (Setup)	omc setup	/setup 또는 /omc-setup	둘 다 실제 엔트리포인트(entrypoints)입니다. /setup이 플러그인 우선 방식으로서 가장 쉽습니다.
제공자에게 질문 (Ask providers)	omc ask codex "이 패치를 리뷰해줘"	/ask codex "이 패치를 리뷰해줘"	둘 다 동일한 어드바이저(advisor) 흐름을 통해 라우팅됩니다.
팀 오케스트레이션 (Team orchestration)	omc team 2:codex "인증 흐름을 리뷰해줘"	/team 3:executor "모든 TypeScript 에러를 수정해줘"	둘 다 존재하지만 런타임(runtimes)이 다릅니다: omc team은 tmux CLI 워커(workers)를 실행하며, /team은 세션 내 네이티브 팀 워크플로(native team workflow)를 실행합니다.
Autopilot / Ralph / Ultrawork / Deep Interview	—	/autopilot ... , /ralph ... , /ultrawork ... , /deep-interview ...	이것들은 세션 내 스킬입니다. 이 저장소에는 omc autopilot / omc ralph / omc ultrawork CLI 서브커맨드(subcommand)가 없습니다.
자동 조사 (Autoresearch)	omc autoresearch (사용 중단 예정인 shim)	/deep-interview --autoresearch ... + /oh-my-claudecode:autoresearch	설정은 deep-interview에 유지되며, 실행은 이제 상태 유지 스킬(stateful skill)에 속합니다.

요구사항이 불확실하거나, 아이디어가 막연하거나, 설계를 세밀하게 관리(micromanage)하고 싶다면 다음과 같이 입력하세요:

/deep-interview "작업 관리 앱을 만들고 싶어"

딥 인터뷰(deep interview)는 코드가 작성되기 전에 소크라테스식 질문법(Socratic questioning)을 사용하여 사용자의 생각을 명확히 합니다. 이는 숨겨진 가정을 드러내고 가중치가 부여된 차원 전반에 걸쳐 명확성을 측정하여, 실행이 시작되기 전에 무엇을 구축해야 하는지 정확히 알 수 있도록 보장합니다.

v4.1.7부터 Team은 OMC의 표준 오케스트레이션 인터페이스 (orchestration surface)입니다. 기존의 swarm 키워드/스킬 (keyword/skill)은 제거되었으며, team을 직접 사용하십시오.

/team 3:executor "fix all TypeScript errors"

Claude Code의 세션 내 네이티브 팀 워크플로우 (in-session native team workflow)를 사용하려면 /team ...을 사용하십시오. 터미널에서 실행되는 tmux CLI 워커 (claude / codex / gemini 창)를 사용하려면 omc team ...을 사용하십시오.

Team은 단계별 파이프라인 (staged pipeline)으로 실행됩니다:

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

~/.claude/settings.json에서 Claude Code 네이티브 팀을 활성화하십시오:

{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
...

팀이 비활성화되어 있으면 OMC가 경고를 표시하며, 가능한 경우 팀이 아닌 실행 방식 (non-team execution)으로 대체됩니다.

v4.4.0에서는 Codex/Gemini MCP 서버 (x, g 프로바이더)를 제거합니다. 실제 tmux 워커 창을 생성하려면 CLI 우선 Team 런타임 (omc team ...)을 사용하십시오:

omc team 2:codex "review auth module for security issues"
omc team 2:gemini "redesign UI components for accessibility"
omc team 1:claude "implement the payment flow"
...

/omc-teams는 레거시 호환성 스킬 (legacy compatibility skill)로 남아 있으며, 이제 omc team ...으로 라우팅됩니다.

한 명령에서 Codex + Gemini 혼합 작업을 수행하려면 ** /ccg** 스킬을 사용하십시오 (/ask codex + /ask gemini를 통해 라우팅된 후 Claude가 합성합니다):
/ccg Review this PR — architecture (Codex) and UI components (Gemini)

인터페이스 (Surface)	워커 (Workers)	최적 용도 (Best For)
omc team N:codex "..."	N개의 Codex CLI 창	코드 리뷰, 보안 분석, 아키텍처
omc team N:gemini "..."	N개의 Gemini CLI 창	UI/UX 디자인, 문서, 대규모 컨텍스트 작업
omc team N:claude "..."	N개의 Claude CLI 창	tmux 내 Claude CLI를 통한 일반 작업
/ccg	/ask codex + /ask gemini	3개 모델 어드바이저 합성 (Tri-model advisor synthesis)

워커는 필요할 때 생성되고 작업이 완료되면 종료되므로 유휴 리소스 사용이 없습니다. codex / gemini CLI가 설치되어 있어야 하며 활성화된 tmux 세션이 필요합니다.

Native team worker worktrees는 옵트인(opt-in)/설정 게이트(config gate) 뒤에 추가되고 있습니다. 워크스페이스 계약(workspace contract), 정전 상태 루트 규칙(canonical state-root rules), 더티 워크트리 보존 정책(dirty-worktree preservation policy) 및 검증 체크리스트에 대해서는 Native Team Worktree Mode를 참조하십시오.

참고: 패키지 명명— 프로젝트 브랜드는 oh-my-claudecode(리포지토리, 플러그인, 명령어)이지만, npm 패키지는 oh-my-claude-sisyphus로 게시됩니다.

npm/bun을 통해 CLI 도구를 설치하거나 업그레이드하는 경우, npm i -g oh-my-claude-sisyphus@latest를 사용하십시오.

npm을 통해 OMC를 설치한 경우, 게시된 패키지 이름으로 업그레이드하십시오:

npm i -g oh-my-claude-sisyphus@latest

패키지 명명 참고: 리포지토리, 플러그인 및 명령어는 oh-my-claudecode로 브랜드화되어 있지만, 게시된 npm 패키지 이름은 oh-my-claude-sisyphus로 유지됩니다.

Claude Code 마켓플레이스/플러그인 흐름을 통해 OMC를 설치한 경우, 다음 명령어로 업데이트하십시오:

# 1. 마켓플레이스 클론 업데이트
/plugin marketplace update omc
# 2. 구성을 새로고침하기 위해 setup 재실행
...

로컬 체크아웃(local checkout) 또는 git 워크트리(git worktree)에서 개발 중인 경우, 먼저 체크아웃을 업데이트한 다음 해당 워크트리에서 setup을 다시 실행하여 활성 런타임(active runtime)이 테스트 중인 코드와 일치하도록 하십시오.

참고: 마켓플레이스 자동 업데이트가 활성화되어 있지 않은 경우, setup을 실행하기 전에 최신 버전을 동기화하기 위해 수동으로 /plugin marketplace update omc를 실행해야 합니다.

업데이트 후 문제가 발생하는 경우, 이전 플러그인 캐시를 삭제하십시오:

/omc-doctor

설정 불필요 (Zero configuration required)- 지능적인 기본값으로 즉시 작동합니다.
팀 우선 오케스트레이션 (Team-first orchestration)- Team은 표준 멀티 에이전트 인터페이스(canonical multi-agent surface)입니다.
자연어 인터페이스 (Natural language interface)- 암기해야 할 명령어가 없으며, 원하는 내용을 설명하기만 하면 됩니다.
자동 병렬화 (Automatic parallelization)- 복잡한 작업이 전문화된 에이전트들에게 분산됩니다.
지속적 실행 (Persistent execution)- 작업이 완료된 것으로 검증될 때까지 포기하지 않습니다.
비용 최적화 (Cost optimization)- 스마트 모델 라우팅(model routing)을 통해 토큰 비용을 30-50% 절감합니다.
경험으로부터 학습 (Learn from experience)- 문제 해결 패턴을 자동으로 추출하고 재사용합니다.
실시간 가시성 (Real-time visibility)- HUD 상태 표시줄(statusline)을 통해 내부에서 무엇이 일어나고 있는지 보여줍니다.

다양한 사용 사례를 위한 다중 전략 — 팀 기반 오케스트레이션 (Team-backed orchestration)부터 토큰 효율적인 리팩토링 (token-efficient refactoring)까지. 자세히 알아보기 →

모드 (Mode)	정의 (What it is)	용도 (Use For)
Team (권장)	정형화된 단계별 파이프라인 (Canonical staged pipeline) (team-plan → team-prd → team-exec → team-verify → team-fix)	공유된 작업 목록 상의 조율된 Claude 에이전트들 (Coordinated Claude agents)
	tmux CLI 워커 — 분할 창(split-panes) 내의 실제 claude / codex / gemini 프로세스	Codex/Gemini CLI 작업; 온디맨드 생성, 완료 시 종료
	/ask codex + /ask gemini를 통한 3중 모델 어드바이저, Claude가 종합	Codex와 Gemini가 모두 필요한 백엔드+UI 혼합 작업
Autopilot	자율 실행 (Autonomous execution) (단일 리드 에이전트)	최소한의 절차로 진행되는 엔드-투-엔드 (End-to-end) 기능 작업
Ultrawork	최대 병렬성 (Maximum parallelism) (비-팀 모드)	Team 모드가 필요하지 않은 폭발적인 병렬 수정/리팩토링
Ralph	검증/수정 루프 (verify/fix loops)를 포함한 지속 모드	반드시 완전히 완료되어야 하는 작업 (조용한 부분 완료 없음)
UltraQA	테스트/빌드/린트(lint)/타입 체크(typecheck) 목표를 통과할 때까지 QA 사이클링	반복적인 진단/수정 사이클이 필요한 품질 게이트 (Quality gates)
Claude Code /goal	네이티브 Claude Code 교차 턴 목표 루프 (cross-turn goal loop)	측정 가능한 단일 세션 완료 조건; OMC 증거 원장(evidence ledger)이 아님
Artifact-only Ultragoal	루프를 시작하지 않고 지속적인 목표/체크포인트/증거 아티팩트(artifacts) 생성	핸드오프(Handoffs), 감사(audits), 또는 사용 불가능하거나 충돌하는 루프 실행 시간
Pipeline	순차적, 단계별 처리	엄격한 순서가 필요한 다단계 변환
Ultrapilot (legacy)	지원 중단된 호환 모드 (autopilot 파이프라인 별칭)	기존 워크플로 및 이전 문서

한 세션에서는 하나의 주요 루프 권한(primary loop authority)만 사용하십시오. Claude Code /goal은 네이티브 교차 턴 완료 조건에 유용하며, Ralph는 단일 에이전트 검증 완료를 담당하고, Team은 병렬 단계별 실행을 담당하며, UltraQA는 반복적인 품질 게이트 사이클링을 담당합니다. Artifact-only Ultragoal은 다른 루프를 시작하지 않고도 지속적인 목표 아티팩트와 증거가 필요할 때 안전한 대체 수단(fallback)입니다.

/goal에 대하여

행동 방식, Claude Code/Anthropic 소스에 의존하십시오: Claude Code /goal

문서 및 Anthropic Claude Code 변경 로그(changelog). /goal 평가기가 독립적으로 명령을 실행하거나 파일을 읽는다고 주장하지 마십시오. 목표가 증명된 것으로 처리하기 전에 대화 내에서 테스트 출력, 차이점(diffs) 및 검토 증거를 제시하십시오.

19개의 특화된 에이전트(티어 변형 포함) - 아키텍처, 연구, 디자인, 테스트, 데이터 과학용
스마트 모델 라우팅 (Smart model routing)

• 단순 작업에는 Haiku, 복잡한 추론에는 Opus 사용
  자동 위임 (Automatic delegation)
• 매번 작업에 적합한 에이전트 배정
  모델 × 에이전트 호환성 매트릭스 (Model × Agent Compatibility Matrix)
• 각 에이전트와 결합할 모델, 프리미엄/밸런스/예산 프리셋 제공

매직 키워드 (Magic keywords)

• ralph, ulw, ralplan; 팀은 /team을 통해 명시적인 상태를 유지합니다.

HUD 상태줄 (HUD statusline)

• 상태 표시줄에 실시간 오케스트레이션(orchestration) 지표 표시

• 만약 omc 심(shim)을 우회하여 claude --plugin-dir <path>로 Claude Code를 직접 실행하는 경우, HUD 번들이 플러그인 로더와 동일한 체크아웃(checkout)으로 해결될 수 있도록 셸(shell)에서 export OMC_PLUGIN_ROOT=<path>를 실행하십시오. 자세한 내용은 REFERENCE.md의 플러그인 디렉토리 플래그 섹션을 참조하십시오.

• 만약 Claude Code를 직접 실행하는 경우
  기술 학습 (Skill learning)

• 세션에서 재사용 가능한 패턴 추출
  분석 및 비용 추적 (Analytics & cost tracking)

• 모든 세션에 걸친 토큰 사용량 파악

OMC에 기여하고 싶으신가요? 포크(fork) 방법, 로컬 체크아웃 설정, 활성 플러그인으로 연결, 테스트 실행 및 PR 제출 방법을 포함한 전체 개발자 가이드는 CONTRIBUTING.md를 참조하십시오.

한 번 배우고 영원히 재사용하십시오. OMC는 어렵게 얻은 디버깅 지식을 휴대 가능한 기술 파일(skill files)로 추출하여 관련 상황 발생 시 자동으로 주입(auto-inject)합니다.

프로젝트 범위 (Project Scope)	사용자 범위 (User Scope)
경로 (Path)	.omc/skills/
공유 대상 (Shared with)	팀 (작업 트리 간 유지를 위해 기술 파일을 커밋하십시오)
우선순위 (Priority)	높음 (사용자 설정보다 우선)

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
...

기술 관리 (Manage skills): /skill list | add | remove | edit | search

기술화 (Skillify): /skillify

엄격한 품질 게이트 (quality gates)를 통해 재사용 가능한 패턴을 추출합니다.
자동 주입 (Auto-inject): 일치하는 기술 (skills)이 컨텍스트에 자동으로 로드되어 — 수동으로 호출할 필요가 없습니다.

프로젝트 범위의 기술 (Project-scoped skills)은 .omc/skills/에 저장되며,
공유를 원하는 경우 커밋 (commit)하도록 설계되었습니다. 연결된 git 워크트리 (worktree) 내부에서 기술을 생성하고 커밋하지 않으면, 해당 워크트리가 삭제될 때 함께 사라집니다.

이러한 단축키는 터미널 CLI 명령어가 아니라 Claude Code / OMC 세션 내부에서 실행됩니다. 셸 (shell) 명령어를 사용하려면 위에 표시된 omc ... 형식을 사용하십시오. 팀 모드 (Team mode)는 명시적입니다: 단순히 team 키워드 트리거를 기대하기보다는, 세션 내에서 /team ...을 사용하거나 셸에서 omc team ...을 사용하십시오.