OpenAI Codex 완전가이드 5편 — 가격 구조, CI/CD 자동화, Claude Code vs Codex 최종 비교

 

4편까지 Codex를 설치하고, 설정하고, 병렬로 돌리고, App과 Cloud까지 써봤습니다. 마지막 5편은 세 가지를 다룹니다. 얼마나 드는지 정확하게, CI/CD에서 어떻게 자동화하는지, 그리고 Claude Code/Copilot/Kiro와 비교해서 Codex가 맞는 사람이 누구인지입니다.

---

핵심 요약

→ 2026년 4월 2일부터 토큰 기반 과금 전환 (이전: 메시지당 정액)
→ ChatGPT Plus $20 포함 → CLI + App + IDE + Cloud 전부 사용 가능
→ Plus 한도: 5시간 롤링 윈도우 기준 제한 — 헤비 사용자는 한도 체감
→ Pro $100 → Plus 5배 한도 / Pro $200 → Plus 20배 한도 (영구)
→ API 키 모드: ChatGPT 구독 없이 토큰당 pay-as-you-go
→ CI/CD: codex exec 명령어로 헤드리스 실행 — TUI 없이 스크립트/파이프라인에서 동작
→ 공식 GitHub Action: openai/codex-action@v1 — Actions workflow에서 바로 사용
→ 핵심 CI/CD 활용: CI 실패 시 자동 수정 PR, PR 자동 코드 리뷰, 릴리즈 노트 자동화
→ Claude Code vs Codex: 복잡한 로컬 추론 → Claude Code / 병렬 Cloud 위임 → Codex
→ 두 툴 동시 사용하는 팀이 점점 많아지는 추세

---

실전 1 — 가격 구조 완전 해부

2026년 4월 2일 과금 체계 변경

변경 전 (~ 2026년 4월 1일):
메시지/태스크당 정액 과금
→ 짧은 질문 1개 = 긴 에이전트 세션 1개 (같은 비용)
→ 실제 토큰 사용량 무관

변경 후 (2026년 4월 2일 ~):
토큰 기반 과금
→ 실제 입력 + 출력 + 캐시 토큰 합산
→ 짧은 작업 = 저렴, 긴 에이전트 세션 = 비쌈
→ Copilot AI Credits 전환과 같은 흐름

플랜별 비교 (2026년 6월 기준)

플랜 월 가격 Codex 한도 특징

Free	$0	Codex Mini 제한적	에이전트 기능 제한
Plus	$20	기준값 (1x)	CLI + App + Cloud 전부 포함
Pro $100	$100	Plus 5배	GPT-5.3-Codex-Spark 접근
Pro $200	$200	Plus 20배 (영구)	풀타임 Codex 사용자용
Business	$30/유저	팀 단위 크레딧	관리자 대시보드, 데이터 미사용
Enterprise	별도 협의	커스텀	SCIM, 감사 로그, RBAC

5시간 롤링 윈도우: 한도는 마지막 5시간 내 사용량 기준으로 측정됩니다. 특정 시간에 몰아서 쓰면 일시적으로 느려지거나 대기 상태가 됩니다.

API 키 모드 (ChatGPT 구독 없이)

언제 유리한가:
→ CI/CD 파이프라인 (구독 계정 공유 불가)
→ 팀 서버에서 headless 자동화
→ 월 사용량이 $20 미만인 경우

설정:
export OPENAI_API_KEY="sk-proj-..."
codex  # 자동으로 API 키 모드로 동작

또는 config.toml에서 기본값 설정:
preferred_auth_method = "apikey"

모델별 API 요금 (토큰 기준)

모델 입력 캐시 입력 출력 특징

GPT-5.4 mini	$0.40/1M	$0.10/1M	$1.60/1M	빠름, 저렴, 단순 작업
GPT-5.4	$2/1M	$0.50/1M	$10/1M	균형, 일반 개발
GPT-5.3-Codex	$3/1M	$0.75/1M	$15/1M	코딩 특화
GPT-5.5	$5/1M	$1.25/1M	$30/1M	최고 성능, 복잡한 작업

실제 작업별 비용 시뮬레이션

단순 버그 수정 (GPT-5.4, 5K 토큰):
입력 4K × $2/1M + 출력 1K × $10/1M
= $0.008 + $0.01 = $0.018 (약 $0.02)

일반 기능 구현 (GPT-5.4, 30K 토큰):
입력 25K × $2/1M + 출력 5K × $10/1M
= $0.05 + $0.05 = $0.10

복잡한 리팩토링 (GPT-5.5, 100K 토큰):
입력 80K × $5/1M + 출력 20K × $30/1M
= $0.40 + $0.60 = $1.00

