DEV Community

Cover image for Codex로 GPT-5.5 무료로 사용하는 방법
Rihpig
Rihpig

Posted on • Originally published at apidog.com

Codex로 GPT-5.5 무료로 사용하는 방법

OpenAI는 2026년 4월 23일 GPT-5.5를 출시하면서, Codex를 한시적으로 무료 및 Go를 포함한 모든 ChatGPT 플랜에 도입했습니다. Codex CLI를 설치하고, ChatGPT 계정으로 로그인하면 API 키나 신용카드 없이 터미널에서 곧바로 GPT-5.5를 사용할 수 있습니다. 이 글은 Codex CLI의 설치부터, 인증, 모델 전환, 제한 사항, 실제 워크플로우 적용까지의 실질적인 사용법을 다룹니다.

오늘 Apidog을 바로 사용해 보세요

모델 기본 개요는 GPT-5.5란 무엇인가를 참고하세요. 다른 무료 경로(시험 크레딧, 통합 서비스)는 GPT-5.5 무료 가이드에서 확인할 수 있습니다.

요약

  • Codex CLI로 로컬 저장소에 GPT-5.5를 400K 컨텍스트 창과 함께 실행
  • ChatGPT의 무료, Go, Plus, Pro, Business, Enterprise, Edu 모든 플랜에서 Codex 사용 가능 (무료/Go는 한시적)
  • npm install -g @openai/codex 또는 brew install codex로 CLI 설치
  • 브라우저 OAuth(로컬) 또는 장치 코드 흐름(헤드리스 서버)로 인증
  • /model gpt-5.5로 모델 전환, /status로 할당량·상태 확인
  • CLI 워크플로우를 Apidog과 연동하여 API 호출 사전 테스트 및 문서화 가능

Codex가 가장 쉬운 무료 경로인 이유

OpenAI의 GPT-5.5 API는 기본적으로 유료 서비스입니다. 일반 출시 시, 입력 토큰 백만 개당 5달러, 출력 토큰 백만 개당 30달러가 과금됩니다. Codex CLI는 API 키 없이도 ChatGPT 계정 인증만으로 동일한 모델을 사용할 수 있게 해주며, 플랜별 속도 제한만 다릅니다.

Codex는 실제 GPT-5.5 모델을 터미널에서 곧바로 쓸 수 있기 때문에, 실질적으로 가장 빠르고 간단한 무료 경로입니다.

Codex CLI 설치

아래 방법 중 하나로 Codex CLI를 설치하세요.

# npm (윈도우, macOS, Linux 모두 지원)
npm install -g @openai/codex

# 또는 Homebrew (macOS / Linux)
brew install codex
Enter fullscreen mode Exit fullscreen mode

설치가 완료되면 버전을 확인합니다.

codex --version
Enter fullscreen mode Exit fullscreen mode

0.28.0 이상이어야 GPT-5.5 모델 선택이 가능합니다.

ChatGPT 계정으로 인증하기

Codex CLI를 처음 실행하면 로그인 방법을 선택해야 합니다.

브라우저 OAuth (로컬 머신) 

codex
Enter fullscreen mode Exit fullscreen mode

브라우저가 자동으로 열리고, ChatGPT 계정 이메일로 로그인하면 세션이 캐시되어 재로그인 없이 연속 사용 가능합니다.

장치 코드 흐름 (헤드리스 박스/원격 서버) 

codex login --device-auth
Enter fullscreen mode Exit fullscreen mode

터미널에 표시된 코드와 URL을 복사해 다른 기기에서 인증하면, 서버에서도 로그인이 완료됩니다.

API 키 대체

API 키로 인증하고 싶다면:

printenv OPENAI_API_KEY | codex login --with-api-key
Enter fullscreen mode Exit fullscreen mode

이 경우에는 키의 결제 계정에 사용량이 청구됩니다.

GPT-5.5를 모델로 선택

Codex는 기본적으로 각 플랜에 권장되는 모델로 설정됩니다. 무료·Go 플랜에서는 수동으로 gpt-5.5 전환이 필요할 수 있습니다.

세션 중 전환 

/model gpt-5.5
Enter fullscreen mode Exit fullscreen mode

시작 시 플래그로 지정 

codex --model gpt-5.5
Enter fullscreen mode Exit fullscreen mode

남은 할당량 확인 

/status
Enter fullscreen mode Exit fullscreen mode

주간 메시지 예산, 컨텍스트 창, 무료/Go 플랜의 경우 만료 시간이 출력됩니다.

첫 번째 세션: 실전 예시

Codex는 전체 화면 터미널 UI에서 파일 읽기, 명령 실행, 파일 편집을 지원합니다. 실질적인 예시는 다음과 같습니다.

cd ~/Projects/my-app
codex --model gpt-5.5
Enter fullscreen mode Exit fullscreen mode

세션 내 프롬프트 예시:

> README.md를 읽고, scripts/deploy.sh를 열어 다섯 가지 핵심 내용을 요약해줘.
Enter fullscreen mode Exit fullscreen mode

Codex가 파일을 읽고 요약을 출력합니다.

이어서:

