oh-my-codex: 한국 개발자가 만든 Codex의 oh-my-zsh

이번 4월, AI 코딩 분야에서 조용하지만 뜻깊은 변화가 일어났습니다. OpenAI가 Claude Code용 플러그인을 출시한 것입니다. 동시에 프로슈머 커뮤니티에서는 ‘Codex를 위한 oh-my-zsh’라 불릴 만한 프로젝트가 등장했죠. 한국인 개발자 Yeachan-Heo가 메인테이너로 있는 이 오픈소스 프로젝트는 출시 단 2주 만에 GitHub 별 16,000개를 돌파했습니다. 둘 다 오픈소스이며, 언론이 ‘Codex vs Claude Code’ 비교 기사를 내기 전부터 조용히 개발되어 왔습니다.

이제 경쟁 구도는 완전히 달라졌습니다. Claude Code 안에서 Codex를 직접 호출할 수 있게 되었죠. OpenAI가 공식으로 지원하는 커맨드이고요. OMX라는 오케스트레이션 레이어는 tmux 패널에 여러 에이전트를 띄워주면서, oh-my-zsh가 쉘에 도입했던 구조를 Codex 환경에 그대로 가져다줍니다.

방금 읽은 문장이 다소 낯설게 느껴졌다면, 그것이 바로 이 글의 핵심입니다. 두 도구가 정확히 무엇인지, 각각 2분 정도면 어떻게 설치하는지, 그리고 이 둘이 만나서 만들어내는 시너지가 단일 도구보다 왜 더 중요한지 차근차근 정리해 보겠습니다.

oh-my-codex (OMX)가 뭔데?

짧게: OMX와 Codex CLI의 관계는 oh-my-zsh와 zsh의 관계와 정확히 같습니다. oh-my-zsh를 써본 적이 없다면 이렇게 이해하시면 돼요. zsh는 터미널에서 명령을 실행하는 기본 프로그램이고, oh-my-zsh는 이를 바로 쓸 수 있는好用的 환경으로 만들어 주는 테마, 플러그인, 별칭, 훅의 모음입니다. OMX가 Codex에게 하는 일이 바로 그것이에요.

길게: Codex CLI는 OpenAI의 터미널 기반 코딩 에이전트입니다. ChatGPT의 더 유능한 사촌처럼 터미널 안에서 테스트 실행부터 커밋까지 처리하죠. 유능하면서도 미니멀한 게 특징이에요. OMX는 그런 미니멀한 Codex CLI에 빠진 기능들을 다 채워줍니다. tmux 패널에서 병렬로 돌아가는 에이전트 팀, MCP 서버 기반의 영구 메모리, 33개의 전문화된 프롬프트, TDD나 플래닝 스테이지 같은 워크플로우 스킬, 주요 이벤트에 반응하는 훅 시스템, 그리고 plan → PRD → exec → verify → fix로 이어지는 스테이지드 파이프라인까지요.

Yeachan-Heo가 관리하는 인기 fork는 4월 첫 주에 GitHub 별 16,000개를 넘겼습니다. 4월 5일에 trending-repos 트래커가 24시간 안에 1,789개 추가됐다고 집계했죠. MIT 라이선스를 따르고 있고요. AI 개발자 커뮤니티에서 유명한 Swyx가 트렌드 시작 다음날 Yeachan-Heo를 창작자로 언급하며 적극 추천했습니다.

디테일: 에이전트 13개 ($ultrawork, $deep-interview, $plan, $research, $team, $review, $tdd, $doctor, $hud, $trace, $autoresearch, $architect, $executor, $reviewer), tmux 기반 병렬 워커 (각각 격리된 git worktree — 머지 충돌 없음), SessionStart/PreToolUse/PostToolUse/UserPromptSubmit/Stop 훅, Discord / Telegram 통합, --yolo 부터 --madmax 까지의 런치 프로파일 (안전성과 속도 trade-off).

codex-plugin-cc는 뭐야?

짧게: 이건 OpenAI가 직접 만든 것입니다. Anthropic의 Claude Code를 확장하는 공식 플러그인이에요. Claude Code 안에서 Codex에게 작업을 위임할 수 있게 해주죠. 본인은 Claude Code에 머무른 채, Codex가 위임받은 일만 처리합니다.

길게: Claude Code에서 위험한 변경 전에 두 번째 의견을 얻고 싶었던 적이 있다면, 바로 이 기능이 필요한 순간이에요. 핵심 커맨드 셋은 다음과 같습니다.

