참고자료 · 외부 하네스

oh-my-claudecode 읽기 가이드

이 페이지는 README.ko.md 전체를 2026년 4월 8일 기준으로 읽고, 우리 사이트의 정보 구조에 맞게 다시 정리한 내부 가이드입니다. 목적은 README를 그대로 번역해 옮기는 것이 아니라, 실제로 어떤 기능이 있고 무엇부터 적용해야 하는지 빠르게 파악하게 만드는 데 있습니다.

1. 가장 짧은 시작 경로

README가 제시하는 기본 동선은 간단합니다. Claude Code 안에서 플러그인을 설치하고, 셋업을 한 번 실행한 뒤, 자연어 프롬프트나 워크플로우 키워드로 바로 작업을 시작하는 흐름입니다. 우리 쪽 관점에서도 이 순서가 가장 안전합니다.

# 1) 마켓플레이스 등록
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# 2) 플러그인 설치
/plugin install oh-my-claudecode

# 3) 설정 반영
/omc-setup

# 4) 바로 시작
autopilot: build a REST API for managing tasks

# 요구사항이 아직 흐리면
/deep-interview "I want to build a task management app"

2. Team이 표준이고, swarm은 레거시입니다

README는 v4.1.7부터 Team이 표준 오케스트레이션이라고 명확히 적습니다. 그래서 지금 OMC를 읽을 때는 `swarm` 문법을 중심에 두면 안 됩니다. 새 문서와 새 사용 예시는 모두 `team` 기준으로 보시는 편이 맞습니다.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Team 파이프라인은 team-plan → team-prd → team-exec → team-verify → team-fix 순서로 설명됩니다. 즉 “에이전트를 많이 띄운다”보다 단계별 검증이 중심인 구조로 이해하시는 편이 정확합니다.

/team 3:executor "fix all TypeScript errors"

3. Codex · Gemini worker 구조

README는 v4.4.0부터 Codex/Gemini MCP 서버 경로를 제거하고, 대신 omc team 기반 tmux CLI worker 런타임을 강조합니다. 이 점은 우리 쪽 콘텐츠에서도 분명히 분리해 둬야 합니다. Claude Code 네이티브 Team과, 외부 CLI를 병렬 워커로 호출하는 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"
/ccg Review this PR — architecture (Codex) and UI components (Gemini)

• 필수 조건은 `tmux` 와 해당 CLI 설치입니다.
• `codex` 와 `gemini` 는 선택 기능입니다. Claude-only로도 OMC 자체는 동작합니다.
• 교차 검토나 UI/아키텍처 분리 리뷰가 필요할 때만 붙이시는 편이 현실적입니다.

4. 우리 기준 핵심 세 가지

5. 스킬 학습과 운영 유틸리티는 선택 계층입니다

README 후반부는 실행 모드 외에 재사용 패턴 축적, rate limit 대응, 알림과 외부 이벤트 연동을 설명합니다. 이 영역은 코어 설치보다 한 단계 뒤에 읽으시면 됩니다.

6. 업데이트 절차는 두 단계로 보면 됩니다

README가 제시하는 공식 업데이트 절차는 단순합니다. 마켓플레이스 사본을 갱신하고, 셋업을 다시 실행해 로컬 설정을 동기화하는 방식입니다. 문제가 나면 doctor 성격의 정리 명령으로 캐시와 상태를 점검합니다.

# 1) 마켓플레이스 동기화
/plugin marketplace update omc

# 2) 설정 다시 반영
/omc-setup

# 3) 문제 발생 시 점검
/omc-doctor

README는 auto-update가 꺼져 있으면 먼저 /plugin marketplace update omc 를 실행하라고 안내합니다. 우리 쪽 가이드도 이 절차를 기준으로 잡는 편이 맞습니다.

7. 이 사이트에서 같이 읽으면 좋은 페이지