Codex CLI vs Codex 앱 차이점 총정리 | 어떤 걸 써야 할까?

OpenAI가 내놓은 Codex에는 두 가지 얼굴이 있습니다. 터미널에서 실행되는 Codex CLI, 그리고 데스크탑 앱으로 쓰는 Codex 앱. 이름은 비슷하지만 설계 철학부터 완전히 다릅니다. 처음 이 두 개를 접하면 "둘 다 AI 코딩 도구인데, 뭐가 다른 거지?"라는 의문이 드는 게 당연합니다. 이 글에서는 두 도구의 핵심 차이를 명확하게 정리하고, 어떤 상황에 무엇을 선택해야 하는지 안내합니다.

 

한 줄로 먼저 정리하자면 이렇습니다. Codex CLI는 지금 내 코드 옆에서 함께 작업하는 개발 파트너이고, Codex 앱은 내가 자리를 비운 사이에도 알아서 일을 진행하는 AI 팀에 가깝습니다.

 

OpenAI Codex란? 두 가지 도구를 낳은 배경

Codex 모델의 정체: GPT-5-Codex 기반

OpenAI Codex는 코드를 이해하고 작성하는 데 특화된 AI 모델입니다. 현재는 GPT-5.3-Codex 계열 모델이 핵심으로, 단순한 코드 자동완성 수준을 넘어서 저장소 전체를 읽고, 파일을 편집하고, 명령어를 실행하는 에이전트 수준의 역할을 합니다.

 

2025년에 새롭게 재정의된 이 플랫폼은 출시 첫 달에만 100만 명 이상의 개발자가 채택했습니다. AI 코딩 에이전트 시장에서 이례적으로 빠른 확산이었는데, 오픈소스 공개(Apache-2.0 라이선스)와 터미널 친화적인 설계가 개발자 커뮤니티의 반응을 이끌어냈다는 평가입니다.

왜 CLI와 앱, 두 가지로 나뉘었을까?

OpenAI 내부에서도 두 팀이 서로 다른 문제 영역을 다루도록 분리했습니다. CLI 팀은 "반복적이고 로컬 중심의 개발"에 집중했고, 앱 팀은 "비동기적이고 클라우드 기반의 대규모 에이전트 오케스트레이션"에 초점을 맞췄습니다.

 

OpenAI의 동일한 AI 모델을 기반으로 하되, 어떤 개발 환경에서 어떤 방식으로 일하는지에 따라 최적의 인터페이스가 달라진다는 판단이었습니다. 그래서 두 도구가 경쟁 관계가 아닌, 서로 다른 사용 맥락에서 쓰이도록 설계된 것입니다.

 

Codex CLI란? 터미널에서 만나는 AI 코딩 파트너

Codex CLI의 핵심 기능 한눈에 보기

이 도구는 오픈소스 터미널 기반 AI 코딩 에이전트로, 공식 GitHub 저장소(github.com/openai/codex)에서 소스 코드를 직접 확인할 수 있을 만큼 투명하게 운영됩니다. 개발자 로컬 환경에서 직접 실행되는 것이 특징입니다.

 

주요 기능은 다음과 같습니다.

• 풀스크린 터미널 TUI: 코드 편집 과정을 실시간으로 확인하고 승인할 수 있는 인터페이스
• 로컬 실행: 코드가 사용자 환경 밖으로 나가지 않아 민감한 프로젝트에 적합
• 음성 입력: 스페이스바를 누르고 있으면 프롬프트를 음성으로 입력 가능
• MCP(Model Context Protocol) 연동: 서드파티 도구와 확장 연동 지원
• codex exec 모드: CI/CD 파이프라인용 비대화형 스크립트 실행
• 코드 리뷰: 커밋 또는 푸시 전에 별도 에이전트가 코드를 검토
• 웹 검색 통합: 최신 정보가 필요한 작업에서 웹 검색 활용
• 트랜스크립트 저장: 대화 내용을 로컬에 저장해 이전 세션 재개 가능

 

처리 속도도 주목할 만합니다. 240토큰/초 이상의 높은 처리량은 반복 작업이 많은 백엔드 개발자들 사이에서 특히 호평을 받고 있습니다. 다만 터미널에 익숙하지 않은 분에게는 처음에 진입 장벽을 느낄 수 있다는 점도 솔직히 말씀드려야 할 것 같습니다.

/설치 방법 (macOS · Windows · Linux)

설치는 npm이나 macOS Homebrew를 통해 간단하게 진행됩니다.

# npm을 통한 설치 (macOS / Windows / Linux 공통)
npm i -g @openai/codex

# Homebrew를 통한 설치 (macOS 전용)
brew install --cask codex

