[English](README.md) | 한국어 | [中文](README.zh.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Português](README.pt.md) # oh-my-claudecode [![npm version](https://img.shields.io/npm/v/oh-my-claude-sisyphus?color=cb3837)](https://www.npmjs.com/package/oh-my-claude-sisyphus) [![npm downloads](https://img.shields.io/npm/dm/oh-my-claude-sisyphus?color=blue)](https://www.npmjs.com/package/oh-my-claude-sisyphus) [![GitHub stars](https://img.shields.io/github/stars/Yeachan-Heo/oh-my-claudecode?style=flat&color=yellow)](https://github.com/Yeachan-Heo/oh-my-claudecode/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Sponsor](https://img.shields.io/badge/Sponsor-❤️-red?style=flat&logo=github)](https://github.com/sponsors/Yeachan-Heo) [![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk) > **Codex 사용자분들께:** [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex)를 확인해보세요 — OpenAI Codex CLI를 위한 동일한 오케스트레이션 경험을 제공합니다. **Claude Code를 위한 멀티 에이전트 오케스트레이션. 학습 곡선 제로.** *Claude Code를 배우지 마세요. 그냥 OMC를 쓰세요.* [시작하기](#빠른-시작) • [문서](https://yeachan-heo.github.io/oh-my-claudecode-website) • [CLI 레퍼런스](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference) • [워크플로우](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#workflows) • [마이그레이션 가이드](docs/MIGRATION.md) --- ## 빠른 시작 **Step 1: 설치** ```bash /plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode ``` **Step 2: 설정** ```bash /omc-setup ``` **Step 3: 무언가 만들기** ``` autopilot: build a REST API for managing tasks ``` 끝입니다. 나머지는 모두 자동입니다. ### 어디서 시작해야 할지 모르겠다면? 요구사항이 불확실하거나, 막연한 아이디어만 있거나, 설계를 세밀하게 관리하고 싶다면: ``` /deep-interview "I want to build a task management app" ``` 딥 인터뷰는 소크라테스식 질문법을 사용하여 코드를 작성하기 전에 사고를 명확하게 합니다. 숨겨진 가정을 드러내고 가중치 기반 차원으로 명확성을 측정하여, 실행 시작 전에 무엇을 만들어야 하는지 정확히 알 수 있게 합니다. ## Team Mode (권장) **v4.1.7**부터 **Team**이 OMC의 표준 오케스트레이션 방식입니다. 레거시 `swarm` 키워드/스킬은 제거되었으니 `team`을 직접 사용하세요. ```bash /team 3:executor "fix all TypeScript errors" ``` Team은 단계별 파이프라인으로 실행됩니다: `team-plan → team-prd → team-exec → team-verify → team-fix (loop)` `~/.claude/settings.json`에서 Claude Code 네이티브 팀을 활성화하세요: ```json { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } ``` > 팀이 비활성화된 경우 OMC가 경고를 표시하고 가능한 경우 팀 없이 실행으로 폴백합니다. ### tmux CLI 워커 — Codex & Gemini (v4.4.0+) **v4.4.0에서 Codex/Gemini MCP 서버**(`x`, `g` 프로바이더)가 **제거됩니다**. CLI 우선 Team 런타임(`omc team ...`)으로 tmux 분할 창에서 실제 CLI 프로세스를 실행하세요: ```bash 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 team status auth-review omc team shutdown auth-review ``` `/omc-teams`는 레거시 호환 스킬로 유지되며, 현재는 내부적으로 `omc team ...`으로 라우팅됩니다. 하나의 명령으로 Codex + Gemini 작업을 처리하려면 **`/ccg`** 스킬을 사용하세요: ```bash /ccg Review this PR — architecture (Codex) and UI components (Gemini) ``` | 실행 표면 | 워커 | 최적 용도 | |-------|---------|----------| | `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 | Codex+Gemini 조언을 Claude가 통합 | 워커는 요청 시 생성되고 작업 완료 후 종료됩니다 — 유휴 리소스 낭비 없음. `codex` / `gemini` CLI가 설치되어 있고 활성 tmux 세션이 필요합니다. > **참고: 패키지 이름** — 프로젝트 브랜드명은 **oh-my-claudecode** (저장소, 플러그인, 명령어)이지만, npm 패키지는 [`oh-my-claude-sisyphus`](https://www.npmjs.com/package/oh-my-claude-sisyphus)로 배포됩니다. npm/bun으로 CLI 도구를 설치할 때는 `npm install -g oh-my-claude-sisyphus`를 사용하세요. ### 업데이트 ```bash # 1. 마켓플레이스 클론 업데이트 /plugin marketplace update omc # 2. 셋업을 다시 실행하여 설정 갱신 /omc-setup ``` > **참고:** 마켓플레이스 auto-update가 활성화되어 있지 않은 경우, 셋업 실행 전에 `/plugin marketplace update omc`를 수동으로 실행하여 최신 버전을 동기화해야 합니다. 업데이트 후 문제가 발생하면, 이전 플러그인 캐시를 정리하세요: ```bash /omc-doctor ```

