LLM 공부 기록 #2 - oh-my-codex(OMX) 설치하고 Codex에 지휘 맡겨보기

0. 목차

인트로: 이번에는 Codex가 팀장이다?

OMX가 뭔데?

설치: Windows PowerShell 7에서 OMX 설치하기

OMX는 어떤 순서로 일할까?

Codex가 Claude와 Gemini를 부를 수 있을까?

설치하면서 헷갈렸던 부분들

아웃트로: 설치 완료, 평가는 보류

1. 인트로: 이번에는 Codex가 팀장이다?

지난 포스팅에서 Claude Code 추천 플러그인 OMC를 설치했습니다.

OMC의 CCG 기능으로 작성 중인 자료를 여러 LLM에 검토시키는 과정도 정리했고요.

그러던 중 제가 사용하던 AI 구독 조합을 변경하게 됐습니다.

기존 조합

Claude Max x5

ChatGPT Plus

Google AI Pro

변경한 조합

Claude Pro

ChatGPT Pro x5

Google AI Pro

Claude의 비중을 조금 줄이고 ChatGPT의 비중을 높인 셈입니다.

그렇다면 여러 AI에게 일을 나눠주는 역할도 Claude가 아니라 Codex에 맡겨보면 어떨까요?

“OMC가 Claude Code용이라면 Codex용 도구도 있지 않을까?”

찾아보니까 같은 개발자가 만든 oh-my-codex가 있었습니다.

줄여서 OMX라고 부른다네요.

오늘은 Windows PowerShell 7에서 OMX를 설치한 과정과 공식 문서를 읽으면서 이해한 기본 구조를 정리합니다.

아직 실제 오케스트레이션은 실행 전이라 사용 후기는 다음으로 미뤄두려고 해요.

2. OMX가 뭔데?

처음에는 OMC와 이름이 비슷해서 Codex용 플러그인 정도로 생각했습니다.

정확히는 OpenAI Codex CLI에 작업 순서와 역할 분담, 기록 기능을 추가하는 워크플로우 도구예요.

OMX가 새로운 AI 모델은 아닙니다.

실제로 코드를 읽고 수정하는 역할은 Codex가 담당하고, OMX는 Codex가 어떤 순서로 일할지 관리합니다.

기본 Codex를 일 잘하는 동료 한 명이라고 생각해 보겠습니다.

혼자 계획을 세우고, 코드를 작성하고, 결과도 확인해요.

OMX는 여기에 프로젝트 관리 방식을 추가하는 느낌입니다.

요구사항을 확인하는 역할

작업 계획을 만드는 역할

실제 코드를 수정하는 역할

결과와 테스트를 검증하는 역할

여러 작업자에게 일을 나눠주는 역할

쉽게 말하면 이번에는 Codex가 작은 프로젝트 팀의 팀장 역할을 맡는 셈이네요.

작업 중 만들어진 계획과 로그, 진행 상태는 .omx 폴더에 저장됩니다.

지난 글의 OMC가 Claude Code를 중심으로 돌아갔다면, OMX는 Codex CLI를 중심으로 돌아간다는 차이가 있습니다.

3. 설치: Windows PowerShell 7에서 OMX 설치하기

제가 사용한 환경은 다음과 같습니다.

Windows OS

IDE 내장 터미널

PowerShell 7

OpenAI Codex CLI

2026년 7월 20일 기준 최신 공식 릴리스는 v0.20.3입니다.

설치 전에 먼저 Codex CLI가 준비됐는지 확인합니다.

PowerShell에 아래 명령어를 입력했어요.

codex –version

Codex CLI가 없다면 먼저 설치해야 합니다.

npm install -g @openai/codex

그다음 OMX를 설치합니다.

npm install -g oh-my-codex

OMC는 프로젝트 이름과 npm 패키지 이름이 달라서 헷갈렸는데, OMX는 둘 다 oh-my-codex라서 알아보기 쉬웠습니다.

설치가 끝나면 설정 범위를 선택합니다.

사용자 전체에 설정하기

특정 프로젝트가 아니라 내 Codex 환경 전체에서 사용하려면 다음 명령을 입력합니다.

omx setup –scope user

현재 프로젝트에 설정하기

Git 프로젝트에 맞춘 설정을 만들려면 해당 프로젝트 폴더에서 실행합니다.

omx setup –scope project –merge-agents

처음에는 user와 project가 뭔지 헷갈렸습니다.

찾아보니까 차이는 이렇습니다.