/codex:review — 현재 커밋 안 된 변경에 대해 Codex 품질의 코드 리뷰 실행
/codex:adversarial-review — 설계 선택을 압박 테스트 — 인증 변경, 인프라 스크립트, 대규모 리팩터링처럼 잠복 가정이 치명적인 영역용
/codex:rescue — 백그라운드 잡으로 Codex에 오픈엔디드 태스크 위임. resume, wait, fresh-start, 특정 모델 선택, effort level 지정 — 전부 플래그로

더 필요한 커맨드도 있습니다. /codex:status 로 실행 중인 잡을 확인하고, /codex:result 로 최종 출력 + Codex에서 이어서 할 수 있는 세션 ID를 확인하며, /codex:cancel 로 원치 않는 잡을 중단할 수 있어요.

내부는 MCP (Model Context Protocol) 기반 구조로 되어 있습니다. 로컬 Codex CLI 또는 Codex 앱 서버와 직접 통신하죠. Codex를 로컬에서 실행할 때 보내는 데이터 이상은 OpenAI 서버로 가지 않습니다. ChatGPT 구독 (Free도 가능) 또는 OpenAI API 키 + Node.js 18.18 이상만 있으면 바로 연결할 수 있어요.

출시일 (4월 초)에 한 개발자가 올린 포스트가 좋아요 2,243개, 리포스트 177개를 받았습니다. 반응의 대부분은 “OpenAI가 진짜로 이걸 릴리즈했다고?” 였죠. 6개월 전이었다면 누구나 농담으로 받아들였을 문장이에요.

OMX를 2분 안에 설치하기

터미널을 엽니다.

npm install -g @openai/codex oh-my-codex
omx setup
omx doctor

설치는 끝이에요. 첫 명령은 Codex CLI와 OMX 패키지를 npm에서 가져오는 것이고요. 두 번째는 인터랙티브 셋업 — OpenAI API 키가 설정되어 있지 않으면 물어보고, 프로젝트에 .omx/ 상태 디렉토리를 만들어 줍니다. 세 번째는 진단을 실행해서 tmux, git worktree 권한, Codex credential이 제대로 물렸는지 확인하죠.

실제 세션 시작하려면 이렇게 하세요:

omx --madmax --high

--madmax 는 가장 공격적인 런치 프로파일입니다. tmux 패널에 에이전트 팀을 띄우고, 각자 자기 git worktree에서 작업을 진행하죠. 조심해서 시작하고 싶으면 --high 만 쓰거나, --yolo 로 가드레일 약한 싱글 에이전트 모드로 들어갈 수 있습니다. --xhigh 도 있는데, 이건 풀 딥 에이전틱 모드예요.

조심할 점 하나: ChatGPT Plus ($20/월) 에서 --madmax 로 돌리면 사용 한도가 생각보다 훨씬 빨리 다 찹니다. 한 개발자는 단 6분 만에 한도에 도달했다고 보고했어요. OMX로 진지하게 작업을 진행하려면 $100 Codex Pro 티어를 예산에 꼭 잡아두세요 — 5배 확대된 한도가 병렬 에이전트를 실용적으로 쓰는 기준점이에요.

codex-plugin-cc를 2분 안에 설치하기

이건 터미널이 아니라 Claude Code 안에서 설치합니다. Claude Code를 열고:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

user scope 로 어디서나 쓸지, project scope 로 현재 레포로 한정할지, local scope 로 단일 세션으로 할지 선택하면 됩니다. 셋업 과정에서 Codex 연결을 안내해 주며 — Codex CLI가 설치되어 있지 않으면 자동으로 유도하죠.

셋업이 끝나면 실제 변경 작업에 돌려볼까요:

/codex:review --base main

main 과의 차이 전체를 Codex 품질 리뷰로 받을 수 있습니다. 인증이나 인프라 관련 변경이라면 이렇게 해보세요:

/codex:adversarial-review --background

adversarial review가 백그라운드에서 실행되므로 본인은 계속 작업할 수 있습니다. /codex:status 로 진행 상황을 확인하고, /codex:result 로 결과를 가져와서, 리뷰에서 위험 신호가 감지되면 최소한 머지 전에 잡을 수 있어요.

두 개가 같이 있을 때 실제로 하는 일

커뮤니티에서 가장 자주 반복되는 워크플로우는 다음과 같습니다.

Claude Code를 엽니다. Claude Opus 4.7로 아키텍처 설계와 계획을 담당하게 하죠. Claude가 뭔가에 대해 지나치게 신중해질 때 — 정적 HTML, CSS 조정, 순수 리팩터링처럼 가볍게 넘기기 쉬운 부분 — /codex:rescue 를 실행해서 Codex의 gpt-5.4-mini 가 백그라운드에서 밀어붙이게 합니다. 결과를 다시 Claude Code에서 검토하고 머지하죠.