당신의 Claude가 스테로이드를 맞았습니다.

oh-my-claudecode

--- ## 왜 oh-my-claudecode인가? - **설정 불필요** - 똑똑한 기본값으로 바로 작동합니다 - **Team 우선 오케스트레이션** - Team은 표준 멀티 에이전트 인터페이스입니다 (swarm/ultrapilot은 호환성 파사드) - **자연어 인터페이스** - 외울 명령어 없이, 원하는 것만 설명하세요 - **자동 병렬화** - 복잡한 작업을 전문 에이전트들에게 분산합니다 - **지속적 실행** - 작업이 완전히 검증될 때까지 포기하지 않습니다 - **비용 최적화** - 똑똑한 모델 라우팅으로 토큰을 30-50% 절약합니다 - **경험으로부터 학습** - 문제 해결 패턴을 자동으로 추출하고 재사용합니다 - **실시간 가시성** - HUD 상태바에서 내부에서 무슨 일이 일어나는지 확인하세요 --- ## 기능 ### 실행 모드 다양한 사용 사례를 위한 여러 전략 - 완전 자율 빌드부터 토큰 효율적인 리팩토링까지. [자세히 보기 →](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#execution-modes) | 모드 | 특징 | 용도 | |------|---------|---------| | **Team (권장)** | 단계별 파이프라인 | 공유 작업 목록에서 협력하는 Claude 에이전트 | | **omc team (CLI)** | tmux CLI 워커 | Codex/Gemini CLI 작업; 요청 시 실행, 완료 후 종료 | | **ccg** | 트라이-모델 병렬 | Codex(분석) + Gemini(디자인), Claude가 통합 | | **Autopilot** | 자율 실행 | 최소한의 설정으로 end-to-end 기능 개발 | | **Ultrawork** | 최대 병렬 | Team이 필요 없는 병렬 수정/리팩토링 | | **Ralph** | 지속 모드 | 완전히 완료되어야 하는 작업 | | **Pipeline** | 순차 처리 | 엄격한 순서가 필요한 다단계 변환 | | **Swarm / Ultrapilot (레거시)** | Team으로 라우팅 | 기존 워크플로우와 이전 문서 | ### 지능형 오케스트레이션 - **32개의 전문 에이전트** - 아키텍처, 연구, 디자인, 테스팅, 데이터 사이언스 - **똑똑한 모델 라우팅** - 간단한 작업엔 Haiku, 복잡한 추론엔 Opus - **자동 위임** - 매번 작업에 맞는 올바른 에이전트 선택 ### 개발자 경험 - **매직 키워드** - 명시적 제어를 위한 `ralph`, `ulw`, `team` - **HUD 상태바** - 상태바에서 실시간 오케스트레이션 메트릭 확인 - **스킬 학습** - 세션에서 재사용 가능한 패턴 추출 - **분석 및 비용 추적** - 모든 세션의 토큰 사용량 이해 ### 커스텀 스킬 한 번 배운 것을 영원히 재사용합니다. OMC는 디버깅 과정에서 얻은 실전 지식을 이식 가능한 스킬 파일로 추출하고, 관련 상황에서 자동으로 주입합니다. | | 프로젝트 스코프 | 사용자 스코프 | |---|---|---| | **경로** | `.omc/skills/` | `~/.omc/skills/` | | **공유 대상** | 팀 (버전 관리됨) | 모든 프로젝트에서 사용 | | **우선순위** | 높음 (사용자 스코프를 오버라이드) | 낮음 (폴백) | ```yaml # .omc/skills/fix-proxy-crash.md --- name: Fix Proxy Crash description: aiohttp proxy crashes on ClientDisconnectedError triggers: ["proxy", "aiohttp", "disconnected"] source: extracted --- server.py:42의 핸들러를 try/except ClientDisconnectedError로 감싸세요... ``` **스킬 관리:** `/skill list | add | remove | edit | search` **자동 학습:** `/learner`가 엄격한 품질 기준으로 재사용 가능한 패턴을 추출합니다 **자동 주입:** 매칭되는 스킬이 컨텍스트에 자동으로 로드됩니다 — 수동 호출 불필요 [전체 기능 목록 →](docs/REFERENCE.md) --- ## 매직 키워드 파워 유저를 위한 선택적 단축키. 자연어도 잘 작동합니다. | 키워드 | 효과 | 예시 | |---------|--------|---------| | `team` | 표준 Team 오케스트레이션 | `/team 3:executor "fix all TypeScript errors"` | | `omc team` | tmux CLI 워커 (codex/gemini/claude) | `omc team 2:codex "security review"` | | `ccg` | 트라이-모델 Codex+Gemini 오케스트레이션 | `/ccg review this PR` | | `autopilot` | 완전 자율 실행 | `autopilot: build a todo app` | | `ralph` | 지속 모드 | `ralph: refactor auth` | | `ulw` | 최대 병렬화 | `ulw fix all errors` | | `plan` | 계획 인터뷰 | `plan the API` | | `ralplan` | 반복적 계획 합의 | `ralplan this feature` | | `deep-interview` | 소크라테스식 요구사항 명확화 | `deep-interview "vague idea"` | | `swarm` | **지원 종료** — `team`을 사용하세요 | `swarm 5 agents: fix lint errors` | | `ultrapilot` | **지원 종료** — `team`을 사용하세요 | `ultrapilot: build a fullstack app` | **참고:** - **ralph는 ultrawork를 포함합니다:** ralph 모드를 활성화하면 자동으로 ultrawork의 병렬 실행이 포함됩니다. 키워드를 결합할 필요가 없습니다. - `/omc-teams`는 레거시 호환 경로로 남아 있으며 내부적으로 `omc team ...`으로 라우팅됩니다. - `swarm N agents` 구문은 에이전트 수 추출을 위해 여전히 인식되지만, v4.1.7+에서 런타임은 Team 기반입니다. --- ## 유틸리티 ### Rate Limit Wait 속도 제한이 리셋될 때 Claude Code 세션을 자동 재개합니다. ```bash omc wait # 상태 확인, 가이드 받기 omc wait --start # 자동 재개 데몬 활성화 omc wait --stop # 데몬 비활성화 ``` **요구사항:** tmux (세션 감지용) ### 알림 태그 설정 (Telegram/Discord/Slack) stop 콜백이 세션 요약을 보낼 때 태그할 대상을 설정할 수 있습니다. ```bash # 태그 목록 설정/교체 omc config-stop-callback telegram --enable --token --chat --tag-list "@alice,bob" omc config-stop-callback discord --enable --webhook --tag-list "@here,123456789012345678,role:987654321098765432" omc config-stop-callback slack --enable --webhook --tag-list ",<@U1234567890>" # 점진적 수정 omc config-stop-callback telegram --add-tag charlie omc config-stop-callback discord --remove-tag @here omc config-stop-callback discord --clear-tags ``` 태그 동작: - Telegram: `alice`는 `@alice`로 정규화됩니다 - Discord: `@here`, `@everyone`, 숫자 사용자 ID, `role:` 지원 - Slack: `<@MEMBER_ID>`, ``, ``, ``, `` 지원 - `file` 콜백은 태그 옵션을 무시합니다 ### OpenClaw 연동 Claude Code 세션 이벤트를 [OpenClaw](https://openclaw.ai/) 게이트웨이로 전달하여 OpenClaw 에이전트를 통한 자동화된 응답 및 워크플로우를 구성할 수 있습니다. **빠른 설정 (권장):** ```bash /oh-my-claudecode:configure-notifications # → 프롬프트에서 "openclaw" 입력 → "OpenClaw Gateway" 선택 ``` **수동 설정:** `~/.claude/omc_config.openclaw.json` 파일을 생성합니다: ```json { "enabled": true, "gateways": { "my-gateway": { "url": "https://your-gateway.example.com/wake", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "method": "POST", "timeout": 10000 } }, "hooks": { "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true }, "stop": { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true } } } ``` **환경 변수:** | 변수 | 설명 | |------|------| | `OMC_OPENCLAW=1` | OpenClaw 활성화 | | `OMC_OPENCLAW_DEBUG=1` | 디버그 로그 활성화 | | `OMC_OPENCLAW_CONFIG=/path/to/config.json` | 설정 파일 경로 변경 | **지원되는 훅 이벤트 (bridge.ts에서 6개 활성):** | 이벤트 | 트리거 시점 | 주요 템플릿 변수 | |--------|------------|-----------------| | `session-start` | 세션 시작 시 | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` | | `stop` | Claude 응답 완료 시 | `{{sessionId}}`, `{{projectName}}` | | `keyword-detector` | 프롬프트 제출마다 | `{{prompt}}`, `{{sessionId}}` | | `ask-user-question` | Claude가 사용자 입력 요청 시 | `{{question}}`, `{{sessionId}}` | | `pre-tool-use` | 툴 호출 전 (빈도 높음) | `{{toolName}}`, `{{sessionId}}` | | `post-tool-use` | 툴 호출 후 (빈도 높음) | `{{toolName}}`, `{{sessionId}}` | **Reply Channel 환경 변수:** | 변수 | 설명 | |------|------| | `OPENCLAW_REPLY_CHANNEL` | 응답 채널 (예: `discord`) | | `OPENCLAW_REPLY_TARGET` | 채널 ID | | `OPENCLAW_REPLY_THREAD` | 스레드 ID | OpenClaw 페이로드를 ClawdBot을 통해 Discord에 전달하는 레퍼런스 게이트웨이는 `scripts/openclaw-gateway-demo.mjs`를 참고하세요. --- ## 문서 - **[전체 레퍼런스](docs/REFERENCE.md)** - 완전한 기능 문서 - **[CLI 레퍼런스](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference)** - 모든 `omc` 명령어, 플래그 및 도구 - **[알림 가이드](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#notifications)** - Discord, Telegram, Slack 및 webhook 설정 - **[추천 워크플로우](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#workflows)** - 일반 작업을 위한 검증된 스킬 체인 - **[릴리스 노트](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#release-notes)** - 각 버전의 새로운 기능 - **[웹사이트](https://yeachan-heo.github.io/oh-my-claudecode-website)** - 인터랙티브 가이드와 예제 - **[마이그레이션 가이드](docs/MIGRATION.md)** - v2.x에서 업그레이드 - **[아키텍처](docs/ARCHITECTURE.md)** - 내부 작동 원리 - **[성능 모니터링](docs/PERFORMANCE-MONITORING.md)** - 에이전트 추적, 디버깅 및 최적화 --- ## 요구사항 - [Claude Code](https://docs.anthropic.com/claude-code) CLI - Claude Max/Pro 구독 또는 Anthropic API 키 ### 선택사항: 멀티 AI 오케스트레이션 OMC는 교차 검증과 디자인 일관성을 위해 외부 AI 제공자를 선택적으로 활용할 수 있습니다. **필수가 아닙니다** — OMC는 이것들 없이도 완벽하게 작동합니다. | 제공자 | 설치 | 활용 | |--------|------|------| | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | 디자인 리뷰, UI 일관성 (1M 토큰 컨텍스트) | | [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` | 아키텍처 검증, 코드 리뷰 교차 확인 | **비용:** 3개 Pro 플랜 (Claude + Gemini + ChatGPT)으로 월 ~$60에 모든 것을 커버합니다. --- ## 라이선스 MIT ---
**영감을 받은 프로젝트:** [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [claude-hud](https://github.com/ryanjoachim/claude-hud) • [Superpowers](https://github.com/obra/superpowers) • [everything-claude-code](https://github.com/affaan-m/everything-claude-code) • [Ouroboros](https://github.com/Q00/ouroboros) **학습 곡선 제로. 최대 파워.**
## Star History [![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-claudecode&type=date&legend=top-left) ## 💖 이 프로젝트 후원하기 Oh-My-ClaudeCode가 당신의 워크플로우에 도움이 된다면, 후원을 고려해주세요: [![Sponsor on GitHub](https://img.shields.io/badge/Sponsor-❤️-red?style=for-the-badge&logo=github)](https://github.com/sponsors/Yeachan-Heo) ### 왜 후원해야 하나요? - 활발한 개발 유지 - 후원자를 위한 우선 지원 - 로드맵 및 기능에 영향력 행사 - 무료 오픈소스 유지 지원 ### 다른 도움 방법 - ⭐ 리포지토리에 Star 주기 - 🐛 버그 리포트 - 💡 기능 제안 - 📝 코드 기여