Windows에서는 PowerShell과 네이티브 Windows 샌드박스를 통해 실행됩니다. 세 플랫폼 모두 지원한다는 점이 Codex CLI의 강점 중 하나입니다. GitHub Releases 페이지에서 바이너리를 직접 다운로드하는 방법도 있어서, npm 환경이 없어도 설치할 수 있습니다.

요금과 무료 사용 범위

Codex CLI는 두 가지 방식으로 사용할 수 있습니다.

 

ChatGPT 구독 방식: ChatGPT Plus($20/월) 또는 Pro($200/월) 구독에 포함되어 있습니다. Plus는 5시간당 30~150 메시지, Pro는 5시간당 300~1,500 메시지 한도로 사용할 수 있습니다.

 

API 키 방식: Codex CLI만의 혜택으로, ChatGPT 구독 없이 API 키만으로도 사용이 가능합니다. `codex-mini-latest` 모델 기준으로 입력 $1.50/1M 토큰, 출력 $6.00/1M 토큰이 청구됩니다. 프롬프트 캐싱 적용 시 75% 할인이 적용되어, 반복 작업이 많은 환경에서는 구독 방식보다 오히려 저렴할 수 있습니다.

 

Codex 앱이란? 클라우드에서 일하는 AI 팀장

Codex 앱의 핵심 기능 한눈에 보기

Codex 앱은 2025년에 출시된 데스크탑 GUI 기반 AI 코딩 에이전트 플랫폼입니다. CLI가 혼자 터미널 앞에 앉아 코딩하는 개발자를 위한 도구라면, Codex 앱은 여러 작업을 동시에 진행해야 하는 팀 리드나 프로젝트 매니저를 위한 플랫폼에 가깝습니다.

 

대표 기능들을 정리하면 다음과 같습니다.

• 멀티 에이전트 오케스트레이션: Worktrees 기술로 여러 에이전트가 격리된 환경에서 병렬 작업
• Automations: 스케줄 기반 자동화로 이슈 분류, CI/CD 모니터링 등 반복 업무 처리
• Skills: 문서화, PDF·스프레드시트 처리 등 코드 생성 이상의 기능 확장
• GitHub 직접 통합: 이슈나 PR에서 @codex를 태그하면 자동으로 작업 시작 및 PR 생성
• 클라우드 배포: Vercel, Netlify, Cloudflare, Render 등에 직접 배포 지원
• GPT Image 이미지 생성: 블로그 포스트, 마케팅 자료 등 이미지 생성 내장
• UI 스크린샷 미리보기: Codex Web에서 프론트엔드 결과를 로컬 체크아웃 없이 확인
• ChatGPT iOS 앱 지원: 모바일에서도 Codex 앱 접근 가능

지원 환경과 Windows 현황

Codex 앱은 현재 macOS 전용 앱이 주력입니다. 브라우저에서 쓸 수 있는 Codex Web도 함께 제공되어, macOS가 없는 환경에서는 웹 버전으로 접근할 수 있습니다.

Windows 사용자 참고: 2026년 3월 현재, Codex 앱의 Windows 전용 데스크탑 앱은 아직 출시되지 않았습니다. 공식 출시 일정도 발표된 바 없습니다. Windows에서는 Codex Web(브라우저 버전) 또는 Codex CLI를 사용하는 것이 현재로서는 유일한 방법입니다.

요금과 구독 조건

Codex 앱은 ChatGPT Plus 또는 Pro 구독에 포함되어 별도 설치 비용 없이 사용할 수 있습니다. 단, CLI와 달리 API 키만으로는 사용이 불가능합니다. 반드시 ChatGPT 구독이 필요하다는 점을 기억해두세요. 토큰 기반 과금을 통해 비용을 세밀하게 조절하고 싶다면 Codex CLI가 더 적합합니다.

 

Codex CLI vs Codex 앱 핵심 차이점 비교

한눈에 보는 비교표

항목	Codex CLI	Codex 앱
인터페이스	터미널 TUI (풀스크린)	데스크탑 GUI + 웹
실행 환경	로컬	클라우드 (격리 샌드박스)
오픈소스	O (Apache-2.0)	X
지원 OS	macOS · Windows · Linux	macOS (앱), 웹/모바일
작업 방식	실시간 대화형 (동기)	비동기 백그라운드
멀티 에이전트	실험적 지원	핵심 기능 (Worktrees)
자동화 (스케줄)	없음	Automations 내장
GitHub 통합	간접 (GitHub Action 별도)	직접 (@codex 태그)
코드 보안	로컬 실행 (외부 전송 없음)	클라우드 격리 (인터넷 차단)
이미지 생성	없음	GPT Image 내장
UI 미리보기	없음	Codex Web 지원
클라우드 배포	없음	Vercel 등 직접 배포
음성 입력	O (스페이스바)	X
API 키 사용	가능 (구독 없이도 사용)	불가 (구독 필수)
기본 요금	ChatGPT Plus 포함 또는 API 키	ChatGPT Plus 포함

