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가 shell에 도입했던 구조를 Codex에 그대로 이식한다.

방금 한 문장이 세 가지 언어처럼 느껴졌다면, 그게 이 글의 포인트다. 두 도구가 정확히 무엇인지, 어떻게 설치하는지 (각각 2분 정도), 그리고 이 둘이 함께 말하는 이야기가 왜 개별 도구 하나보다 더 중요한지 정리해본다.

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

짧게: OMX와 Codex CLI의 관계는 oh-my-zsh와 zsh의 관계와 같다. oh-my-zsh 써본 적이 없다면 이렇게 생각하면 된다. zsh는 터미널에서 명령을 실행하는 프로그램. oh-my-zsh는 그 zsh를 처음으로 살 만한 환경으로 만든 테마, 플러그인, 앨리어스, 훅의 묶음이다. OMX가 Codex한테 하는 일이 바로 그거다.

길게: Codex CLI는 OpenAI의 터미널 기반 코딩 에이전트 — ChatGPT의 더 유능한 사촌으로 터미널에 살면서 테스트 실행하고 커밋까지 한다. 유능한데 미니멀하다. OMX는 그 미니멀 버전에 빠진 것들을 다 추가한다. 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가 위험한 변경에 대해 second opinion 받고 싶었던 적이 있다면, 그게 이거다. 핵심 커맨드 셋:

/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 이 있긴 한데 battle-tested 가 덜 됐다. Mac/Linux 쪽에 개발 노력이 집중됐다.

codex-plugin-cc는 Codex CLI 로컬 실행 필요. Cloud-to-cloud 브릿지가 아니다. Codex를 본인 머신에 설치하고 싶지 않다면 이건 아니다.

두 도구 다 에이전트가 늘 실패하는 방식으로 여전히 실패. 테스트 루프에 갇히고, LLM이 해결 못하는 머지 충돌, 자신 있게 쓴 틀린 문서. 오케스트레이션은 실패를 더 빨리 잡아낼 뿐 — 실패 자체를 없애진 않는다.

트렌딩 별 수 ≠ battle-tested. OMX는 몇 주밖에 안 됐다. 일부 기능 (MCP 메모리 서버, Telegram 통합)은 데모에서 돌지만 프로덕션 테스트는 안 됐다. 리스크 averse 하면 한 달 지켜본 뒤 메인 워크플로우에 결합한다.

“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 기본형으로 시작. 싱글 에이전트가 뭘 잘못하는지 먼저 느껴야 오케스트레이션 레이어의 이해가 생긴다. 한 달 뒤에 다시 와라.

팀에서 어떤 툴로 표준화할지 결정 중이라면: 이젠 non-question. 답은 “둘 다, 오케스트레이션”. 어떤 오케스트레이션 스택 (OMX vs obra/superpowers vs 자체 구축) 으로 갈지를 중심으로 결정하고, 어떤 모델로 커밋할지는 부차로.

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

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

결론

OMX와 codex-plugin-cc는 같은 이야기의 두 반쪽이다: AI 코딩은 선택 문제에서 구성 문제로 바뀌고 있다. “어떤 모델이 최고인지” 시대는 끝나간다. “어떤 오케스트레이션 레이어가 내 모델들을 묶어주는지” 시대가 시작되고 있다.

두 도구 다 무료. 둘 다 5분 안에 설치 가능. 둘 다 어디로 향하는지 말해준다: 모델을 만드는 회사들이 경쟁사와 상호운용할 도구를 만들고 있다. 개발자가 진짜 원하는 게 그거니까.

OMX 설치해라. codex-plugin-cc 설치해라. 일주일 써봐라. 최종 스택은 둘 중 어느 하나와 정확히 일치하지 않을 것이고 — 그래도 괜찮다. 요점은 스택 자체가 제품이 돼간다는 것.