→ Plus $20으로 복잡한 작업 약 20회 가능
   일반 작업 기준으로는 200회 이상 가능

비용 모니터링

# 현재 한도 사용량 확인
chatgpt.com/codex → 우상단 프로필 → Usage Dashboard

# 또는 App에서
Codex App → 좌측 패널 → 프로필 → Usage

---

실전 2 — codex exec: 헤드리스 실행 기초

codex exec는 TUI 없이 터미널 명령처럼 Codex를 실행합니다. 스크립트, CI/CD, 자동화의 핵심입니다.

기본 사용법

# 기본: 작업 설명만 전달
codex exec "이 레포의 TODO 주석 전부 찾아서 목록 출력해줘"

# stdout으로만 출력 (파이프 연결용)
codex exec "최신 변경사항으로 CHANGELOG 항목 작성해줘"

# 파일로 저장
codex exec "아키텍처 분석 리포트 작성해줘" > report.md

# JSON 형태로 출력 (파싱 가능)
codex exec --json "API 엔드포인트 목록 추출해줘"

# 프롬프트를 파일로 전달 (긴 지시사항)
codex exec --prompt-file .github/codex/review-prompt.md

승인 모드 지정

# 파일 수정도 자동 (전형적인 CI용)
codex exec --full-auto "린팅 에러 전부 수정해줘"

# 파일 수정 자동, 명령 확인 (균형)
codex exec --approval-mode auto-edit "테스트 실패 수정해줘"

# 제안만, 수정 안 함 (코드 리뷰용)
codex exec --approval-mode suggest "이 PR 코드 리뷰해줘"

모델 지정

# 빠르고 저렴한 모델로 (린팅, 단순 수정)
codex exec --model gpt-5.4-mini "ESLint 에러 수정해줘"

# 최고 성능 모델로 (복잡한 리뷰)
codex exec --model gpt-5.5 "보안 취약점 전체 검토해줘"

세션 재개

# 이전 exec 세션에 이어서 작업
codex exec resume --last "이제 수정한 부분 테스트 코드도 작성해줘"

---

실전 3 — GitHub Actions: CI 실패 시 자동 수정 PR

Codex를 CI에 연결하는 가장 강력한 패턴입니다.

사전 설정

GitHub 레포 → Settings → Secrets and variables → Actions
→ New repository secret
→ Name: OPENAI_API_KEY
→ Value: sk-proj-... (API 키 입력)
→ Add secret

그리고:
Settings → Actions → General
→ "Allow GitHub Actions to create and approve pull requests" 체크

워크플로 파일 만들기

mkdir -p .github/workflows

# .github/workflows/codex-autofix.yml

name: Codex Auto-Fix CI Failures

# CI 워크플로 실패 시 트리거
on:
  workflow_run:
    workflows: ["CI"]     # 모니터링할 워크플로 이름
    types: [completed]

jobs:
  autofix:
    # CI가 실패했을 때만 실행
    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
    runs-on: ubuntu-latest
    permissions:
      contents: read      # 코드 읽기만 (보안)
      pull-requests: write # PR 생성 허용
    
    steps:
      - name: 코드 체크아웃
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.workflow_run.head_sha }}
      
      - name: Node.js 설치
        uses: actions/setup-node@v4
        with:
          node-version: '22'
      
      - name: 의존성 설치
        run: npm ci
      
      # Codex로 수정 실행
      - name: Codex로 수정 제안 생성
        uses: openai/codex-action@v1
        with:
          prompt: |
            테스트 스위트를 실행하고 실패하는 테스트를 찾아.
            각 실패 원인을 파악하고 최소한의 변경으로 수정해.
            로직은 바꾸지 말고, 테스트를 통과시키는 데 집중해.
            수정 후 npm test 다시 실행해서 전부 통과하는지 확인해.
          model: gpt-5.4
          sandbox: workspace-write
          output-file: codex-patch.diff
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
      
      # 수정사항이 있으면 PR 생성
      - name: 수정 PR 생성
        if: ${{ hashFiles('codex-patch.diff') != '' }}
        uses: peter-evans/create-pull-request@v6
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          commit-message: "fix: Codex auto-fix for CI failures"
          branch: codex/autofix-${{ github.run_number }}
          title: "🤖 Codex: CI 실패 자동 수정"
          body: |
            CI 실패를 감지해서 Codex가 자동으로 수정을 제안합니다.
            
            ⚠️ 머지 전에 반드시 변경사항을 검토하세요.
            
            관련 실패 워크플로: ${{ github.event.workflow_run.html_url }}

동작 흐름

CI 워크플로 실패
    ↓
codex-autofix 워크플로 자동 트리거
    ↓
Codex가 레포 읽기 → 테스트 실행 → 실패 원인 파악 → 수정
    ↓
