OMC(oh-my-claudecode)는 클로드 코드 위에 얹어 쓰는 오픈소스 플러그인입니다. 여러 에이전트가 계획하고 실행하고 검증하는 과정을 자동으로 굴려줍니다.
공식 소개 문구는 멀티 에이전트 오케스트레이션, 학습 곡선 없음이고, 그 아래에는 "클로드 코드를 배우지 마세요. 그냥 OMC를 쓰세요"라고 적혀 있습니다.
검색해서 들어오시는 분들이 헷갈리는 지점이 꽤 분명합니다. 설치 명령이 두 줄인데 한 번에 붙여넣으면 실패하고, 터미널에서 되는 명령과 세션 안에서만 되는 명령이 따로 놀거든요. 이 글은 그 지점들을 순서대로 정리했습니다.
OMC 공식 깃허브 저장소 상단. Teams-first Multi-agent orchestration for Claude Code라는 설명과 별 개수, MIT 라이선스 표시가 보인다
작성자: 국내 최대 AI 커뮤니티 지피터스에서 마케팅을 하며 클로드 코드를 매일 씁니다. OMC는 커뮤니티 개발 게시판에 회원들의 실사용 기록이 여러 편 쌓여 있는 도구라, 공식 문서와 그 기록을 함께 근거로 삼았습니다.
확인일: 2026년 8월 18일 · 기능과 명령어는 공식 저장소 README 기준입니다.
OMC가 뭔가요
클로드 코드는 그 자체로도 잘 돌아갑니다. 다만 조금 큰 작업을 시키면 계획을 세우고, 작업을 쪼개고, 결과를 검증하는 일을 사용자가 계속 지시해야 합니다. OMC는 그 반복을 플러그인 층에서 대신 맡습니다.
숫자로 보면 규모가 짐작됩니다. 별 38,615개에 라이선스는 MIT, 마지막 커밋이 어제(2026년 8월 17일)입니다. 만든 사람은 허예찬 님이고 한국어 README도 함께 제공됩니다.
Codex를 쓰신다면 같은 제작자의 oh-my-codex라는 형제 프로젝트가 따로 있습니다.
설치는 두 줄인데, 한 줄씩 넣어야 합니다
가장 흔한 실패 지점부터 짚겠습니다. 공식 문서가 굵게 강조한 부분이기도 합니다. 아래는 클로드 코드 안에서 치는 슬래시 명령이고, 두 줄을 한 번에 붙여넣으면 실패합니다.
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
이게 끝나면 그다음에,
/plugin install oh-my-claudecode
터미널 CLI 쪽을 선호하면 npm으로도 됩니다.
npm i -g oh-my-claude-sisyphus@latest
설치 중에 deprecated [email protected] 경고가 뜰 수 있는데, 공식 문서가 설치 실패가 아니라고 명시해 뒀습니다. 상위 의존성에서 오는 경고라 지금은 지울 방법이 없다고 이슈로 추적 중입니다.
설치 후 세팅은 세션 안에서 /setup 또는 /omc-setup, 터미널에서는 omc setup입니다.
설치했으면 이것부터
문서가 첫 실행으로 권하는 건 autopilot입니다. 세션에서 이렇게 칩니다.
/autopilot "할 일 관리용 REST API 만들어줘"
무엇을 만들지가 아직 흐릿하면 /deep-interview가 따로 있습니다. 소크라테스식 질문으로 요구사항을 먼저 캐묻고, 명확해진 다음에 코드로 넘어가는 방식입니다. 만들다 방향이 틀어지는 것보다 앞에서 몇 분 쓰는 게 싸다는 판단이 깔려 있습니다.
팀 모드가 표준입니다
v4.1.7부터 Team이 공식 오케스트레이션 방식이 됐습니다. 예전에 쓰던 swarm 키워드는 제거됐으니, 옛 글을 보고 따라 하다 안 되면 이걸 의심하시면 됩니다.
/team 3:executor "타입스크립트 에러 전부 고쳐줘"
앞의 숫자가 작업자 수, 뒤가 역할입니다. 실행되면 단계별 파이프라인으로 돌아갑니다.
OMC 팀 모드 파이프라인 도식. 계획, 요구사항, 실행, 검증, 수정 다섯 단계로 이어지고 검증에서 문제가 나오면 실행으로 되돌아가 반복한다
여기서 걸리는 조건이 하나 있습니다. 클로드 코드의 네이티브 팀 기능이 실험 기능이라 설정에서 켜야 합니다. ~/.claude/settings.json에 아래를 넣습니다.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
꺼져 있으면 OMC가 경고를 띄우고 팀 없이 돌아가는 쪽으로 물러섭니다. 팀 모드를 켰는데 평범하게 동작하는 것 같다면 이 설정부터 확인해 보세요.
터미널 명령과 세션 명령은 다릅니다
이 구분을 모르면 문서를 봐도 계속 어긋납니다. OMC는 표면이 두 개입니다.
터미널 CLI: 셸에서
omc ...로 실행. npm 설치 경로가 필요합니다세션 스킬: 클로드 코드 세션 안에서
/...로 실행. 플러그인 설치 경로입니다
둘 다 되는 것도 있고 한쪽만 되는 것도 있습니다. 세팅(omc setup / /setup)과 질의(omc ask / /ask)는 양쪽 다 됩니다. 반면 autopilot·ralph·ultrawork·deep-interview는 세션 전용이라 omc autopilot 같은 터미널 명령은 아예 없습니다.
팀은 이름은 같은데 실행 환경이 다릅니다. /team은 세션 안에서 도는 네이티브 워크플로고, omc team은 tmux로 별도 워커를 띄웁니다. 같은 걸 두 방식으로 부르는 게 아니라 서로 다른 런타임입니다.
다른 AI 도구와 같이 쓰기
/ask로 다른 모델에게 의견을 물을 수 있습니다. 지원 프로바이더는 claude, codex, gemini, antigravity, grok, cursor입니다.
/ask codex "이 패치 좀 봐줘"
한 도구에 갇히지 않고 교차 검증을 붙일 수 있다는 뜻인데, 지피터스에도 이런 조합을 실제로 굴려본 기록들이 있습니다. AI 코딩 에이전트 선택 가이드: Claude Code vs Oh My OpenCode 실사용 비교와 Claude Code 위에 한 겹 더, OMC 4대 기능 한 주 사용기가 그렇습니다. 이 글은 설치와 구조를 맡고, 실제로 일주일 굴려본 감각은 그쪽이 훨씬 구체적입니다.
플러그인과 스킬이 늘어나면 관리가 문제가 되는데, 그건 스킬과 플러그인을 중앙 관리하는 구조 설계 쪽에 정리돼 있습니다.
쓰기 전에 알아둘 제약
문서가 직접 밝힌 한계가 몇 가지 있습니다.
VS Code 확장은 없습니다. OMC는 확장을 배포하지 않고, 확장 전용 설치 방법도 문서화하지 않습니다. 클로드 코드 플러그인이나 터미널 CLI로만 씁니다
CI에서는 슬래시 명령을 쓰지 마세요.
/autopilot·/ralph·/team은 살아 있는 세션이 필요합니다. 자동화에는omc setup,omc ask같은 터미널 명령을 쓰고 API 키를 러너 환경에 넣으라고 안내합니다이름 붙인 autopilot 워크플로는 리눅스 전용입니다.
--workflow옵션은 커널 수준 파일 잠금을 쓰기 때문에 다른 환경에서는 거부됩니다
자주 묻는 질문
OMC는 무료인가요?
MIT 라이선스 오픈소스라 무료로 쓸 수 있습니다. 다만 OMC 자체가 무료일 뿐, 그 아래에서 도는 클로드 코드 사용료는 별도입니다.
설치 명령이 안 먹는데요?
두 줄을 한 번에 붙여넣으면 실패합니다. /plugin marketplace add ...를 먼저 실행해 끝난 뒤에 /plugin install oh-my-claudecode를 따로 입력해야 합니다.
swarm 명령이 없다고 나옵니다
v4.1.7에서 제거됐습니다. 지금은 team이 표준이라 /team으로 바꿔 쓰시면 됩니다.
터미널에서 autopilot이 실행되지 않습니다
omc autopilot 명령은 존재하지 않습니다. autopilot·ralph·ultrawork·deep-interview는 클로드 코드 세션 안에서 슬래시 명령으로만 동작합니다.
인사이트
OMC를 보면서 흥미로웠던 건 기능 목록이 아니라 문서가 실패를 앞에 배치했다는 점입니다. 설치 항목에서 "두 줄을 한 번에 붙여넣으면 실패한다"를 굵게 적어두고, npm 경고가 실패가 아니라는 설명까지 붙여뒀습니다. 보통 이런 건 이슈 탭에 쌓이고 마는데 README 앞머리에 올라와 있습니다.
별 3만 8천 개짜리 프로젝트가 그렇게 쓴다는 건, 사용자가 실제로 그 지점에서 대량으로 이탈했다는 뜻이기도 합니다. 도구를 소개하는 글을 쓸 때 참고할 만한 순서라고 생각합니다. 기능을 나열하기 전에 사람들이 어디서 튕겨 나가는지를 먼저 적는 것이요.
터미널 명령과 세션 명령을 나눠 표로 정리해둔 것도 같은 맥락으로 보입니다. 기능이 늘어나는 속도보다 어디서 무엇이 되는지를 정리해주는 속도가 도구의 진입 장벽을 더 크게 좌우하는 것 같습니다. OMC를 처음 붙여볼 때도 기능 목록보다 이 구분을 먼저 잡고 들어가시는 편이 덜 헤맵니다.