Codex CLI는 ChatGPT 구독으로 사용할 수 있나
Codex CLI는 API key 없이 ChatGPT Free, Go, Plus, Pro 등 적격 플랜으로 로그인할 수 있습니다. 구독 인증 범위와 비공식 bridge 도구가 자주 중단되는 이유를 설명합니다.
예, Codex는 ChatGPT 구독을 사용합니다
Codex는 ChatGPT 구독을 사용할 수 있으며, 이것이 지원되는 실행 방식입니다. codex login을 실행하고 브라우저 단계를 완료하면 CLI가 API 키 대신 ChatGPT 요금제를 사용합니다. 2026년 10월 기준으로 Codex가 포함된 요금제는 Free, Go, Plus, Pro, Business, Edu, Enterprise입니다. OpenAI는 2026년 2월 Codex 앱을 출시하면서 "limited time"으로 Free와 Go를 추가했으며, 현재도 두 요금제를 제공하고 있습니다. Free는 간단한 코딩 작업용이고 Go는 가벼운 작업용이므로, 이 요금제에서도 CLI에 API 키가 필요하지 않습니다.
npm install -g @openai/codex
codex login
codex login statuscodex login status은 CLI가 어떤 계정을 사용 중인지와 어떤 인증 방식을 사용할지 표시합니다. macOS에서는 brew install --cask codex으로 동일한 바이너리를 설치할 수 있습니다. 상태 출력에 구독을 사용하려는 경우에도 API 키가 표시된다면, CODEX_API_KEY이 설정되어 있는지 확인하고 설정되어 있으면 해제한 뒤 codex logout를 실행하고 다시 로그인합니다.
따라서 Codex에 대해서는 답이 예입니다. 보통은 반대 방향에서 이 질문이 나옵니다. 다른 에이전트를 설치했더니 sk-으로 시작하는 키를 요구했고, 이미 비용을 지불한 요금제로는 왜 충분하지 않은지 알고 싶은 경우입니다. 여기에는 실제 동작 원리가 있으며, 우회 방법을 찾기 전에 이를 이해할 필요가 있습니다.
코딩 에이전트가 별도의 API key를 요구하는 이유
ChatGPT 플랜과 OpenAI API는 서로 다른 청구 시스템을 사용하는 별개의 제품이다. 플랜은 ChatGPT 구독이다. API는 platform.openai.com에서 자체 잔액으로 관리되는 사용량 기반 서비스다. 두 제품은 지갑을 공유하지 않으며 자격 증명도 공유하지 않는다. 현재 적격 Pro 및 Business 구독은 연결된 API organization을 활성화한 뒤 API 크레딧을 제공하지만, 이 크레딧은 API key를 통한 Codex 사용에는 적용되지 않는다.
codex login가 저장하는 것은 API key가 아니다. ~/.codex/auth.json 또는 운영 체제의 자격 증명 저장소에 캐시되는 OAuth(개방형 인증) token이다. 자사 클라이언트인 CLI와 IDE extension은 이 token을 허용한다. api.openai.com는 이 token을 bearer key로 허용하지 않는다. public OpenAI API를 사용하는 에이전트에는 API 자격 증명이 필요하므로 aider가 API key를 요청한다. public API는 workload identity federation을 통해 발급된 단기 access token도 지원한다.
OpenCode와 Cline은 모두 ChatGPT 구독 로그인을 문서화하고 있으므로, 타사 에이전트에 항상 API key가 필요한 것은 아니다. OpenAI는 플랜 및 관리자의 제어에 따라 참여 앱과 사이트에서 ChatGPT 플랜 사용도 지원한다.
이러한 분리는 OpenAI에만 해당하지 않는다. Claude Code에서 동일한 구독 로그인과 API key 중 무엇을 선택하는지도 같은 이유로 동일하게 작동하며, 주요 코딩 에이전트의 과금 방식 비교에는 각 도구가 지원하는 구독 로그인을 확인하는 작업이 포함된다.
ChatGPT 요금제가 실제로 포함하는 내용
이 차트의 데이터
[
{
"plan": "Free",
"usd_per_month": 0,
"codex_cli": "yes"
},
{
"plan": "Go",
"usd_per_month": 8,
"codex_cli": "yes"
},
{
"plan": "Plus",
"usd_per_month": 20,
"codex_cli": "yes"
},
{
"plan": "Pro",
"usd_per_month": 100,
"codex_cli": "yes"
},
{
"plan": "Business",
"usd_per_month": 25,
"codex_cli": "yes"
}
]이는 2026년 10월 기준으로 게시된 정가이며, 개인 및 소규모 팀 요금제 5개에 해당한다. Business 요금은 월간 결제 기준 사용자 1명당 금액이며, 연간 결제 시 더 저렴하다. Plus는 월 20달러이고, Pro는 100달러부터 시작하며 더 높은 사용 한도를 제공하는 Pro 상위 요금제도 있다. 이 금액은 변경될 수 있으므로 구매하기 전에 가격 페이지를 확인해야 한다.
사용량을 측정하는 방식은 요금제에 따라 다르다. Plus와 표준 Business 요금제에는 5시간 단위의 사용 창이 적용된다. 현재 Pro에는 5시간 제한이 없지만, OpenAI는 주간 제한도 추가로 적용될 수 있다고 안내한다. Codex 세션 안에서는 /status에서 남은 한도를 확인할 수 있으며, 사용량 대시보드에는 현재 한도와 재설정 시간이 표시된다. Plus 또는 Business를 사용한다면 장시간 리팩터링을 시작하기 전에 이를 확인해야 한다. 한도에 도달하면 Codex가 현재 작업을 계속 실행하더라도 다음 턴을 시작하지 못할 수 있기 때문이다.
한 가지 세부 사항 때문에 혼동하는 경우가 많다. 로컬 CLI 세션과 클라우드 Codex 작업은 같은 요금제 사용 한도에서 차감되며, ChatGPT Work도 마찬가지다. 앱에서 수행하는 일반 채팅은 해당되지 않는다. OpenAI가 이를 별도로 측정하기 때문이다. 터미널에서 오후 내내 사용하면 그날 클라우드 작업과 Work에 사용할 수 있는 양이 줄어들지만, 채팅 한도에는 영향을 주지 않는다. Plus와 Pro에서는 한도에 도달했을 때 요금제를 상위 단계로 변경하는 대신 추가 크레딧을 구매할 수 있다.
실제로 유행하는 ChatGPT 브리지가 하는 일
브리지는 로컬에서 실행되는 작은 서버다. 브리지는 사용자의 계정으로 소비자용 웹 제품에 로그인한 다음, localhost에서 /v1/chat/completions와 같은 형태의 엔드포인트를 제공한다. 에이전트를 해당 주소로 지정하면 에이전트는 API와 통신한다고 인식하고, 브리지는 그 아래에서 브라우저 세션이 자체적으로 보내는 요청을 다시 실행한다. 일부 변형은 브라우저를 건너뛰고 내부 엔드포인트를 직접 호출한다. 구성 요소가 적을 뿐 같은 방식이다.
이 방식으로 소비자용 웹 세션을 자동화하는 행위는 OpenAI의 이용 약관에 위배되며, 그로 인해 잃을 수 있는 계정은 본인 계정이다. 이 가이드에서는 이러한 도구의 설치, 세션 자격 증명 처리, 쿠키 추출 또는 도구를 작동시키는 데 필요한 그 밖의 어떤 단계도 다루지 않는다.
엔지니어링 문제는 약관 문제와 별개이며, 그만큼 결정적이다. 브리지가 모방하는 인터페이스는 내부용이다. 해당 인터페이스가 계속 동일하게 유지된다는 보장은 없다. 유지할 이유가 없는 대상을 상대로 무상 통합을 유지 관리하는 셈이다.
경로 1: 공급업체가 제공하는 구독 로그인
공급업체가 자체 CLI를 제공하는 경우 이 경로에서는 이미 결제 중인 구독을 사용한다. Codex에서는 codex login이다. 다음 두 상황에서는 기본 명령만으로 충분하지 않다.
브라우저가 없는 서버에서는 ChatGPT 보안 설정 또는 workspace 권한에서 device code login을 활성화한 다음 다음 명령을 사용한다.
codex login --device-auth이 명령은 노트북의 브라우저에 입력할 코드를 출력한다. 다른 방법은 SSH를 통해 callback 포트를 전달하고 서버에서 일반 로그인 흐름을 실행하는 것이다.
ssh -L 1455:localhost:1455 user@remote
codex login이미 로그인되어 있고 파일 기반 credential storage를 사용하는 시스템에서 ~/.codex/auth.json을 복사할 수도 있다. 이 파일에는 유효한 access token이 들어 있으므로 password처럼 취급해야 한다. Mode는 600으로 설정하고, agent를 실행하는 사용자가 소유하도록 하며, git repository나 동기화 폴더 안에는 두지 않는다.
시스템이 계속 잘못된 credential을 선택한다면 ~/.codex/config.toml에서 고정한다.
forced_login_method = "chatgpt"반대 동작을 사용하려면 "api"로 설정한다. OPENAI_API_KEY만 export해도 저장된 ChatGPT 로그인보다 우선하지 않는다. 현재 authentication loader는 환경 키 override에 CODEX_API_KEY를 확인한 다음 저장된 authentication으로 대체한다. 고정 설정은 허용되는 로그인 방법을 제한하므로 codex login status를 확인해 현재 사용 중인 credential을 검증한다.
경로 2: 엄격한 지출 한도가 있는 API key
API key를 사용하면 플랜에서 제공하지 않는 두 가지 기능을 이용할 수 있다. Codex의 구독 사용 시간대 외부에서 사용할 수 있고, OpenAI API를 지원하는 agent에 사용할 인증 정보로 사용할 수 있다. 하지만 모든 agent에서 사용할 수 있는 범용 인증 정보는 아니다. Gemini CLI에는 Google 인증 또는 Google에서 발급한 인증 정보가 필요하다. 또한 token 단위로 요금이 부과되므로, retry loop에 빠진 agent는 매우 빠른 속도로 실제 비용을 발생시킨다. 어디에도 key를 붙여 넣기 전에 지출 한도를 설정해야 한다.
소액을 선불 충전하고 자동 충전을 끄되, 해당 잔액이 즉시 적용되는 지출 차단선이라고 생각해서는 안 된다. 크레딧이 소진된 뒤에도 API access가 계속되어 negative balance가 발생할 수 있으며, 이 금액은 다음 구매 금액에서 차감된다. 월별 organization 또는 project 지출 한도를 설정하고 Enforce a hard limit을 켠 다음 지출 알림을 추가한다. 알림만으로는 요청을 중지할 수 없으며, hard-limit 적용에도 약간의 지연이 발생할 수 있다.
선불 잔액 소진 시 차단을 적용하면 요청이 HTTP 429 및 credit_balance_exhausted error와 함께 실패한다. 이렇게 하면 추가 요청은 중지되지만, agent가 충전한 잔액과 정확히 같은 시점에 중지된다는 보장은 없다.
컴퓨터마다 project 하나와 key 하나를 만든다. 그러면 Platform usage에서 어느 컴퓨터가 얼마를 사용했는지 확인할 수 있다. 더 이상 사용하지 않는 laptop의 key를 폐기해도 server에는 영향을 주지 않는다. key를 pipe로 전달해 Codex에 로그인하면 key가 command argument나 shell history 항목으로 남지 않는다.
printenv OPENAI_API_KEY | codex login --with-api-keyexport를 본인 user만 읽을 수 있는 파일에만 저장한다. server에서 agent를 실행한다면 VPS에서 OpenCode 실행에서 ChatGPT Plus 또는 Pro 구독 로그인을 지원하는 agent의 key 처리 방법을 설명한다. 또한 coding agent 지출 추적을 통해 metered billing이 정액 플랜보다 실제로 저렴한지 판단할 수 있다.
경로 3: 대부분의 작업에는 로컬 모델을 사용하고, 어려운 작업에는 호스팅 모델을 사용합니다
코딩 에이전트가 수행하는 작업의 대부분은 기계적입니다. 파일을 읽고, 기호 이름을 바꾸고, 기존 테스트 3개와 비슷한 테스트를 작성하고, diff를 요약합니다. 로컬 모델은 추가 비용 없이 이러한 작업을 처리합니다. 판단이 필요한 작업에는 호스팅 모델을 사용합니다.
Codex는 이를 직접 지원합니다. codex --oss은 --local-provider을 통해 선택한 로컬 모델 제공자를 사용합니다. 구성된 oss_provider을 사용하거나 LM Studio와 Ollama를 제안하는 프롬프트를 사용할 수도 있습니다. 다음 명령에는 Ollama를 선택합니다.
ollama pull gpt-oss:20b
codex --oss -m gpt-oss:20b영구적으로 적용하려면 ~/.codex/config.toml에 제공자를 선언합니다.
model = "gpt-oss:20b"
model_provider = "ollama"
[model_providers.ollama]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"이 구성이 실용적인지는 2가지 제약에 따라 결정됩니다. Ollama의 Codex 페이지에서는 컨텍스트 윈도우를 최소 64k 토큰으로 설정할 것을 요구합니다. 에이전트는 파일 전체를 프롬프트에 붙여 넣기 때문에 컨텍스트를 빠르게 채웁니다. 따라서 메모리가 필요합니다. Ollama는 모델의 전문가 가중치에 매개변수당 4.25비트의 MXFP4 양자화를 사용하며, gpt-oss:20b은 최소 16 GB 메모리로 실행할 수 있다고 설명합니다. 컨텍스트 윈도우가 클수록 더 많은 메모리가 필요합니다. 더 큰 gpt-oss:120b 다운로드 크기는 65 GB입니다. 코딩 에이전트 VPS의 RAM 및 CPU 용량 산정에 실제 사용한 수치가 정리되어 있습니다.
로컬 모델과 호스팅 모델을 수동으로 전환해도 문제없이 사용할 수 있습니다. 이 선택을 자동화하려면 게이트웨이를 사용하면 됩니다. 자체 호스팅 LiteLLM 게이트웨이를 사용하면 모든 에이전트가 하나의 엔드포인트와 비용을 확인할 수 있는 하나의 위치를 공유합니다. 저렴한 작업은 로컬 모델로, 어려운 작업은 호스팅 모델로 라우팅하기에서는 에이전트의 작업 성능을 저하하지 않고 그 경계를 설정하는 방법을 설명합니다.
경로 선택
이미 ChatGPT 비용을 지불하고 있고 한 대의 시스템에서 작업한다면 codex login를 사용하고 /status를 주시하면 됩니다. 이것이 전부이며 추가 비용도 들지 않습니다.
여러 에이전트를 실행하거나, 무인 작업을 실행하거나, 자사 로그인 기능이 없는 도구를 사용한다면 API key를 구매하고 소액의 잔액을 선불로 충전한 다음 자동 충전을 끄십시오. 지출 상한도 설정하되, 적용이 지연될 수 있음을 고려하십시오. 사용량에 따른 청구액이 부담되기 시작하면 대부분의 작업에 local model을 추가하십시오.
각 경로에서 나타나는 실패 양상
사용량 한도에 도달한 구독: 포함된 사용량 또는 크레딧 기반 과금이 적용되는 요금제에서는 사용량 한도에 도달한 뒤에도 공정 사용 한도의 적용을 받으면서 Codex가 진행 중인 턴을 계속 처리할 수 있다. 사용량 대시보드에서 소진된 한도와 초기화 시간을 확인한다. 문제가 발생한 것이 아니다. 해당 턴이 끝난 뒤 사용 가능한 옵션을 확인한다. 초기화를 기다리거나, 사용 가능한 초기화를 적용하거나, 크레딧을 구매하거나, 요금제를 업그레이드하거나, 로컬 모델로 전환할 수 있다. 토큰 기반 과금이 적용되는 Enterprise workspace에는 별도의 workspace 예산과 사용자 한도가 있다. 어떤 한도가 적용되는지는 관리자에게 문의한다.
잔액이 없는 API key: 소진 처리가 적용되면 429이 credit_balance_exhausted과 함께 반환된다. 잔액을 의도적으로 충전한다. 하드 지출 한도가 설정되어 있으면 대신 organization_spend_limit_exceeded 또는 project_spend_limit_exceeded가 반환된다. 잔액을 충전해도 해당 한도는 올라가지 않는다. 구독 사용량 창 외부에서 사용하려는 경우 API key를 사용하면 해당 창의 적용을 받지 않는다. 그러나 API rate limit, 지출 한도, 사용 가능한 크레딧은 계속 적용된다.
잘못된 자격 증명 사용: codex login status은 현재 적용 중인 인증 방식을 나타낸다. ChatGPT 사용 가능량은 그대로인데 잔액이 없는 API key로 표시된다면 이것이 문제의 전부다. CODEX_API_KEY이 설정되어 있으면 설정을 해제하고, codex logout를 실행한 다음 codex login를 실행한다. 그런 다음 다시 잘못된 설정으로 돌아가지 않도록 forced_login_method를 고정한다.
브리지: 로컬 프록시의 401 또는 403이거나, 응답 도중 스트림이 중단되는 경우다. 원인을 확인하려면 브리지의 로그와 유지 관리 기록을 확인한다.
FAQ
Codex에서 API key 대신 ChatGPT Plus 구독을 사용할 수 있습니까?
가능합니다. codex login를 실행하고 브라우저 단계를 완료하면 Codex가 ChatGPT 요금제에 사용량을 청구합니다. 2026년 10월 기준으로 Codex는 Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함되어 있으므로 이러한 요금제에서는 CLI에 API key가 필요하지 않습니다. codex login status로 현재 활성화된 인증 정보를 확인합니다.
다른 coding agent는 왜 여전히 OpenAI API key를 요구합니까?
해당 agent의 공개 OpenAI API 연결에는 codex login에 저장된 OAuth token이 아니라 API 인증 정보가 필요하기 때문입니다. Aider는 이 API key 방식을 문서화하고 있습니다. OpenCode와 Cline도 subscription sign-in을 제공하므로 API credit을 구매하기 전에 agent의 인증 옵션을 확인합니다. 사용 가능한 Pro 및 Business 요금제는 활성화 후 API credit을 제공하지만, 해당 credit은 API key를 통한 Codex 사용에는 적용되지 않습니다.
ChatGPT 웹 세션을 통해 coding agent를 연결하면 규칙 위반입니까?
그렇습니다. 소비자용 웹 세션을 자동화하면 OpenAI 이용 약관을 위반하며 계정을 잃을 수 있습니다. 이러한 bridge는 호환성이 보장되지 않는 내부 인터페이스에 의존합니다. OpenCode와 Cline에서 문서화한 subscription sign-in은 소비자용 브라우저 세션을 재생하는 방식과 별개입니다.
Codex CLI 사용량이 ChatGPT 앱의 한도에서 차감됩니까?
채팅 한도에서는 차감되지 않습니다. 로컬 CLI 세션, cloud Codex task, ChatGPT Work는 하나의 allowance를 공유하지만 앱에서 일반 채팅을 사용하는 양은 별도로 계산됩니다. Plus 및 standard Business 요금제에는 5시간 window가 있고, Pro에는 현재 5시간 제한이 없으며, weekly limit이 적용될 수도 있습니다. Codex 세션 안에서 /status을 실행하면 남은 한도를 확인할 수 있고, reset 시간은 usage dashboard에서 확인합니다.
API key로 인해 큰 비용이 발생하지 않게 하려면 어떻게 해야 합니까?
소액의 balance를 선불로 충전하고 auto recharge를 끕니다. organization 또는 project의 monthly spend limit을 설정하고 Enforce a hard limit을 활성화하며, 두 번째 보호 계층으로 spend alert를 설정합니다. 선불 잔액 소진과 hard-limit 적용은 모두 즉시 이루어지지 않습니다. 선불 credit이 소진된 뒤 처리된 request는 negative balance를 만들 수 있으며, 이 금액은 다음 구매에서 차감됩니다. 소진 시 적용이 활성화되면 request가 HTTP 429 및 credit_balance_exhausted와 함께 실패합니다.