user: 현재 사용자 환경에 OMX 설정

project: 현재 프로젝트 폴더에 별도 설정

프로젝트 설정에서는 AGENTS.md와 .omx 폴더 같은 파일이 현재 작업 폴더를 기준으로 만들어집니다.

설치 상태는 아래 명령으로 확인할 수 있어요.

omx doctor

저는 Windows PowerShell 7에서 실제 설치까지 완료했습니다!

이제 바로 사용할 수 있는 줄 알았는데, 공식 문서를 조금 더 읽어보니까 설치 확인과 실제 실행 확인은 다른 문제였습니다.

Codex 로그인 상태는 따로 확인해야 해요.

codex login status

공식 문서에서는 실제 요청이 가능한지 확인하는 테스트도 안내합니다.

omx exec –skip-git-repo-check -C . “Reply with exactly OMX-EXEC-OK”

omx doctor가 정상이어도 로그인이나 모델 호출에서 문제가 생길 수 있다는 뜻이네요.

4. OMX는 어떤 순서로 일할까?

설치하고 기능 목록을 보니까 종류가 상당히 많았습니다.

처음부터 전부 외우는 건 무리일 것 같아서 공식 문서에서 기본으로 안내하는 흐름부터 살펴봤어요.

① deep-interview: 무엇을 만들지 확인하기

$deep-interview “만들 기능의 범위와 완료 조건을 정리해줘”

바로 코드를 작성하지 않고 먼저 필요한 내용을 질문하는 단계입니다.

예를 들어 Excel 자동화 프로그램을 만든다면 다음 내용을 먼저 확인할 수 있어요.

어떤 형식의 파일을 읽을지

중복 데이터는 어떻게 처리할지

결과 파일에는 어떤 열이 필요한지

오류가 발생하면 어떻게 기록할지

요구사항이 애매한 상태에서 바로 코드를 작성하는 일을 줄여주는 기능으로 보입니다.

② ralplan: 작업 계획 검토하기

$ralplan “작업 계획과 주의할 점을 검토해줘”

요구사항이 정리되면 어떤 순서로 만들지 계획합니다.

중요한 점은 ralplan이 계획만 만든다는 것입니다.

계획이 끝났다고 코드까지 자동으로 수정되는 건 아니에요. 실제 작업을 시작하려면 실행 기능을 따로 선택해야 합니다.

③ ultragoal: 계획을 끝까지 진행하기

$ultragoal “승인한 계획을 기준으로 작업을 완료해줘”

승인한 계획을 여러 목표로 나누고, 진행 상태를 기록하면서 완료까지 이어가는 방식입니다.

정리하면:

deep-interview: 무엇을 만들지 확인

ralplan: 어떻게 만들지 계획

ultragoal: 계획대로 작업하고 진행 상태 확인

코드 한 줄을 고치는 데 매번 이 과정을 사용할 필요는 없겠죠.

여러 파일을 수정하거나 완료 조건이 복잡한 작업에 더 잘 맞아 보였습니다.

5. Codex가 Claude와 Gemini를 부를 수 있을까?

제가 OMX를 설치한 가장 큰 이유는 Codex에게 오케스트레이션을 맡기기 위해서입니다.

오케스트레이션이라는 말이 조금 어렵습니다.

쉽게 말하면 Codex가 중심에서 작업을 정리하고, 필요한 AI에게 의견이나 작업을 요청한 뒤 결과를 모으는 방식이에요.

OMX에는 Claude와 Gemini에 질문을 전달하는 명령도 있습니다.

omx ask claude “이 코드에서 문제가 될 부분을 검토해줘”

omx ask gemini “다른 구현 방법이 있는지 제안해줘”

Team 기능에서는 Codex와 Claude 작업자를 섞는 구성도 지원합니다.

예를 들면:

Codex: 전체 작업 계획과 코드 작성

Claude: 코드나 문서 검토

Gemini: 다른 아이디어나 접근 방법 제안

이런 구조를 기대하고 있습니다.

하지만 OMX만 설치한다고 제가 구독 중인 AI가 자동으로 전부 연결되는 것은 아니었습니다.

Claude와 Gemini를 부르려면 각각의 CLI가 설치되어 있어야 하고, 같은 터미널 환경에서 로그인도 완료해야 합니다.

AI 서비스를 구독하고 있는 것과 CLI가 설치되고 인증된 것은 별개네요.

