Codex CLI vs Codex App: 터미널 도구와 에이전트 지휘실의 차이

Codex CLI vs Codex App: 터미널 도구와 에이전트 지휘실의 차이

[이미지 첨부 위치: 01-cli.png]

Codex CLI와 Codex App은 같은 Codex 계열이지만, 쓰임새는 꽤 다릅니다. CLI는 터미널 안에서 한 저장소를 빠르게 파고드는 도구에 가깝고, App은 여러 작업을 동시에 맡기고 진행 상황을 관리하는 데스크톱 지휘실에 가깝습니다.

2026년 5월 8일 기준으로 OpenAI 문서를 확인하면, Codex App은 macOS와 Windows에서 사용할 수 있고, Codex CLI는 로컬 터미널에서 프로젝트를 읽고 수정하고 명령을 실행하는 흐름에 초점이 맞춰져 있습니다.

1. Codex CLI: 터미널에 붙어 있는 코딩 에이전트

Codex CLI는 `npm i -g @openai/codex`로 설치해 터미널에서 바로 쓰는 방식입니다. 장점은 작업 맥락이 명확하다는 점입니다. 현재 디렉터리, 현재 브랜치, 현재 셸 로그를 그대로 보면서 수정과 검증을 반복하기 쉽습니다.

잘 맞는 작업은 작은 버그 수정, 테스트 실패 분석, 코드베이스 질문, 한 저장소 안에서의 빠른 리팩터링입니다. 손이 이미 터미널에 있고, 결과를 `git diff`, `npm test`, `npx tsc --noEmit` 같은 명령으로 바로 확인하고 싶다면 CLI 쪽이 자연스럽습니다.

2. Codex App: 여러 에이전트를 운영하는 데스크톱 화면

Codex App은 여러 Codex 스레드를 병렬로 운영하기 위한 데스크톱 인터페이스입니다. OpenAI 문서에 따르면 App은 프로젝트별 스레드, worktree 지원, 자동화, Git 기능을 포함한 “Codex command center” 역할을 합니다.

특히 여러 기능을 나눠 맡기거나, 장시간 걸리는 작업을 백그라운드에서 진행시키거나, diff 리뷰와 브라우저 확인까지 한 화면에서 이어가고 싶을 때 유리합니다. 단일 프롬프트 응답보다 “작업을 분해하고 감독하는 방식”에 가깝습니다.

3. 핵심 차이: 모델 차이보다 워크플로 차이

둘 중 하나가 항상 더 좋다고 보기 어렵습니다. CLI는 좁고 빠릅니다. 현재 저장소를 깊게 파고들며, 명령 실행과 diff 확인의 왕복이 짧습니다. App은 넓고 오래 갑니다. 여러 작업을 나눠 맡기고, 각각의 진행 상황과 결과물을 추적하기 쉽습니다.

즉 비교 기준은 “어떤 모델이 더 센가”가 아니라 “내가 지금 한 작업을 깊게 밀고 있는가, 아니면 여러 작업을 동시에 굴리고 있는가”입니다.

4. 선택 기준

간단히 정리하면 다음과 같습니다.

상황	Codex CLI	Codex App
시작 방식	터미널에서 즉시 실행	데스크톱 앱에서 프로젝트 선택
작업 단위	현재 repo 중심	프로젝트별 여러 스레드
병렬성	한 흐름에 집중	여러 에이전트 병렬 운영
검증	셸 명령, 테스트, diff 중심	diff 리뷰, 브라우저, Git, 자동화까지 확장
추천 상황	빠른 수정, 테스트 실패, 코드 질문	기능 단위 위임, 장기 작업, 병렬 개발

보안 모델은 두 표면 모두 중요합니다. OpenAI 문서상 Codex의 로컬 명령은 App, IDE, CLI 전반에서 샌드박스 경계 안에서 실행되며, routine command를 더 안전하게 자동화하기 위한 구조를 갖습니다.

5. 결론: 터미널 작업은 CLI, 작업 운영은 App

내가 직접 터미널에서 리듬을 잡고 한 가지 문제를 해결하는 중이라면 Codex CLI가 빠릅니다. 반대로 여러 기능, 여러 검증, 여러 에이전트를 동시에 운영해야 한다면 Codex App이 더 맞습니다.

정리하면 이렇게 보면 됩니다.

- Codex CLI: “내 터미널 옆의 페어 프로그래머”
- Codex App: “여러 Codex 작업을 지휘하는 데스크톱 콘솔”

둘은 경쟁 도구라기보다 같은 Codex를 다른 작업 속도와 관리 방식에 맞춰 쓰는 두 개의 입구입니다.

참고

- OpenAI Developers: Codex CLI 문서
- OpenAI: Introducing the Codex app
- OpenAI Developers: Codex App 문서
- OpenAI Developers: Codex sandboxing 문서