큰 리팩터링 작업이라면 두 모델을 적대적으로 돌립니다. 변경사항을 브랜치로 준비한 뒤, /codex:adversarial-review 에 --focus "authentication and session handling" 플래그를 붙여 실행하세요. Codex가 새 모델 관점에서 리뷰를 진행합니다. 두 모델의 의견이 갈리는 지점이 바로 실제 위험 지점이에요.

터미널 쪽에서는 OMX가 3개 에이전트를 병렬로 돌립니다 — API 레이어, 프론트엔드, 테스트 담당자죠. 각자 tmux 패널과 git worktree를 씁니다. 마지막에 $review 에이전트가 3개의 결과를 모두 검토한 뒤 코디네이트된 머지를 진행하죠.

X에서 한 한국 개발자가 이 패턴을 한 줄로 잘 요약했어요: “개발은 클로드 코드에게, 리뷰는 코덱스에게”. 일본 개발자는 더 단순하게 표현했고요: “Claude와 Codex의 콜라보가 최고”. 누구도 어느 회사가 어느 모델을 만들었는지 따지지 않습니다.

oh-my-zsh 모먼트

OMX가 이렇게 빠르게 주목받은 이유는 기능이 아닙니다. 바로 ‘모습’이에요. oh-my-zsh는 괜찮은 shell을 커뮤니티가 함께 키우는 플랫폼으로 바꾸었습니다. 누구나 플러그인을 가져다 쓰고, 테마를 적용하죠. Shell 자체는 바뀌지 않았어요. 다만 스캐폴딩이 하나의 제품이 된 거예요.

지금 AI 코딩 에이전트 분야에서 일어나고 있는 일도 정확히 그와 같아요. Claude에는 obra/superpowers, ui-ux-pro-max 생태계가 있고요. Codex는 이제 OMX와 4월 17일에 런칭한 90+ 공식 플러그인을 갖게 되었습니다. 둘 다 “좋은 모델을 만든다"는 시대를 지나, “좋은 모델 + 오케스트레이션 레이어를 만든다"는 시대로 진화하고 있어요.

진짜 새로워진 부분이에요: codex-plugin-cc 덕분에 그 오케스트레이션 레이어들이 서로 대화할 수 있게 되었습니다. OMX를 Codex 위에서 돌리면서 Claude Code가 세션 중에 거기에 작업을 위임하죠. 모델 간 경쟁이 단순 벤치마크 대결을 넘어, 실제 시스템의 ‘배관’을 어떻게 연결하느냐로 승부가 갈리고 있습니다.

그리고 — 한국 개발자 관점에서 특별히 짚고 넘어갈 부분이 있어요: 이 흐름의 중심 프로젝트 중 하나를 한국인이 만들었습니다. 16,000개 별, 단 2주 만에요. 기반이 될 만한 작품을 만드는 데 지리적 위치가 장벽이 될 수 없다는 것을 다시 한 번 보여준 사례죠.

안 되는 것들 (솔직하게)

싼 플랜으로는 사용량 제한이 빠르게 소진됩니다. 병렬 에이전트는 곧 병렬 토큰 소비예요. ChatGPT Plus $20 티어는 싱글 에이전트 Codex를 잘 감당합니다. 하지만 OMX --madmax 모드까지 커버하지는 못하죠. 병렬로 돌리고 싶다면 월 $100 Codex Pro를 예산에 꼭 잡으세요.

OMX는 tmux 사용을 전제로 합니다. Windows라면 psmux fallback 이 있긴 하지만, 아직 실전 검증이 덜 됐어요. 개발 노력이 Mac/Linux 쪽에 집중되어 있죠.

codex-plugin-cc는 Codex CLI 로컬 실행이 필수입니다. 클라우드 간 브릿지가 아니에요. Codex를 본인 머신에 설치하고 싶지 않다면 이 플러그인은 적합하지 않아요.

두 도구 모두 에이전트가 늘 실패하는 방식으로 여전히 실패합니다. 테스트 루프에 갇히거나, LLM이 해결하지 못하는 머지 충돌, 자신 있게 쓴 잘못된 문서가 대표적이죠. 오케스트레이션은 실패를 더 빨리 잡아낼 뿐, 실패 자체를 없애주진 않습니다.

