Codex를 이미 쓰고 있는데 Oh My Codex도 필요할까요? 파일 하나를 설명받는 일과, 여러 기능을 바꾸기 전에 작업 순서·확인 기준을 남기는 일은 다릅니다. 이번에는 가상 카운터의 수정 계획을 실제로 만들고 저장한 화면으로, 무엇이 추가되고 어떤 사용자에게 쓸모가 있는지 살펴보겠습니다.
2026년 9월 23일 기준. Windows PowerShell에서 OMX 0.21.6과 Codex CLI 0.155.0-alpha.9.2로 진행했습니다. 실습자가 직접 조작·촬영한 화면이며, 이 글에서 확인한 범위는 계획 작성·저장까지입니다. 기능 구현이나 속도·정확도 비교 시험은 하지 않았습니다.
목차
기본 Codex에 무엇을 더할까?
Oh My Codex, 줄여서 OMX는 Codex CLI에 작업 절차와 보조 기능을 더하는 별도 프로젝트입니다. OpenAI의 새 모델이 아니라 제작자 프로젝트인 Yeachan-Heo/oh-my-codex를 뜻합니다. Codex가 실제 작업을 수행하고, OMX는 계획·실행·검토에 쓰는 스킬과 기록 방식을 더합니다.
기본 Codex CLI도 파일 읽기·편집·명령 실행뿐 아니라 계획 수립, 스킬, 플러그인, 하위 에이전트를 지원합니다. 따라서 “계획을 만들 수 있다”거나 “여러 역할을 쓴다”는 이유만으로 OMX가 필수인 것은 아닙니다.
| 구분 | 기본 Codex CLI | OMX를 추가하면 |
|---|---|---|
| 파일을 읽고 작업하는 주체 | Codex | Codex를 계속 사용 |
| 작업 요청 | 자연어와 필요한 지침·스킬을 구성 | $plan 등 준비된 작업 흐름을 호출 |
| 계획 기록 | 요청한 방식과 경로로 저장 가능 | .omx/ 아래에 계획·진행 기록을 관리 |
OMX가 더하는 것은 새 모델이 아니라 반복해서 사용할 작업 절차와 기록 방식입니다. 파일 하나를 이해하거나 작은 수정을 요청하는 일부터 시작한다면, 기본 Codex CLI로 먼저 진행해도 됩니다.
내 작업 폴더에서는 어떻게 실행할까?
이번 실습에서는 Codex 앱 안이 아니라 Windows PowerShell에서 OMX를 실행했습니다. 제작자가 안내하는 전제는 Node.js 20 이상과 같은 터미널에서 실행·인증되는 Codex CLI입니다. 권장 기본 환경은 macOS 또는 Linux이며, Windows와 Codex 앱은 지원이 더 제한된 경로라고 설명합니다.
참조: OMX 실행 전제와 지원 환경
이번에는 WSL이 아닌 Windows PowerShell에서 계획 파일 저장까지 진행했습니다. 다만 이 한 번의 결과를 Windows의 모든 기능이나 팀 실행까지 확인한 것으로 넓히지는 않겠습니다. 가상 실습 폴더에 OMX를 따로 준비했고, 기존 Codex 실행 파일과 로컬에 설치한 OMX 파일의 전체 경로를 사용했습니다.
--direct, --sandbox workspace-write, --ask-for-approval on-request가 들어 있습니다. 이미지를 누르면 크게 볼 수 있습니다.위의 긴 경로는 실습 PC에서만 맞는 주소입니다. 이미 OMX 설치와 프로젝트 설정을 마쳤고, PowerShell에서 omx 명령이 인식된다면 다음과 같은 형태로 실행할 수 있습니다. C:\작업\내프로젝트는 설명용 경로이므로 실제 파일이 있는 폴더로 바꾸세요.
PowerShell 명령 — PS C:\…>가 보이는 창에 입력
cd "C:\작업\내프로젝트"
omx --direct --sandbox workspace-write --ask-for-approval on-request
--direct는 별도의 OMX 터미널 화면 분할 없이 현재 터미널에서 여는 옵션입니다. 이 실습에서는 계획 파일을 저장하기 위해 workspace-write를 지정하고, 실행 중 필요한 작업은 승인 화면에서 확인했습니다. 설치가 안 된 상태라면 이 명령만으로 준비가 끝나지 않습니다. 제작자 설치 안내에 따라 OMX를 준비하되, 프로젝트 설정이 기존 AGENTS.md 지침에 미치는 영향을 먼저 살펴보세요.
실습 중에는 폴더 신뢰 질문과 Codex의 샌드박스 설정 화면이 차례로 나왔고, 이후 Sandbox ready가 표시됐습니다. 자기 폴더가 맞는지 확인한 뒤 진행해야 합니다. 이 과정은 보안 기능을 끄라는 뜻이 아닙니다. 기본 CLI 실행과 로그인부터 필요하다면 Codex CLI, 설치부터 첫 요청까지에서 이어 볼 수 있습니다.
자기 프로젝트에서 실행하려면 먼저 같은 PowerShell에서 Codex 인증과 OMX 준비를 마치고, 실제 작업 폴더로 이동한 뒤 OMX를 여세요. 실행 후 자연어 요청은 PowerShell 명령줄이 아니라, OMX가 연 Codex의 입력란에 적습니다.
코드를 고치지 않고 계획만 만들려면?
계획만 받고 싶다면 읽을 파일, 추가할 기능, 수정하면 안 되는 파일, 계획을 저장할 위치를 함께 지정합니다. 이번 자료는 실습용으로 만든 가상 웹페이지입니다. index.html은 숫자와 버튼을 표시하고, app.js는 버튼을 누를 때 숫자에 1을 더합니다. 이 두 파일을 그대로 둔 채, 초기화 버튼과 새로고침 후 값 보존 기능의 작업 계획을 요청했습니다.
GPT 입력문 — OMX로 연 Codex 입력란에 입력
$plan --direct이 폴더의 index.html과 app.js를 읽고, 카운터에 초기화 버튼과 새로고침 후 값 보존 기능을 추가하는 작업 계획만 만들어 줘. 작업 순서와 각 단계의 확인 기준을 적고 .omx/plans/counter-plan.md에 저장해 줘. index.html과 app.js는 수정하지 마. 다른 에이전트·웹·외부 서비스·추가 설치는 사용하지 마. 한국어로 답하고 마지막에 저장한 파일 경로와 아직 구현하지 않았다는 사실을 알려 줘.
이번 실습에서는 안내받은 위 요청문을 복사해 PowerShell에서 실행한 OMX의 Codex 입력란에 붙여넣었지만, 정상적으로 붙여넣지 못했습니다. 화면에는 빨간색 ‘Failed to paste image’ 오류가 나타났습니다. 이는 실습자가 직접 겪은 상황입니다. 아래에는 그 오류와 이후 요청문이 입력란에 들어간 상태가 함께 보입니다. 오류 원인과 이후 입력에 사용한 방법은 확인하지 못했습니다.
요청을 보낸 뒤에는 파일 읽기와 계획 저장에 관한 승인 화면이 나왔습니다. 화면의 실행 명령 또는 변경 대상이 요청한 파일인지 읽고, 이번 작업만 허용하려면 1. Yes, proceed를 선택해 Enter로 확인합니다. 다음 화면의 저장 대상은 원본 코드가 아니라 계획 파일 counter-plan.md입니다.
승인 후에는 .omx/plans/counter-plan.md가 실제로 저장됐습니다. 저장된 파일을 다시 읽었고, 실습 전후 index.html과 app.js의 SHA-256도 일치했습니다. SHA-256은 파일 내용의 변경 여부를 비교하는 값입니다. 이번에 추가된 것은 계획 문서이며, 두 원본 코드에 기능을 구현한 것은 아닙니다.
| 계획 파일에 들어간 내용 | 이번에 확인한 범위 |
|---|---|
| 작업 순서 | 현재 동작 정리 → 초기화 버튼 추가 → 저장값 복원 → 증가·초기화·저장 동기화 → 최종 시험 |
| 확인 기준 | 예를 들어 3까지 올린 뒤 새로고침해도 3인지, 초기화 후 새로고침해도 0인지 확인하도록 계획 |
| 예외 처리 | 잘못된 저장값, 저장 기능 오류, 키보드 조작 등을 고려 |
| 실제 코드와 기능 시험 | 원본 두 파일은 변경하지 않음. 초기화·값 보존 기능은 아직 구현·시험하지 않음 |
자기 작업에 적용할 때는 위 요청문의 파일명과 추가할 기능을 바꾸고, ‘계획만 작성’, ‘원본 수정 금지’, ‘단계별 확인 기준’, ‘저장 경로’를 함께 지정하세요. 받은 계획에서 작업 순서와 원하는 결과가 맞는지 검토한 다음, 구현할 단계만 따로 요청하면 계획과 실제 수정을 나누어 진행할 수 있습니다.
어떤 작업에 OMX를 추가하면 좋을까?
OMX가 필요한지는 계획을 만들 수 있느냐보다, 비슷한 계획·구현·검토 과정을 계속 반복하느냐로 판단하는 편이 낫습니다. 이번에는 막연히 “카운터를 고쳐 줘”라고 하지 않고, 수정 전에 무엇을 바꾸고 어떻게 확인할지 문서로 남겼습니다. 다음 작업에서도 같은 요청 방식과 계획 저장 위치를 쓰려는 사람에게 이런 절차가 쓸모 있습니다.
반대로 파일 하나의 설명이나 작은 수정이 목적이라면 기본 Codex로 시작하는 편을 권합니다. 기본 CLI도 계획을 요청할 수 있으므로, 그 일만을 위해 별도 도구와 프로젝트 지침을 관리할 필요는 크지 않습니다. 특히 Windows에서는 제작자의 제한된 지원 안내와 실습 중 겪은 입력 문제도 고려해야 합니다.
이번 결과로 확인한 것은 OMX의 계획 요청이 문서 저장으로 이어졌다는 점입니다. 기본 Codex보다 더 빠르거나 정확하다는 뜻은 아니며, 여러 에이전트가 함께 일하는 기능까지 시험한 것도 아닙니다.
단발성 설명·작은 수정은 기본 Codex로 시작하고, 여러 기능을 바꾸면서 계획과 확인 기준을 같은 방식으로 반복 관리할 때 OMX 도입을 검토하세요. 그때는 자기 파일과 변경할 기능을 지정해 계획부터 저장하고, 검토한 계획의 단계별로 구현을 맡기면 됩니다. 새 모델이 필요해서가 아니라, 작업 순서와 기록 방식을 갖춰 쓰고 싶을 때 추가하는 도구입니다.
답글 남기기