> deploy.sh를 리팩토링하여 실패한 단계에서 종료되도록 하고, dry-run 플래그를 추가해줘. 하위 호환성을 유지해야 해.
Enter fullscreen mode Exit fullscreen mode

GPT-5.5가 차이점을 제안하면 승인 후 적용합니다. 테스트도 바로 실행:

> 배포 테스트 스위트를 실행하고 실패한 케이스를 보여줘.
Enter fullscreen mode Exit fullscreen mode

실패 케이스가 있으면 추가로 수정을 요청하는 등, 즉시 코드-테스트-수정 루프가 가능합니다.

이러한 다중 파일/도구/터미널 기반 작업에서 GPT-5.5는 이전 모델 대비 현저히 향상된 능력을 보입니다. (참고: OpenAI 출시 게시글)

Codex가 원시 API 호출로는 제공하지 않는 것

Codex CLI는 단순 API 호출 이상의 기능을 제공합니다.

  • 저장소 컨텍스트: 파일 트리 인덱싱 및 파일 핸들 전달(붙여넣기 불필요)
  • 명령 실행 시 승인: 모델이 제안한 명령을 실행 전 승인(보안 제어)
  • 쓰기 전 Diff 확인: 파일 변경점 미리보기, 수락/거부/수정 가능
  • 세션 지속성: 프로젝트별 세션 기록 및 컨텍스트 복원

API 직접 호출로는 이러한 워크플로우를 모두 직접 구현해야 합니다. 기본 API 사용법은 GPT-5.5 API 가이드에서 확인할 수 있습니다.

플랜별 속도 제한 및 상한

2026년 4월 23일 기준, 주요 플랜별 접근 권한 및 상한:

플랜 Codex에서 GPT-5.5 접근 주간 상한
무료 예 (한시적) 엄격함; 프로토타입 크기
Go 예 (한시적), 무료 제한의 2배 작음
Plus 예 중간
Pro 예, 개인 사용자 최고 상한 높음
Business 예, 좌석 기반 좌석당 높음
Enterprise / Edu 예, 계약 기반 맞춤

상한 도달 시 Codex는 플랜별 오류를 반환하며, /status 명령으로 남은 할당량을 실시간 확인할 수 있습니다.

에디터 및 IDE 통합

Codex 로그인 자격증명은 VS Code, JetBrains 등 주요 IDE 확장과 연동됩니다. CLI로 로그인하면 IDE 확장에서도 별도 로그인 절차 없이 바로 사용할 수 있습니다.

Apidog과의 페어링 워크플로우:

  1. Codex CLI에서 프롬프트 및 결과 프로토타입
  2. 프롬프트/출력을 Apidog 컬렉션으로 내보내어 팀과 공유
  3. API 계약이 확정되면 Codex 경로에서 직접 API 호출로 전환

VS Code에서 Apidog 연동 방법은 VS Code의 Apidog 문서를 참고하세요.

무료 및 Go 플랜에서 워크플로우를 안전하게 유지하기

무료/Go 플랜을 사용할 때 권장하는 보안 설정:

  • 파일 쓰기 항상 승인: ~/.codex/config.json에서 "autoApproveWrites": false로 설정 (무료 플랜은 기본 활성화)
  • 작업 공간 범위 지정: 프로젝트 디렉토리에서만 codex 실행 (최상위 폴더에서 실행 시 전체 홈폴더 접근 주의)

OpenAI는 GPT-5.5 출시 전 제3자 안전 검토를 진행했으나, 파일 변경은 항상 직접 검토 후 승인하는 것이 안전합니다. (참고: CNBC 보도)

무료 경로에서 벗어나야 할 때

무료/Go 플랜은 한시적 제공입니다. 다음 상황에서 유료 플랜/직접 API로 전환을 고려하세요.

  1. 주간 할당량 초과: 실제 코딩에 쓰려면 Plus/Pro 업그레이드
  2. 직접 API 필요: 자동화, 대량 처리엔 API 직접 사용 권장 (API 가이드 참조)
  3. 팀 좌석별 과금 필요: 가격 분석 참고 후 Business/Enterprise 검토

플랜 변경 시 모델은 동일, 결제 및 UI만 변경됩니다.

자주 묻는 질문

Codex도 GPT-5.5 Pro를 실행합니까?

아니요. Codex는 모든 플랜에서 표준 GPT-5.5만 지원합니다. Pro는 ChatGPT 웹 또는 API에서 제공됩니다.

ChatGPT 계정 없이 Codex를 사용할 수 있습니까?

불가. ChatGPT 로그인 또는 OpenAI API 키 중 하나가 반드시 필요합니다.

무료 및 Go 접근은 얼마나 지속됩니까?

"한시적"으로, 수 주~수 개월 예상. 사용량 증가 시 업그레이드 필요.

Codex는 오프라인에서 작동합니까?

아니요. 모든 호출은 OpenAI 서버로 요청됩니다.

Codex와 ChatGPT 웹 앱의 차이점은?

Codex는 로컬 파일 시스템, 셸 접근, 저장소 컨텍스트와 함께 터미널 기반으로 동작합니다. 웹 앱은 이러한 기능이 없습니다.

Top comments (0)