[Codex 튜토리얼] (1) Codex 설치하기
0. 들어가며 - 어쩌다 Codex를?
지난 몇 달 간 Claude Code를 잘 사용하고 있었지만, 최근 가용 세션 한도가 너무 빠르게 소진되는 것이 느껴졌다. 관련 소식들을 찾아보니 나만 겪던 문제는 아닌 것 같았다. 그 와중 자주 보이던 단어가 있었는데, 그게 바로 Codex였다.
처음에는 Codex에 대해 약간 부정적인 견해를 가지고 있었다. 과거 Claude Code가 처음 등장했을 시점에 OpenAI에서 공개한 openai-cli의 성능은 단순 ChatGPT를 CLI 환경에 옮겨놓은 수준이라 비교가 불가능했던 데다, 이후 Codex CLI가 출시된 직후에 사용했을 때에도 Claude Code에 비해 그리 똑똑하지 않았고 주먹구구식 저품질 코드를 쏟아냈던 기억이 있었기 때문이다.
다시 현재로 돌아와, Claude를 사용하며 겪는 토큰 부족 이슈의 불쾌감이 누적되는 와중 Codex를 향한 좋은 평가들이 자주 눈에 띄었다. 옛날보다 훨씬 코드 품질도 좋아졌다는 평가가 많았던데다 Claude Code보다 더 좋은 퍼포먼스를 낸다는 후기도 여럿 보였다. 이 정도면 다시 써볼만 하지.
게다가 지난달 말 $20 수준 플랜인 ChatGPT Plus 플랜의 Codex CLI 사용 한도가 늘어났다는 소식을 들었다. Claude의 사용 한도에 불만을 가졌던 내겐 더없이 반가운 소식이었다. 이정도면 더 고민할 이유가 없다.
1. 결제
26년 초부터 Free 플랜에도 Codex CLI 사용 권한이 열렸다곤 하나, 세션당(5시간마다) 10건 내외의 메시지만 전송 가능하다고 한다.
이정도면 마트 시식코너에서 판촉 중인 만두 하나 찍어먹는 수준 아닌가.
Free 플랜 다음인 Go 플랜도 알아보았다. $8 플랜이며, Free와 Plus 플랜 사이에 들어가는 저가형 요금제다.
월 13000원 정도 플랜이며, Free 사용량의 10배이나 서비스 이용시 답변 하단에 광고가 달린다고 한다.
Plus의 반값 이하 수준인데, 둘을 비교해보자:
| 구분 | ChatGPT Go | ChatGPT Plus |
|---|---|---|
| 월 요금 | $8 | $20 |
| 주요 모델 | GPT-5.3 Instant | GPT-5.5 Thinking (추론 모델) |
| 메시지 한도 | 3시간당 약 160회 (Instant 모델) | 3시간당 160회 + 높은 추론 모델 한도 |
| 광고 여부 | 일부 지역 광고 포함 | 광고 없음 |
| 전문 도구 | 제한된 Codex 및 이미지 생성 | Deep Research, Agent 모드 외 다수 |
| 사용자층 | 라이트 유저, 학생 | 전문가, 개발자, 파워 유저 |
(by Gemini)
Codex를 사용하려는 내 입장에서 바라보자.
추론 모델을 사용하기 어려운 Go 모델은 간단한 개인용 워크플로 정도만 개발이 가능하겠다.
역시 옆집처럼 개발 도구로 사용하려면 최소 $20 수준은 들어가야겠더라.
Plus 결제.
2. Codex CLI 설치
우선 Codex는 App과 CLI로 사용 가능하다. 지금 시점에는 CLI가 App보다 '조금' 더 많은 것을 할 수 있는 수준이라고 한다.
간단하게 요약하면,
- 로컬에서 여러 레포를 건너다니며 작업하는 경우에는 App이,
- SSH가 필요하거나 굳이 GUI가 필요없거나 저사양 환경에서는 CLI가 우세하다.
사용성 측면에선 앱이 더 유리하지만 (가독성, 코드 리뷰 작업, `AGENTS.md` 수정, 스킬 설치 등)
tmux를 사용하거나 원격 작업이 필요한 경우에는 CLI가 필요한 셈이다.
근데 그것과는 별개로 Claude Code CLI에 익숙한 나에겐 앱보단 CLI 환경이 익숙하므로 우선 이쪽으로 진행한다.
자신이 터미널 환경에 익숙하지 않다면 App 사용을 강하게 권장한다.
그러나 본인이 개발자를 지망한다면 CLI 사용을 강하게 권장한다. 조금이라도 CLI에 익숙해져야 한다. 뭐든 직접 부딪히면서 배워야 한다.
아래는 CLI 설치 방법이고, App 설치는 여기에서 진행한다.
- npm
npm i -g @openai/codex
codex
# Upgrade
npm i -g @openai/codex@latest- homebrew
brew install codex
codex
# Upgrade
brew upgrade codex
Windows 환경에선 Windows sandbox에서 PowerShell을 이용하거나 WSL2를 사용하는 것을 권장한다.
npm으로 설치 시 Node.js 22+ 버전을 권장한다. 가능하면 최신 LTS를 사용하도록 하자.
EASY!
처음 `codex` 명령을 입력하면 아래와 같은 창이 나타난다.
일반적인 경우에는 그대로 1번을 선택해 엔터를 눌러주면 된다.
2번은 공용 PC에서 사용하면 되고, 3번은 API 키를 통해 사용량 기반 결제하는 경우 선택하면 된다.
그러면 이런 식의 안내가 나오고, 그와 동시에 새 탭으로 ChatGPT 로그인 페이지가 나타난다. 로그인하자.
이후 나타나는 사용 전 유의사항을 넘기고 디렉토리 신뢰 여부 응답을 하고 나면, 축하한다! 이제 Codex CLI를 사용할 준비가 되었다!
다음에는 Codex를 "잘" 사용하기 위한 OpenAI의 공식 가이드를 알아보겠다.