트렌딩 별 수 ≠ 실전 검증. OMX는 아직 몇 주밖에 되지 않았습니다. 일부 기능 (MCP 메모리 서버, Telegram 통합)은 데모 환경에서 잘 돌아가지만 프로덕션 테스트는 아직 부족해요. 리스크를 피하고 싶다면 한 달 정도 지켜본 뒤 메인 워크플로우에 결합하는 걸 추천합니다.

“oh-my-codex” 레포가 두 개 있습니다. Yeachan-Heo fork 가 트윗에서 가장 많이 인용되는 16k 별짜리입니다. staticpayload fork 는 별개의 더 작은 프로젝트죠. 설치할 때 정확한 레포를 선택하세요.

4월 17일 이후 일부가 OMX 관련성에 의문을 제기했습니다. 중국 개발자 한 명이 Codex Desktop에 새로 추가된 computer-use 플러그인 때문에 OMX의 오케스트레이션 기능이 이제 네이티브 기능과 겹치지 않냐고 지적했어요. 한 달 동안 지켜봐야 할 긴장 지점이에요. 오늘 시점에서 OMX의 훅과 팀 기반 워크플로우는 데스크톱 앱보다 훨씬 더 나아요 — 하지만 간격이 좁혀질 가능성도 있습니다.

독자별로 무슨 뜻인가

Claude Code 파워 유저라면: 이번 주말에 codex-plugin-cc 설치하세요. 2분 셋업만으로 모든 변경에 대한 무료 세컨드 오피니언이 생깁니다. Codex를 직접 쓰지 않아도 괜찮아요 — Claude가 간단한 작업으로 막히고 있을 때 딱 손 닿는 곳에 두는 것만으로도 충분합니다.

이미 Codex CLI 사용자라면: 타임아웃이 자주 걸리는 긴 태스크를 자주 돌리거나, multi-agent 병렬 작업을 원한다면 OMX 설치하세요. 짧은 이터레이션 사이클이고 가격 민감하다면 바닐라 Codex CLI를 유지하는 게 맞습니다.

AI 코딩 에이전트가 처음이라면: 둘 다 지금은 스킵하세요. Claude Code 또는 Codex Desktop 기본형으로 시작하는 게 좋아요. 싱글 에이전트가 뭘 잘못하는지 먼저 느껴야 오케스트레이션 레이어의 가치가 보입니다. 한 달 뒤에 다시 와보세요.

팀에서 어떤 툴로 표준화할지 결정 중이라면: 이젠 고민할 필요가 없어요. 답은 “둘 다, 오케스트레이션"입니다. 어떤 오케스트레이션 스택 (OMX vs obra/superpowers vs 자체 구축) 으로 갈지를 중심으로 결정하고, 어떤 모델로 커밋할지는 부차적인 문제예요.

이번 주말 설치해야 하는 사람

OMX 지금 설치: macOS 또는 Linux에 tmux, Codex Pro ($100/월), 일요일 밤새 돌려놓을 만한 수 시간짜리 태스크가 있을 때.
codex-plugin-cc 지금 설치: 이미 Claude Code를 사용 중이고, 2분 투자로 Codex를 백업으로 얻고 싶을 때.
둘 다 설치: 솔로 개발자 또는 인디 오퍼레이터로, 같은 시간에 더 많은 처리량을 뽑아낼 방법을 찾고 있을 때.
지금은 스킵: 아직 주력 툴을 배우는 중이라면요. 오케스트레이션 레이어는 이미 잘하는 것을 증폭시킬 뿐입니다. 아직 잘하는 게 없으면 혼란만 키우죠.

결론

OMX와 codex-plugin-cc는 같은 이야기의 두 반쪽이에요: AI 코딩은 ‘선택 문제’에서 ‘구성 문제’로 바뀌고 있습니다. “어떤 모델이 최고인지"를 따지는 시대는 저물어가요. “어떤 오케스트레이션 레이어가 내 모델들을 묶어주는지"가 중요한 시대가 열렸어요.

두 도구 모두 무료입니다. 둘 다 5분 안에 설치 가능하죠. 둘 다 우리에게 명확한 방향을 제시해 줍니다: 모델을 만드는 회사들이 이제 경쟁사와 상호운용할 도구를 만들고 있어요. 개발자가 진짜로 원하는 게 바로 그거니까요.

OMX 설치하세요. codex-plugin-cc 설치하세요. 일주일 정도 써보세요. 최종 스택이 둘 중 어느 하나와 정확히 일치하지는 않을 거예요 — 그래도 괜찮습니다. 요점은 스택 자체가 하나의 제품이 되어가고 있다는 것이니까요.