FAQ
LazyCodex 설치, OmO 관계, ulw, 훅, doctor, 토큰, Codex App, OMX 충돌에 대한 짧은 답변.
자주 막히는 지점을 빠르게 찾을 수 있도록 묶었습니다. 설치 문제라면 설치와 환경, 명령을 고르는 문제라면 처음 쓰기, 실행 중 이상하다면 실행과 검증부터 보면 됩니다.
설치와 환경
LazyCodex는 무엇인가요?+
Codex 위에 OmO의 핵심 명령, 스킬, 훅을 얹는 Codex용 light port입니다. 별도 하니스라기보다는 Codex가 긴 작업을 더 잘 계획하고, 이어 가고, 증거로 확인하도록 돕는 얇은 레이어로 보면 됩니다.
LazyCodex는 OmO 대신 나온 건가요?+
대체재라기보다는 OmO를 Codex에서 쓰기 좋게 줄인 light port에 가깝습니다. 전체 OmO에는 더 깊은 오케스트레이션이 있고, LazyCodex는 Codex에서 바로 쓰기 좋은 부분에 집중합니다.
Codex에게 설치해 달라고 해도 되나요?+
됩니다. Codex App이나 Codex CLI에 LazyCodex GitHub 링크 또는 lazycodex.ai를 주고 설치를 요청해도 되고, 직접 npx lazycodex-ai install을 실행해도 됩니다.
Codex App과 Codex CLI 설치가 다른가요?+
같은 흐름으로 보면 됩니다. LazyCodex는 Codex 환경에 설치됩니다. 평소 쓰는 쪽이 Codex App이면 App에서, CLI면 CLI에서 확인하면 됩니다.
Bun이 필요한가요?+
아닙니다. LazyCodex를 소스에서 빌드하는 경우가 아니라면 Bun은 설치하지 않아도 됩니다. 일반 설치와 사용은 Node.js/npm의 npx 경로를 기준으로 합니다.
Windows에서도 되나요?+
가능은 하지만 적극 권장하지는 않습니다. Windows를 써야 한다면 네이티브 Windows보다 WSL2 Ubuntu 안에서 Codex와 LazyCodex를 쓰는 편이 낫습니다. 설치나 실행이 꼬이면 PowerShell보다 WSL2 또는 Git Bash 기반 셸에서 다시 확인합니다.
문서에 보이는 버전은 무엇인가요?+
문서에는 플러그인 버전을 표시합니다. 현재 기준으로 4.12.1이며, LazyCodex의 OmO 플러그인 패키지에서 가져온 값입니다.
처음 쓰기
LazyCodex는 어떤 작업에 잘 맞나요?+
범위가 크거나 오래 걸리고, 계획과 검증이 중요한 작업에 잘 맞습니다. 작은 질문이나 한 줄 수정은 평소처럼 Codex에 바로 요청해도 됩니다.
뇌 빼고 써도 되나요, 뇌 넣고 써야 하나요?+
둘 다 됩니다. 대략 맡겨도 돌아가야 하지만, 목표와 완료 기준을 분명히 줄수록 결과가 좋아집니다. 내부 스킬을 전부 공부하기보다, 막히는 지점이 보일 때 필요한 만큼만 보면 됩니다.
처음에는 어떤 명령만 알면 되나요?+
큰 저장소라면 먼저 $init-deep로 프로젝트 메모리를 만듭니다. 구현 전에 판단이 필요하면 $ulw-plan, 작성된 계획을 실행하려면 $start-work, 열린 작업을 증거로 완료할 때까지 밀려면 $ulw-loop를 씁니다.
설치가 됐는지는 어떻게 확인하나요?+
Codex를 열고 입력창에서 $를 눌러 OmO 명령과 스킬이 보이는지 확인합니다. CLI에서는 ulw를 쳤을 때 ultrawork mode가 켜지는지도 볼 수 있습니다. 첫 실사용 명령은 보통 $init-deep입니다.
설치 후 $ 메뉴에 명령이 안 보이면 어떻게 하나요?+
새 Codex 세션을 열어 플러그인을 다시 불러오고, 시작 리뷰에서 omo 훅 승인이 pending인지 확인합니다. 그래도 안 보이면 npx lazycodex-ai doctor로 설치와 스킬 로딩 상태를 점검합니다.
실행과 검증
npx lazycodex-ai doctor는 실제로 있는 기능인가요?+
있습니다. lazycodex-ai가 doctor를 OmO doctor 흐름으로 넘깁니다. 로컬 LazyCodex/Codex 설정 상태를 확인하고, 문제가 있으면 실패 코드로 끝날 수 있습니다.
훅 승인은 왜 필요한가요?+
Codex는 시작할 때 훅을 검토합니다. LazyCodex의 omo 훅은 승인 전에는 실행되지 않습니다. 설치 뒤 시작 리뷰에서 omo 훅을 승인해야 라이프사이클 확인이 동작합니다.
업데이트 후에는 무엇을 확인해야 하나요?+
업데이트 후 훅이 Modified로 보이면 다시 승인해야 합니다. 상태가 이상하면 먼저 npx lazycodex-ai doctor를 실행해 설치, 훅, 스킬 로딩 상태를 확인합니다.
$ulw-loop가 대충 끝내면 어떻게 하나요?+
반복만으로 부족한 데이터나 모호한 완료 기준이 자동으로 좋아지지는 않습니다. 필요한 수집 범위, 통과해야 할 검증, 데이터가 부족할 때 조사할 조건을 작업 설명에 적거나 먼저 $ulw-plan으로 계획을 잡습니다.
더 높은 요금제나 큰 토큰 한도가 필요한가요?+
LazyCodex를 토큰 절약 도구로 보면 안 됩니다. 좋은 모델과 충분한 토큰으로 계획, 실행, 검증을 밀어붙이는 흐름에 가깝습니다. 큰 작업은 하나의 thread가 너무 무거워지기 전에 작업 단위로 나누는 편이 안정적입니다.
thinking/reasoning 레벨은 어떻게 고르나요?+
너무 깊게 고민하지 않아도 됩니다. low는 피하고, 평소에는 medium, 실패 비용이 크거나 검토가 중요한 작업은 high를 씁니다. xhigh는 정말 무거운 작업에 남겨 둡니다.
LazyCodex도 computer-use를 하나요?+
가능합니다. 다만 실제 브라우저나 OS 조작은 현재 Codex 세션에 computer-use 도구가 연결되어 있어야 합니다. LazyCodex는 그런 도구를 작업 흐름 안에서 쓰도록 지시하고 검증을 강하게 거는 쪽입니다.
충돌과 제한
Codex App에서도 쓰고 모바일/리모트로도 이어갈 수 있나요?+
LazyCodex는 Codex 안에 설치되므로 평소 쓰는 Codex 환경에서 실행하면 됩니다. 특히 Codex App의 데스크톱/모바일 리모트 흐름과 궁합이 좋습니다. 다만 일부 기능은 데스크톱 앱에서만 완전히 같을 수 있습니다.
팀모드가 보이는데 스레드 생성이 안 되면 어떻게 하나요?+
먼저 LazyCodex와 Codex를 최신 상태로 맞추고 npx lazycodex-ai doctor로 플러그인, 훅, 설정 상태를 확인합니다. 팀모드는 Codex 데스크톱 앱 쪽 기능 차이를 탈 수 있으므로, 데스크톱 앱과 CLI에서 같은 기능이 보인다고 가정하지 않는 편이 안전합니다.
OMX와 같이 써도 되나요?+
권장하지 않습니다. LazyCodex와 OMX를 함께 두면 충돌해서 토큰만 쓰고 실패하는 문제가 날 수 있습니다. 설치 중 경고가 보이면 한쪽을 정리하고, LazyCodex는 Codex 위의 얇은 레이어로 단독 운용하는 편이 안전합니다.