수정사항 diff 저장
    ↓
새 브랜치(codex/autofix-xxx)로 PR 자동 생성
    ↓
개발자가 PR 검토 → 승인하면 머지

---

실전 4 — GitHub Actions: PR 자동 코드 리뷰

# .github/workflows/codex-review.yml

name: Codex Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 전체 히스토리 필요
      
      - name: 변경된 파일만 추출
        run: |
          git diff origin/main...HEAD > pr-diff.txt
          cat pr-diff.txt
      
      - name: Codex 코드 리뷰 실행
        uses: openai/codex-action@v1
        with:
          prompt-file: .github/codex/prompts/code-review.md
          model: gpt-5.5  # 리뷰는 최고 품질 모델 권장
          sandbox: read-only  # 파일 수정 없음
          output-file: review-result.md
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
      
      - name: PR 댓글로 리뷰 결과 게시
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review-result.md', 'utf8');
            
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## 🤖 Codex 코드 리뷰\n\n${review}`
            });

코드 리뷰 프롬프트 파일 만들기

mkdir -p .github/codex/prompts

cat > .github/codex/prompts/code-review.md << 'EOF'
당신은 시니어 백엔드 엔지니어입니다. 아래 기준으로 PR을 리뷰하세요.

## 리뷰 기준

### 반드시 확인
- 버그 가능성 (null 참조, 경계값, 타입 불일치)
- 보안 취약점 (SQL injection, XSS, 민감 정보 노출)
- 성능 문제 (N+1 쿼리, 불필요한 루프, 메모리 누수)

### 확인 사항
- 에러 처리 누락
- 테스트 커버리지 부족
- 가독성 문제

## 출력 형식
각 이슈: 파일명:줄번호 | 심각도(🔴높음/🟡중간/🟢낮음) | 설명 | 개선 방법

이슈가 없으면: "✅ 코드 리뷰 통과 — 특이사항 없음"
EOF

---

실전 5 — 기타 CI/CD 자동화 패턴

패턴 1: CHANGELOG 자동 생성

# 릴리즈 태그 푸시 시 자동 실행
on:
  push:
    tags: ['v*']

steps:
  - name: CHANGELOG 생성
    uses: openai/codex-action@v1
    with:
      prompt: |
        직전 태그 이후 커밋들을 분석해서 CHANGELOG.md에
        새 버전 항목을 추가해줘.
        형식: ## [버전] - 날짜 / ### Added/Fixed/Changed
      model: gpt-5.4
      sandbox: workspace-write

패턴 2: 린팅 에러 자동 수정

on:
  schedule:
    - cron: '0 9 * * 1'  # 매주 월요일 오전 9시

steps:
  - name: 린팅 에러 수정
    run: |
      npm install -g @openai/codex
      codex exec \
        --full-auto \
        --model gpt-5.4-mini \
        "ESLint 에러 전부 수정해줘. 로직은 바꾸지 말고 스타일만."
    env:
      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

패턴 3: 문서 자동 업데이트

on:
  push:
    paths: ['src/api/**']  # API 파일 변경 시만

steps:
  - name: API 문서 업데이트
    run: |
      codex exec \
        --model gpt-5.4 \
        --full-auto \
        "src/api 폴더의 변경된 파일을 보고 docs/api.md를 최신 상태로 업데이트해줘"
    env:
      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

---

실전 6 — Claude Code vs Codex 최종 비교

철학 차이

Claude Code:
"지금 내 옆에 있는 최고의 페어 프로그래머"
→ 로컬 파일시스템에서 직접 실행
→ 복잡한 추론, 긴 컨텍스트 이해
→ 실시간 인터랙션 중심

Codex:
"내가 위임하면 알아서 처리하는 비동기 에이전트"
→ 병렬 Worktree, Cloud 백그라운드 실행
→ GitHub 생태계 깊은 통합
→ 위임-검토-머지 사이클 중심

벤치마크 현실

SWE-bench Verified:
→ Claude Opus 4.8: 88.6%
→ GPT-5.5: 88.7%
→ 거의 동점 — 모델 차이보다 워크플로 차이가 더 중요

SWE-bench Pro (더 현실적):
→ Claude Opus 4.8: 69.2%
→ GPT 계열: 근접한 수치

Terminal-Bench 2.1 (CLI 에이전트 실제 능력):
→ GPT-5.5: 78.2%
→ Claude Opus 4.8: 74.6%
→ CLI 집중 자동화는 Codex 약간 우세

기능 비교 표

기능 Claude Code Codex

