Codex란? OpenAI 코딩 에이전트 5분 정리 (2026)

 

검색창에 "codex"만 치면 결과가 두 갈래로 섞여 나온다.

2021년에 OpenAI가 내놨던 코드 자동완성 모델과, 지금 개발자들이 쓰는 코딩 에이전트가 이름이 같기 때문이다.

 

지금 말하는 쪽은 후자다.

터미널에 붙어서 저장소를 읽고, 파일을 고치고, 테스트까지 돌리는 그 도구다.

 

이 글은 "그게 뭔데"에 5분 안에 답하는 것만 한다.

설치와 깊은 활용은 아래에서 따로 연결한다.

 

빠른 판단

 

• Codex란 OpenAI의 에이전트형 코딩 도구다. 코드를 받아쓰는 게 아니라 스스로 파일을 고치고 명령을 실행한다.
• 2026년 10월 기준 여섯 갈래로 쓴다 — 데스크톱 앱 · 모바일 앱 · 웹 · CLI · IDE 확장 · Cloud.
• 무료 요금제에도 들어 있다. 다만 무료·Go는 데스크톱 앱에서 GPT-6 Luna 표준 속도만이다.
• 월 $20(약 2.7만 원) Plus부터 CLI·IDE 확장·iOS가 열린다.
• 모델은 Astra · Sol · Luna 3종, 사용량은 5시간 단위로 갱신된다.
• GPT-5.5는 2026년 10월 14일 Codex에서 종료됐다. 설정에 박아뒀다면 지금 바꿔야 한다.

 

Codex란 무엇인가

 

한 줄로 말하면 코드를 대신 쓰는 동료다.

 

OpenAI 공식 문서는 Codex를 "쓰고, 리뷰하고, 디버깅하고, 배포하는 일을 더 빠르게 하도록 만든 제품·워크플로 계층"으로 설명한다.

핵심은 에이전트라는 단어다.

질문에 답만 하고 끝나는 게 아니라, 저장소를 훑고 → 고칠 파일을 정하고 → 수정하고 → 명령과 테스트를 실행하는 작업 단위로 움직인다.

 

그래서 쓰는 방식이 챗봇과 다르다.

"이 함수 어떻게 쓰나요"가 아니라 **"로그인 실패할 때 에러 메시지가 안 뜬다.

원인 찾아서 고치고 테스트 돌려줘"** 쪽에 가깝다.

프롬프트를 작업 지시서처럼 쓸수록 결과가 좋아진다.

 

프롬프트를 어떻게 적어야 하는지는 Codex 프롬프트 작성법에 따로 정리해뒀다.

 

2021년의 Codex와는 다른 것이다

 

이 혼동이 생각보다 흔하다.

 

2021년의 Codex는 API로 호출하는 코드 자동완성 모델이었다.

GitHub Copilot의 초기 엔진이 그것이었고, 지금은 더 이상 제공되지 않는다.

 

지금의 Codex는 모델이 아니라 제품 이름이다.

안에서 돌아가는 모델은 GPT-6 계열로 따로 있고, 사용자가 골라 쓴다.

이름만 재활용된 셈이라, 오래된 블로그 글을 보고 "API 키 받아서 쓰는 모델"로 이해하면 처음부터 길이 엇갈린다.

 

여섯 갈래 중 어디서 써야 할까

 

같은 Codex를 여섯 군데서 쓴다.

계정 하나로 묶이니 어디서 시작하든 작업 기록은 이어진다.

 

• ChatGPT 데스크톱 앱 — 공식 문서가 추천하는 출발점이다. 로컬 파일과 긴 작업에 맞다.
• Codex CLI — 터미널에서 돌린다. 설치 스크립트 한 줄이면 끝난다.
• Codex IDE 확장 — VS Code·Cursor·Windsurf 계열 편집기에 붙는다.
• Codex Cloud — GitHub 저장소를 상대로 백그라운드에서 돌린다. 설치가 필요 없다.
• ChatGPT 웹 — 브라우저만 있으면 된다.
• ChatGPT 모바일 앱 — iOS·안드로이드. 여기서 자주 걸린다.

 