개발 철학의 차이: 파트너 vs 팀

비교표만 보면 단순히 UI 차이처럼 보일 수 있지만, 실제로는 근본적인 개발 철학의 차이를 반영합니다.

 

Codex CLI는 "지금 내 코드에서 함께 작업하는 파트너"이고, Codex 앱은 "내가 자리를 비운 사이에도 알아서 작업을 진행하는 팀"에 가깝습니다.

CLI는 개발자가 화면 앞에 앉아서 AI와 실시간으로 소통하며 코드를 다듬는 방식입니다. 변경 사항이 생기면 즉시 확인하고, 방향이 잘못됐다 싶으면 바로 수정할 수 있습니다. 반면 Codex 앱은 대규모 리팩토링이나 여러 기능을 동시에 개발하는 작업을 백그라운드에서 처리하고, 개발자는 결과를 검토하는 역할을 맡는 구조입니다.

CLI가 더 나은 상황

아래 상황에서는 Codex CLI가 더 적합합니다.

• 로컬 코드베이스에서 실시간으로 작업하고 싶을 때
• 코드를 외부 서버로 보내기 꺼려지는 민감한 프로젝트
• CI/CD 파이프라인을 자동화해야 하는 DevOps 환경
• 터미널 워크플로우를 선호하는 시니어 백엔드·풀스택 개발자
• API 키 기반으로 비용을 직접 조절하고 싶을 때
• Linux 등 크로스플랫폼 환경

앱이 더 나은 상황

반대로 아래 상황에서는 Codex 앱이 더 적합합니다.

• 여러 기능을 동시에 병렬로 개발해야 하는 팀 리드 또는 엔지니어링 매니저
• GitHub 이슈와 PR 워크플로우를 AI로 자동화하고 싶은 팀
• 프론트엔드 개발에서 UI 결과를 바로 확인하며 반복 작업할 때
• Vercel, Netlify 등 클라우드 배포까지 한 번에 처리하고 싶을 때
• 터미널이 낯선 비개발자(PM, 디자이너)나 주니어 개발자

 

내 상황에 맞는 도구 선택 가이드

시나리오 1: 터미널이 익숙한 개발자

추천: Codex CLI

 

백엔드나 풀스택 시니어 개발자라면 Codex CLI가 훨씬 자연스럽게 맞습니다. 이미 터미널에서 대부분의 작업을 하고 있다면, Codex CLI는 기존 워크플로우에 AI를 끼워 넣는 것처럼 느껴집니다. 별도의 GUI 학습 없이 바로 적용할 수 있고, MCP를 통해 필요한 서드파티 도구를 연결해 확장할 수 있습니다.

 

보안이 중요한 기업 환경의 개발자에게도 CLI가 유리합니다. 코드가 로컬에서만 처리되기 때문에 외부로 유출될 여지가 없습니다. CI/CD 파이프라인에 통합할 때는 codex exec 모드를 활용하면 됩니다.

시나리오 2: GUI를 선호하거나 비개발 직군

추천: Codex 앱

 

터미널이 낯설거나 GUI 환경을 선호한다면 Codex 앱을 선택하는 게 맞습니다. PM이나 디자이너처럼 개발 배경이 없더라도, 직관적인 GUI를 통해 AI 코딩 지원을 받을 수 있습니다. 특히 여러 기능을 동시에 진행해야 하는 상황이라면 멀티 에이전트 오케스트레이션 기능이 큰 도움이 됩니다.

 

스타트업 창업자나 소규모 팀을 이끄는 분이라면 GitHub Automations까지 연동해서 이슈 트래킹부터 PR 생성까지 AI가 처리하게 만들 수 있습니다. 혼자 전체 스택을 관리해야 하는 환경에서 특히 강점을 발휘합니다.

시나리오 3: Windows 사용자라면?

Windows 사용자는 선택지가 두 가지입니다.

 

Codex CLI는 Windows를 공식 지원합니다. PowerShell과 네이티브 Windows 샌드박스를 통해 설치하면 macOS와 거의 동일한 경험을 할 수 있습니다. 터미널에 익숙한 Windows 개발자라면 CLI가 현실적인 선택입니다.

 