기본 모델	Claude Sonnet/Opus	GPT-5.4/5.5
인라인 자동완성	❌	❌ (Copilot 담당)
터미널 네이티브	✅	✅
Git Worktree 병렬	✅ (수동)	✅ (App UI 지원)
Cloud 백그라운드	✅ (제한적)	✅ (네이티브)
GitHub 이슈→PR	✅	✅
Computer Use	✅	✅ (macOS+Windows)
공식 GitHub Action	❌	✅ openai/codex-action
MCP 지원	✅	✅
가격 구조	정액제 ($20~$200)	ChatGPT 구독 포함
오픈소스 CLI	✅	✅

유형별 선택 가이드

Claude Code가 맞는 사람:
✅ 복잡한 멀티파일 추론이 중요한 경우
✅ 이미 Anthropic 구독 중
✅ 비용이 예측 가능해야 하는 경우 (정액제)
✅ 긴 컨텍스트 코드베이스 이해
✅ "같이 작업하는 느낌" 원할 때

Codex가 맞는 사람:
✅ 이미 ChatGPT Plus/Pro 구독 중
✅ GitHub 기반 팀 워크플로
✅ CI/CD 자동화 파이프라인 필요
✅ App UI로 Worktree 쉽게 관리하고 싶을 때
✅ 비동기 Cloud 작업 위임 (퇴근 후 실행)
✅ CLI 기반 자동화 스크립트

둘 다 쓰는 경우 (점점 많아지는 패턴):
→ Claude Code: 복잡한 실시간 개발
→ Codex: 반복적인 CI 자동화, 백그라운드 작업
→ 비용: Plus $20 + Claude Code Pro $20 = $40/월

---

실전 7 — 자주 묻는 질문

Q. ChatGPT Free로도 Codex 쓸 수 있나요?

A. Codex Mini 한정으로 가능합니다.
   전체 에이전트 기능(Codex CLI, App, Cloud)은 Plus 이상 필요합니다.

Q. API 키 모드와 ChatGPT 구독 중 뭐가 더 저렴한가요?

A. 사용량에 따라 다릅니다.
   - 월 $20 미만으로 쓸 것 같다면 → API 키 (구독 불필요)
   - 매일 여러 작업 돌린다면 → Plus $20 (한도 내에서 더 저렴)
   - CI/CD 자동화는 → API 키 (계정 공유 없이 독립적으로 사용)

Q. 사용량 한도에 걸리면 어떻게 되나요?

A. 소프트 한도: 응답 속도 느려짐 (큐에 대기)
   하드 한도: "Usage limit reached" 메시지, 작업 불가
   리셋: 5시간 롤링 윈도우 기준 → 시간이 지나면 자동 회복
   Plus 크레딧 추가 구매: chatgpt.com/pricing → 추가 크레딧 구매 가능

Q. 코드가 OpenAI 서버로 전송되나요?

A. 표면에 따라 다릅니다.
   CLI/IDE: 프롬프트와 컨텍스트가 API 전송됨 (코드 자체는 로컬)
   Cloud: GitHub 레포 내용이 OpenAI 서버로 전송됨
   
   Business/Enterprise: 데이터 학습에 미사용 보장
   Plus/Pro: 기본적으로 학습에 사용될 수 있음
            → Settings → Data Controls → "Improve model for everyone" OFF

---

마무리: 5편 요약 + 전체 가이드 총정리

5편 핵심 3가지

1. 가격: Plus $20 포함, API 키로 pay-as-you-go 가능
         토큰 기반 과금으로 실제 사용량 = 실제 비용

2. CI/CD: codex exec + openai/codex-action@v1
          CI 실패 자동 수정, PR 리뷰, CHANGELOG 자동화

3. 선택: Claude Code vs Codex는 대체재가 아닌 보완재
         실시간 개발 → Claude Code / 비동기 자동화 → Codex

OpenAI Codex 완전가이드 5편 전체 흐름

1편: 설치 + 첫 실행 → "오늘 당장 쓸 수 있다"
2편: 승인 모드 + AGENTS.md → "내 프로젝트에 맞게 설정"
3편: Git Worktree → "여러 작업 동시에, 충돌 없이"
4편: App + Cloud + MCP → "PC 꺼도 작업, 외부 도구 연결"
5편: 가격 + CI/CD → "비용 계산, 파이프라인 자동화"

---

관련 글

• OpenAI Codex 완전가이드 1편 — 설치부터 첫 실행까지
• OpenAI Codex 완전가이드 2편 — 승인 모드, 샌드박스, AGENTS.md
• OpenAI Codex 완전가이드 3편 — Git Worktree 병렬 에이전트
• OpenAI Codex 완전가이드 4편 — Codex App, Cloud, MCP 연동
• OpenAI Codex 완전가이드 5편 — 가격, CI/CD 자동화, Claude Code vs Codex 최종 비교