모바일을 짚어두자.

App Store에 "Codex" 앱이 따로 있는 게 아니다.

ChatGPT 앱 안에 Codex 화면이 들어 있는 구조다.

그리고 폰이 코드를 돌리는 게 아니라, 내 맥에서 돌고 있는 작업을 원격으로 지켜보는 쪽이다.

호스트는 macOS 기준이고 윈도우는 예정 상태다.

폰만 들고 시작할 수는 없다.

 

나는 처음 쓰는 사람에게 데스크톱 앱을 권한다.

CLI가 가장 강력하지만, 터미널에서 승인 프롬프트를 처음 보면 뭘 눌러야 할지부터 막힌다.

 

내 요금제로 되나

 

전 요금제에 들어 있다.

다만 어디서 쓸 수 있는지와 어떤 모델을 쓰는지가 갈린다.

 

요금제	월 비용(원화 환산)	Codex 접근 범위
Free	$0	데스크톱 앱 · GPT-6 Luna 표준 속도(순차 배포)
Go	$8 (약 1.1만 원)	데스크톱 앱 · Luna 표준 속도
Plus	$20 (약 2.7만 원)	웹 · CLI · IDE 확장 · iOS 전부 + 클라우드 연동
Pro	$100 / $200 / $500	*Plus 전부 + 5시간 한도 없음, Ultrafast는 $500부터
Business	$20/인/월 (연간)	데스크톱·모바일 + 큰 클라우드 VM, 워크스페이스 관리
Enterprise · Edu	별도 문의	크레딧 기반 확장, SCIM·감사 로그

 

환율 1,340원 기준이고 부가세는 별도다.

Business는 최소 2인 연간 결제 조건이며, 월 결제로 가면 $25가 된다.

 

돈 쓰기 전에 짚을 게 하나 있다.

무료로 먼저 만져볼 수 있다.

데스크톱 앱에 Luna가 깔리면 범위 좁은 작업은 충분히 돌아간다.

Plus로 올릴 이유는 성능이 아니라 CLI와 IDE 확장이 열리는 것이다.

터미널에서 쓸 생각이 없으면 급하지 않다.

 

모델은 세 개, 고르는 기준

 

고르는 축은 하나다 — 얼마나 어려운 일인가.

 

모델	성격	맞는 작업
GPT-6 Astra	최고 수준 지능	모호한 문제, 깊은 분석, 큰 결과물
GPT-6.1 Sol	최적화된 고성능	*복잡하면서 시간·비용도 봐야 할 때
GPT-6 Luna	똑똑하고 효율적	범위가 좁은 작업, 분류, 반복 자동화

 

여기에 추론 강도를 low부터 extra high까지 따로 조절한다.

모델과 강도를 곱하면 조합이 꽤 많아지는데, 실무에선 Sol + 중간 강도를 기본값으로 두고 막힐 때만 Astra로 올리는 식이 편하다.

 

Sol이 기본값이 될 만한 이유는 한도에 있다.

 

 

Plus와 Business 표준 기준으로, 5시간 동안 쓸 수 있는 로컬 메시지는 Astra가 5~45개, Sol이 15~160개, Luna가 350~3,000개로 추정된다.

작은 함수 하나는 할당량을 거의 안 먹고, 큰 작업은 메시지당 훨씬 많이 먹는다.

고정된 메시지 수가 아니라 추정 범위라는 점을 공식 문서도 명시한다.

 

속도 모드도 할당량을 곱한다.

Fast는 2.5배, Ultrafast는 8배로 소모된다.

급하지 않은 작업을 Ultrafast로 돌리면 한도가 순식간에 녹는다.

 

그리고 주간 한도가 따로 걸릴 수 있다.

Pro는 현재 5시간 한도가 없다.

 

처음 5분에 할 일

 

 

CLI로 가겠다면 설치는 한 줄이다.

 

curl -fsSL https://chatgpt.com/codex/install.sh | sh

 

npm이 익숙하면 npm install -g @openai/codex, 맥에서 Homebrew를 쓰면 brew install --cask codex도 된다.