현재는 Claude Code 사용량이 한도에 도달한 상태라 실제 오케스트레이션은 아직 실행하지 않았습니다.

따라서 작업이 빨라졌는지, 결과가 더 좋아졌는지는 모르겠어요.

설치에 성공한 것과 실제로 효과를 느끼는 건 다른 문제니까요.

Claude Code 사용량이 다시 열리면 Codex가 중심이 되고 Claude가 작업자로 참여하는 구조부터 테스트해 볼 생각입니다.

6. 설치하면서 헷갈렸던 부분들

① PowerShell 명령과 Codex Skill은 다름

아래 명령은 PowerShell에서 실행합니다.

npm install -g oh-my-codex omx setup –scope user omx doctor omx

반면 $로 시작하는 기능은 OMX로 실행한 Codex 세션 안에서 사용합니다.

$deep-interview $ralplan $ultragoal $ralph $team

명령어가 어디에 입력되는지 모르고 그대로 붙여 넣으면 작동하지 않을 수 있어요.

② OMX 설치가 외부 AI 로그인까지 해주지는 않음

OMX를 설치해도 Claude CLI와 Gemini CLI의 설치 및 인증은 별도로 진행해야 합니다.

ChatGPT Pro, Claude Pro, Google AI Pro를 구독하고 있다는 사실만으로 자동 연결되는 구조는 아니에요.

③ doctor 성공이 실제 호출 성공은 아님

omx doctor

이 명령은 OMX의 파일과 설정 상태를 확인합니다.

실제 Codex 호출까지 되는지 확인하려면 로그인 상태와 실행 테스트를 따로 확인해야 합니다.

codex login status

④ madmax는 주의해서 사용하기

공식 문서에는 다음과 같은 실행 예시가 나옵니다.

omx –worktree=feat/task –madmax –xhigh

–madmax는 Codex의 승인 절차와 샌드박스 보호를 우회하는 옵션입니다.

이름부터 뭔가 심상치 않네요.

처음 사용할 때는 옵션 없이 기본 실행부터 확인하는 편이 안전해 보입니다.

omx

⑤ Windows는 기본 권장 환경이 아님

OMX 공식 문서에서는 macOS와 Linux를 기본 환경으로 권장합니다.

Windows 네이티브 환경은 일부 기능이 불안정할 수 있다고 안내하고 있어요.

특히 Team과 HUD 기능은 tmux를 기준으로 만들어졌습니다. Windows에서는 psmux를 사용하는 방법이 있지만,

설치했다고 바로 모든 기능이 정상 작동한다고 생각하면 안 될 것 같아요.

저도 일단 설치까지만 완료했고, Team은 실제 실행 후 다시 정리할 예정입니다.

7. 아웃트로: 설치 완료, 평가는 보류

오늘은 Codex CLI의 작업 방식을 확장하는 oh-my-codex, OMX를 설치했습니다.

핵심 정리

OMX는 새로운 AI 모델이 아니라 Codex의 작업 방식을 관리하는 도구

Windows PowerShell 7에서도 설치는 완료됨

사용자 설정과 프로젝트 설정을 구분해야 함

기본 흐름은 요구사항 확인, 계획 검토, 실제 실행 순서

Claude와 Gemini를 사용하려면 별도 CLI 설치와 인증 필요

실제 오케스트레이션은 아직 실행 전이라 효과 판단은 보류

지난 포스팅에서는 Claude Code와 OMC가 중심이었습니다.

이번에는 Codex가 팀장이 되고, 필요할 때 Claude와 Gemini의 의견을 받는 구조를 만들어보려고 해요.

아직은 설치만 끝낸 단계라 기대한 대로 움직일지는 모르겠습니다.

직접 실행해 보고 예상보다 복잡했다면 그 과정도 그대로 기록해 봐야겠어요.

다음에는 Codex와 Claude에 실제로 역할을 나눠주고, 기본 Codex와 어떤 차이가 있었는지 정리해 보겠습니다.

혹시 설명 중에 틀린 부분이나 Windows에서 더 좋은 설정 방법이 있다면 알려주세요! 😊

※ 이 글은 2026년 7월 20일 공식 문서와 v0.20.3 릴리스를 기준으로 작성했습니다. OMX는 업데이트가 빠르므로 사용 전 공식 문서를 다시 확인해 주세요.

참고 자료

oh-my-codex 공식 GitHub 및 README

OMX 공식 Getting Started

OMX v0.20.3 Release

OMX CHANGELOG

OMX Team 공식 Skill 문서