Codex 앱의 GUI 환경을 원한다면 Codex Web(브라우저 버전)을 사용하세요. 앱의 핵심 기능 대부분을 브라우저에서도 이용할 수 있습니다. Windows 전용 데스크탑 앱 출시는 2026년 3월 현재 공식 발표가 없는 상황입니다.

 

다른 AI 코딩 도구와 간략 비교 (Claude Code, Gemini CLI)

Codex CLI와 자주 비교되는 도구가 두 가지 있습니다. Anthropic의 Claude Code와 Google의 Gemini CLI입니다.

 

Claude Code는 터미널 기반이라는 점에서 Codex CLI와 가장 유사한 포지션에 있습니다. 파일 편집, 명령어 실행, 웹 검색을 통합한 에이전트 방식으로 작동하며, Anthropic 생태계와 깊게 연결됩니다. 오픈소스가 아닌 점이 Codex CLI와의 차이입니다. 실제로 개발자 커뮤니티에서는 "복잡한 리팩토링 작업에서 Claude Code가 더 신중하게 처리한다"는 평가가 있는 반면, "Codex CLI가 처리 속도 면에서 유리하다"는 의견도 공존합니다.

 

Gemini CLI는 Google 생태계와의 통합을 강점으로 내세웁니다. Google Workspace나 BigQuery 같은 서비스와 자연스럽게 연결되고, 멀티모달 지원도 제공합니다. Google Cloud 환경에서 주로 작업하는 팀이라면 Gemini CLI가 자연스러운 선택지가 될 수 있습니다.

 

세 도구 모두 터미널 기반 AI 코딩 지원이라는 큰 방향은 같지만, 어떤 생태계를 중심으로 일하는지, 어떤 작업에 비중을 두는지에 따라 적합한 도구가 달라집니다. 이 비교에 대해서는 별도 글에서 더 자세히 다룰 예정입니다.

 

자주 묻는 질문 (FAQ)

Q. Codex CLI는 무료로 쓸 수 있나요?

완전 무료는 아니지만, 접근 방법에 따라 비용을 조절할 수 있습니다. ChatGPT Plus($20/월) 또는 Pro($200/월) 구독에 포함되어 있고, API 키를 직접 사용하면 구독 없이도 토큰 과금 방식으로 사용할 수 있습니다. API 키 방식은 codex-mini-latest 모델 기준 입력 $1.50/1M 토큰, 출력 $6.00/1M 토큰이며, 프롬프트 캐싱 적용 시 75% 할인됩니다.

Q. Codex 앱 Windows 버전은 언제 나오나요?

2026년 3월 현재까지 공식 발표가 없습니다. Windows에서는 Codex Web(브라우저 버전) 또는 Codex CLI를 사용하는 것이 현재 가능한 방법입니다. Windows 전용 앱 출시 일정은 OpenAI 공식 채널을 통해 확인하시기를 권장합니다.

Q. Codex CLI와 VS Code를 같이 쓸 수 있나요?

가능합니다. Codex는 VS Code, Cursor, Windsurf 같은 VS Code 호환 에디터용 IDE 확장도 별도로 제공합니다. IDE 확장과 CLI는 동일한 config.toml 설정 파일을 공유하기 때문에, 두 방식을 병행하거나 자유롭게 전환할 수 있습니다. MCP 확장을 활용하면 외부 도구와의 연동도 CLI 환경에서 그대로 사용됩니다.

Q. ChatGPT Pro 구독자는 두 도구를 모두 무료로 쓸 수 있나요?

ChatGPT Plus 또는 Pro 구독 하나로 Codex CLI, Codex 앱, IDE 확장, Codex Web 모두 접근할 수 있습니다. Plus 기준 5시간당 30~150 메시지, Pro 기준 5시간당 300~1,500 메시지 한도 내에서 사용 가능합니다. API 키를 별도로 설정하면 구독 한도와 무관하게 추가 사용도 가능합니다.

 

결국 Codex CLI와 Codex 앱은 경쟁 관계가 아닙니다. 같은 AI 모델에서 출발해 서로 다른 개발자 경험을 위해 최적화된 두 갈래입니다.

 

터미널 워크플로우가 편하고, 코드를 로컬에서 직접 다루고 싶다면 Codex CLI를 선택하세요. GUI 환경에서 여러 에이전트를 오케스트레이션하거나 GitHub 자동화, 클라우드 배포까지 한 번에 처리하고 싶다면 Codex 앱이 맞습니다. Windows 사용자라면 당분간은 Codex CLI 또는 Codex Web으로 시작하는 것이 현실적인 선택입니다.

 

두 도구 모두 ChatGPT Plus 하나로 접근할 수 있으니, 각자 일주일 정도 써보고 자신의 개발 리듬에 맞는 쪽을 결정하는 것도 좋은 방법입니다.