윈도우는 PowerShell에서 irm https://chatgpt.com/codex/install.ps1 | iex로 받는다.

 

프로젝트 폴더에서 codex를 치면 첫 실행에 로그인 방식을 묻는다.

Plus·Pro·Business·Enterprise면 "Sign in with ChatGPT"를 고르는 게 맞다.

API 키 방식은 별도 과금이라 처음에 고를 이유가 없다.

 

들어가서 제일 먼저 칠 것은 /init이다.

프로젝트 규칙을 적어두는 AGENTS.md 파일을 만들어준다.

이 파일이 있고 없고에 따라 결과 품질이 눈에 띄게 갈린다.

그 다음 /permissions로 어디까지 건드려도 되는지 선을 긋고, /model로 모델과 추론 강도를 정한다.

커밋 전에는 /review로 변경분을 먼저 훑게 하면 사고를 줄인다.

 

자주 묻는 질문 (FAQ)

 

Codex란 이름이 Copilot과 어떻게 다른가요?

Copilot은 편집기에서 다음 줄을 제안하는 쪽이 중심이고, Codex는 작업 단위를 받아 스스로 파일을 고치고 명령을 실행하는 쪽이 중심입니다.

요즘은 둘 다 에이전트 기능을 넣어서 경계가 흐려지는 중이긴 합니다.

 

무료로 쓸 수 있나요?

됩니다.

데스크톱 앱에서 GPT-6 Luna 표준 속도로 쓸 수 있고, 순차 배포라 계정에 따라 시점 차이가 있습니다.

 

GPT-5.5를 쓰고 있었는데요.

2026년 10월 14일에 ChatGPT·ChatGPT Work·Codex에서 종료됐습니다.

워크스페이스 기본값, 저장된 모델 설정, 예약 작업, 스크립트에 GPT-5.5를 박아뒀다면 Sol이나 Astra로 바꿔야 합니다.

API 플랫폼과 API 키로 인증한 Codex 세션에서는 아직 남아 있습니다.

 

한국어로 지시해도 되나요?

됩니다.

다만 파일명·함수명·에러 메시지는 원문 그대로 붙여 넣는 편이 정확합니다.

 

Claude Code와 비교하면 어느 쪽이 낫나요?

작업 성격에 따라 갈립니다.

긴 리팩토링과 대규모 코드베이스 쪽에서 체감이 다르게 나오는데, 항목별로는 Codex와 Claude Code 심층 비교에 정리해뒀습니다.

 

오늘 바로 할 것

 

1. 쓰고 있는 ChatGPT 요금제를 확인한다. 무료여도 데스크톱 앱에서 Codex 화면이 보이는지부터 본다.
2. 데스크톱 앱으로 작은 프로젝트 하나를 열어 "이 프로젝트가 뭐 하는 건지 설명해줘"를 먼저 시킨다. 코드를 고치게 하는 건 그다음이다.
3. GPT-5.5를 지정해둔 설정·스크립트가 있으면 Sol이나 Astra로 교체한다. 10월 14일 이후로는 안 돈다.
4. 터미널에서 쓸 생각이면 설치 후 /init으로 AGENTS.md를 먼저 만든다.
5. Ultrafast는 급한 작업에만 쓴다. 할당량 8배다.

 

개념이 잡혔으면 다음은 실제로 돌려보는 단계다.

설치부터 작업 지시, 병렬 처리까지 한 번에 묶은 글이 OpenAI 코딩 에이전트 총정리(2026)에 있다.

여기서부터 이어가면 된다.

 

---

 

출처

• OpenAI Codex 공식 문서 — 개요·플랫폼
• Codex 퀵스타트
• Codex CLI 문서
• 모델 선택 가이드
• ChatGPT·Codex 요금제와 사용량 한도
• openai/codex GitHub 저장소
• GPT-5.5 종료 일자(2026-10-14)는 OpenAI 공지를 전한 2차 보도로 확인했다 — Gizmochina
• 원화 환산은 2026년 10월 16일 원·달러 1,340원대 기준 — 데일리안