OpenAI는 2026년 4월 23일 GPT-5.5를 출시했으며, 출시의 일환으로 Codex를 한시적으로 무료 및 Go를 포함한 모든 ChatGPT 플랜에 도입했습니다. 이 발표의 한 문장이 새 모델에 접근하는 가장 빠른 무료 경로입니다. Codex CLI를 설치하고, ChatGPT 계정으로 로그인한 다음, API 키나 신용카드 없이 터미널에서 GPT-5.5를 사용할 수 있습니다.
이 가이드는 설치 방법, 인증 옵션, 모델 전환, 도달할 수 있는 제한 사항, 그리고 Codex를 실제 코딩 워크플로우에 통합하는 방법을 설명합니다. 기본 모델 개요는 GPT-5.5란 무엇인가를 참조하세요. 다른 무료 경로(시험 크레딧, 통합 서비스)에 대해서는 GPT-5.5 무료 가이드를 참조하세요.
버튼
요약
- Codex CLI는 400K 컨텍스트 창을 사용하여 로컬 저장소에 GPT-5.5를 실행합니다.
- ChatGPT 무료, Go, Plus, Pro, Business, Enterprise, Edu 모든 플랜에서 Codex에 접근할 수 있습니다. 무료 및 Go는 한시적입니다.
- `npm install -g @openai/codex` 또는 `brew install codex`로 설치하세요.
- 브라우저에서 ChatGPT OAuth를 통해 로그인하거나, 헤드리스 박스에서는 장치 코드 흐름을 사용하세요.
- 세션 중 `/model gpt-5.5`로 모델을 전환하고, `/status`로 할당량을 확인하세요.
- 궁극적으로 프로덕션에서 실행할 API 호출이 미리 빌드되고 테스트될 수 있도록 CLI를 Apidog와 페어링하세요.
Codex가 가장 쉬운 무료 경로인 이유
OpenAI의 API는 기본적으로 유료입니다. GPT-5.5는 일반 출시되면 응답 엔드포인트에서 입력 토큰 백만 개당 5달러, 출력 토큰 백만 개당 30달러가 청구됩니다. Codex는 API 키 대신 ChatGPT 계정으로 인증하는 CLI에 동일한 모델을 래핑하여 이 과정을 단축합니다. 플랜 등급이 속도 제한을 결정하며, 그 밑에서 실행되는 모델은 실제 GPT-5.5입니다.
Codex CLI 설치
두 가지 지원되는 설치 경로.
# npm (크로스 플랫폼)
npm install -g @openai/codex
# 또는 Homebrew (macOS / Linux)
brew install codex
설치 확인:
codex --version
`0.28.0` 이상의 버전을 확인해야 합니다. 이전 버전에서는 모델 선택기에 GPT-5.5가 표시되지 않습니다.
ChatGPT 계정으로 인증하기
CLI를 처음 실행하면 로그인 방법을 묻는 메시지가 나타납니다.
브라우저 OAuth (로컬 머신)
codex
브라우저 탭이 열립니다. ChatGPT에 사용하는 것과 동일한 이메일로 로그인하세요. CLI는 세션을 캐시하므로 이후 실행 시 프롬프트가 생략됩니다.
장치 코드 흐름 (헤드리스 박스, 원격 서버)
codex login --device-auth
터미널에 짧은 코드와 URL이 표시됩니다. 다른 장치에서 URL을 열고 코드를 붙여넣은 다음 확인하세요. 확인이 완료되면 헤드리스 머신에서 로그인이 완료됩니다.
API 키 대체
유료 API 키가 이미 있고 이를 선호하는 경우:
printenv OPENAI_API_KEY | codex login --with-api-key
이 경로는 ChatGPT 플랜 대신 키의 결제 계정에 요금을 청구합니다. Codex를 사용하고 싶지만 사용량을 팀의 유료 API 조직으로 귀속시키고 싶을 때 사용하세요.
GPT-5.5를 모델로 선택
Codex는 OpenAI가 사용자 플랜에 대해 "권장"하는 모델로 기본 설정됩니다. 모든 유료 플랜에서는 이미 `gpt-5.5`입니다. 무료 및 Go 플랜에서는 수동으로 전환해야 할 수 있습니다.
세션 중
/model gpt-5.5
CLI는 활성 모델과 플랜별 속도 제한을 출력합니다.
시작 플래그를 통해
codex --model gpt-5.5
남은 할당량 확인
/status
출력에는 주간 메시지 예산, 컨텍스트 창, 그리고 현재 무료/Go 체험 기간이 있는 경우 만료 시간이 표시됩니다.
첫 번째 세션: 현실적인 예시
Codex는 저장소를 읽고, 명령을 실행하며, 파일을 편집할 수 있는 전체 화면 터미널 UI로 시작됩니다. 일반적인 첫 세션은 다음과 같습니다.
cd ~/Projects/my-app
codex --model gpt-5.5
세션 내에서:
> README.md를 읽고, scripts/deploy.sh를 열어 다섯 가지 핵심 내용을 요약해줘.
Codex는 파일을 열고, 요약한 다음, 요약된 내용을 출력합니다. 다음은 후속 작업입니다.
> deploy.sh를 리팩토링하여 실패한 단계에서 종료되도록 하고, dry-run 플래그를 추가해줘. 하위 호환성을 유지해야 해.
GPT-5.5는 차이점을 제안하고, 승인을 기다린 다음, 적용합니다. 테스트를 인라인으로 실행하세요:
> 배포 테스트 스위트를 실행하고 실패한 케이스를 보여줘.
CLI는 테스트 출력을 세션으로 다시 스트리밍합니다. 실패하는 경우 모델에 수정하도록 요청하세요. 모든 것이 정상적으로 작동할 때까지 이 루프가 계속됩니다.
이것이 GPT-5.5가 최적화된 작업 부하입니다. OpenAI 출시 게시물에 따르면 SWE-bench 점수는 GPT-5.4의 74%에서 88.7%로 상승했습니다. 이러한 향상은 바로 이러한 다중 파일, 도구 사용, 터미널 기반 작업에서 나타납니다.
Codex가 원시 API 호출로는 제공하지 않는 것
CLI가 모델을 감싸는 네 가지 요소:
- 저장소 컨텍스트. Codex는 파일 트리를 읽고 관련 파일을 색인화하며, 붙여넣은 콘텐츠 대신 모델에 파일 핸들을 제공합니다. 400K 컨텍스트 창은 도구 호출 및 출력을 위해 대부분 비어 있습니다.
- 승인을 통한 명령 실행. 모델이 명령을 제안하면, 실행 전에 사용자가 승인합니다. 이것은 에이전트형 코딩이 셸을 넘쳐흐르는 것을 방지하는 안전 제어 장치입니다.
- 쓰기 전 Diff 미리보기. 모든 파일 편집은 통합된 차이점으로 미리 보여집니다. 커밋하기 전에 거부, 수락 또는 편집할 수 있습니다.
- 세션 지속성. 각 프로젝트는 세션 기록을 가집니다. 내일 CLI를 다시 열면 중단했던 지점부터 컨텍스트가 다시 시작됩니다.
Codex가 없으면 응답 API 위에 이 모든 것을 직접 재구축해야 합니다. 원한다면 GPT-5.5 API 가이드에서 기본 버전을 보여주지만, 일상적인 코딩에서는 CLI가 사용 편의성 면에서 우수합니다.
플랜별 속도 제한 및 상한
정확한 숫자는 변동될 수 있지만, 2026년 4월 23일 현재는 다음과 같습니다.
| 플랜 | Codex에서 GPT-5.5 접근 | 주간 상한 |
|---|---|---|
| 무료 | 예 (한시적) | 엄격함; 프로토타입 크기 |
| Go | 예 (한시적), 무료 제한의 2배 | 작음 |
| Plus | 예 | 중간 |
| Pro | 예, 개인 사용자 최고 상한 | 높음 |
| Business | 예, 좌석 기반 | 좌석당 높음 |
| Enterprise / Edu | 예, 계약 기반 | 맞춤 |
상한에 도달하면 Codex는 조용히 성능을 저하시키는 대신 플랜별 오류를 반환합니다. `/status`는 정확한 남은 횟수를 보여줍니다.
에디터 및 IDE 통합
동일한 Codex 로그인은 VS Code 확장 프로그램, JetBrains 플러그인 및 Codex 클라우드 앱을 지원합니다. CLI를 통해 로그인한 후, IDE 확장은 캐시된 자격 증명을 재사용하므로 두 번째 로그인 필요 없습니다.
Apidog 사용자에게 유용한 페어링은 다음과 같습니다.
- Codex CLI 내에서 요청을 프로토타이핑합니다 (`이 파일에 대해 GPT-5.5 프롬프트 실행`).
- 프롬프트와 구조화된 출력을 Apidog 컬렉션으로 내보내 팀원과 공유합니다.
- 계약이 안정화되고 유료 키로 전환되면 Codex 경로를 직접 API 호출로 바꿉니다.
Codex를 실행하는 동일한 에디터에 컬렉션을 연결하는 방법은 VS Code의 Apidog를 참조하세요.
무료 및 Go 플랜에서 워크플로우를 안전하게 유지하기
첫날 설정할 만한 두 가지 안전 장치:
- 파일 쓰기 항상 승인. `~/.codex/config.json`에서 `"autoApproveWrites": false`로 설정하세요. 무료 플랜에서는 기본적으로 이미 안전하지만, 일부 Go 플랜 설정에서는 Codex가 사소하다고 판단하는 차이점을 자동으로 적용할 수 있습니다.
- 작업 공간 범위 지정. 프로젝트 디렉토리에서만 `codex`를 실행하세요. CLI의 읽기 범위는 작업 디렉토리부터 시작됩니다. `~`에서 열면 전체 홈 폴더에 접근하게 됩니다.
OpenAI는 출시 전 GPT-5.5에 대해 제3자 안전 검토를 실시했으며, CNBC 출시 보도에서는 사이버 관련 레드팀 테스트에 대해 설명합니다. 그럼에도 불구하고 CLI는 여전히 사용자 컴퓨터에서 실행되므로, 변경 사항을 적용하기 전에 검토하는 일반적인 규칙이 여전히 적용됩니다.
무료 경로에서 벗어나야 할 때
OpenAI 발표에서 "한시적"이라는 표현은 Codex 무료 및 Go 플랜이 궁극적으로 업그레이드를 요구할 것임을 의미합니다. 고려해야 할 세 가지 전환점:
- 주간 할당량 초과. 실제 작업을 하고 있다면, Plus 또는 Pro로 전환할 때입니다.
- 직접 API를 원함. 작업량이 CLI를 넘어섰습니다. GPT-5.5 API 가이드에서 마이그레이션 방법을 다룹니다.
- 팀에 좌석별 청구가 필요함. 가격 분석을 통해 Business 또는 Enterprise 플랜을 고려하세요.
각 마이그레이션은 기본 모델을 동일하게 유지하며, 결제 및 인터페이스만 변경됩니다.
자주 묻는 질문
Codex도 GPT-5.5 Pro를 실행합니까?Pro는 현재 Codex 내에서 노출되지 않습니다. CLI는 모든 플랜에서 표준 GPT-5.5 모델을 사용합니다. Pro는 ChatGPT 및 (결국) 직접 API에서 사용할 수 있습니다.
ChatGPT 계정 없이 Codex를 사용할 수 있습니까?아니요. ChatGPT 로그인 또는 OpenAI API 키 중 하나가 필요합니다. Codex는 둘 중 하나를 필요로 합니다. 무료 경로는 ChatGPT 로그인에 의존합니다.
무료 및 Go 접근은 얼마나 지속됩니까?OpenAI는 이를 "한시적"이라고 명시했습니다. 몇 주에서 몇 달로 예상하고, 사용량이 증가하면 업그레이드를 계획하세요.
Codex는 오프라인에서 작동합니까?아니요. 모든 GPT-5.5 호출은 OpenAI 인프라로의 왕복 요청입니다.
이것은 ChatGPT 웹 앱과 어떻게 다릅니까?Codex는 로컬 파일 시스템, 셸 접근 및 저장소 컨텍스트와 함께 터미널 세션 내에서 실행됩니다. 웹 앱은 이러한 기능을 가지고 있지 않습니다.