Codex CLI와 Codex App 차이: 무엇을 선택해야 할까
CLI와 desktop App을 실행 환경, 병렬 task, diff review, custom-provider 인증, 검증 절차와 자주 생기는 오류로 비교합니다.
목차
짧은 답: Terminal, SSH, container, codex exec 기반 script가 중심이면 Codex CLI를 선택하세요. 여러 task를 동시에 관리하고 built-in worktree와 visual diff를 쓰려면 desktop App이 편합니다. 둘은 서로 다른 model이 아니라 Codex를 사용하는 두 interface입니다. Custom provider를 쓸 때는 client에 따라 인증 방법도 달라집니다.
아래 내용은 2026년 8월 11일 OpenAI와 BetterToken의 최신 documentation으로 확인했습니다.
CLI와 App 비교
| 기준 | Codex CLI | Desktop App |
|---|---|---|
| Interface | Terminal과 TUI | Graphical desktop application |
| 적합한 환경 | Local shell, SSH, container, remote machine | Local computer, projects, threads |
| 병렬 작업 | /agent로 전환하는 built-in subagents, 별도 process, codex exec | 여러 threads, worktrees, visual result 관리 |
| 변경 검토 | Terminal diff와 Git command | Visual diff, comment, editor 연결 |
| 반복 작업 | Shell script와 외부 scheduler | Automations와 결과 검토 queue |
OpenAI에 따르면 App은 CLI와 IDE extension의 session history와 configuration을 이어받을 수 있습니다. 하지만 각 process의 환경변수, 재시작, 검증은 별도로 처리해야 합니다.
Custom provider는 어디에 적용되는가
BetterToken은 OpenAI-compatible tool을 위한 사용량 기반 API service입니다. Codex client, ChatGPT account, desktop application을 대신하지 않습니다. 현재 Codex 설정은 custom provider, Base URL `https://www.bettertoken.ai/v1%60,?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-050&utm_content=codex-cli-ili-codex-app Responses protocol을 사용합니다.
먼저 client를 구분하세요.
- Terminal에서
codexcommand를 실행하면 CLI입니다. - Desktop application의 Codex task는 App입니다.
- VS Code 안의 Codex panel은 Extension입니다.
CLI와 desktop App은 같은 ~/.codex/config.toml을 읽습니다. Windows에서는 %USERPROFILE%\.codex\config.toml입니다. 두 client에서는 BETTERTOKEN_API_KEY를 env_key로 custom provider에 전달합니다. VS Code Extension은 official sign-in을 유지하고 별도로 문서화된 authentication field를 사용합니다.
한 TOML에 [model_providers.custom]을 두 번 작성하지 마세요. CLI/Desktop guide와 VS Code guide를 구분해 확인하세요.
Desktop App과 IDE Extension은 shell profile에만 정의된 변수를 상속하지 않을 수 있습니다. BETTERTOKEN_API_KEY가 보이지 않으면 OpenAI 최신 안내에 따라 ~/.codex/.env에 두고 client를 완전히 재시작한 뒤 새 session을 만드세요.
설정 검증 순서
- 기존 Codex process를 완전히 종료합니다.
- 새 Terminal을 열거나 App을 재시작합니다. VS Code에서는
Developer: Reload Window를 실행합니다. - 새 session을 만들고 짧은 task를 보냅니다.
- CLI에서는
/status를 확인하고, 모든 client에서 test request를 시간과 model로 BetterToken Dashboard 기록과 대조합니다.
401, 403, model not found가 없는 것은 health check일 뿐입니다. /status 또는 Dashboard의 일치하는 request가 실제 provider를 증명합니다.
작업별 선택
CLI는 Terminal, remote machine, container, script에 적합합니다. Built-in subagents와 /agent로 병렬 작업도 가능하지만 directory와 최종 변경은 검토해야 합니다.
Desktop App은 bug fix, feature, review를 별도 thread로 진행할 때, built-in worktree로 conflict를 줄일 때, visual diff로 변경을 검토할 때 적합합니다.
둘 다 사용할 수도 있습니다. CLI가 remote 또는 automated execution을 담당하고 App이 task 관리와 review를 담당합니다. 실행 전 working directory, permission, provider, authentication을 확인하세요.
자주 생기는 오류
- CLI는 되지만 VS Code는 안 됨: 인증 field가 다릅니다. Extension 전용 guide를 적용하고 window를 reload한 뒤 새 session을 만드세요.
- Official sign-in을 다시 요구함: CLI/App에서는 새 process가
BETTERTOKEN_API_KEY를 읽는지 확인합니다. Extension에서는 official sign-in을 유지합니다. - Provider를 찾지 못함:
model_provider = "custom"과[model_providers.custom]이름을 맞추고 중복 section을 지운 뒤wire_api = "responses"를 확인합니다. - 파일을 저장해도 변화가 없음: App이 shell 변수를 보지 못하면
~/.codex/.env를 사용해 재시작하고 Model ID, key, Base URL, 인증 방식을 확인합니다.
최종 추천
Terminal, SSH, script에는 CLI를, threads, worktree, visual review에는 App을 선택하세요. 2026년 8월 11일 기준 Codex가 포함된 새 ChatGPT desktop App은 macOS와 Windows에서 제공됩니다. 새 설치는 chatgpt.com/download를 사용하세요.
