Codex API 키와 ChatGPT 로그인: 설정과 과금 방식
ChatGPT 로그인, 공식 OpenAI API 키, 별도 과금되는 Responses 제공업체를 비교합니다. 사용자 수준의 config.toml에서 BetterToken을 설정하고 국가 및 카드 제한을 확인합니다. 실제 작업에 들어가기 전에 잔액, 인증 방식, 선택한 제공업체와 사용 기록을 대조해 과금 계정을 확인합니다.
목차

Codex에 로그인할 수 없거나 예상하지 못한 계정으로 사용 요금이 청구된다면, 플랜을 바꾸기 전에 인증 방식을 확인합니다. Codex를 로컬에서 사용하는 개발자는 ChatGPT 로그인으로 플랜 혜택을 이용하며, OpenAI API 키를 쓰면 OpenAI Platform에서 별도로 과금됩니다. 사용자 지정 Responses 제공업체를 이용한다면 codex login status와 함께 선택한 제공업체 및 사용 기록도 확인합니다.
요금을 부담할 계정부터 선택합니다
2026-11-22 기준 OpenAI 인증 문서는 구독을 통한 로그인과 API 키를 통한 접속을 구분합니다. 외부 제공업체를 추가하면 모델 사용료의 과금 경로가 따로 생깁니다. ChatGPT 구독이 제공되는 것은 아닙니다.
| 접속 방식 | 필요한 조건 | 사용료가 처리되는 곳 | 적합한 용도 |
|---|---|---|---|
| ChatGPT 로그인 | 지원 지역의 ChatGPT 계정. 유료 기능에는 이용 자격이 있는 플랜과 지원되는 결제 수단이 필요합니다 | 플랜에 포함된 사용량과, 해당하는 경우 ChatGPT 크레딧 또는 사용량 기반 과금 | 플랜에 포함된 로컬 사용량이나 계정에서 이용할 수 있는 Codex cloud 기능이 필요한 경우 |
| 공식 OpenAI API 키 | OpenAI Platform 키, API 과금 설정 또는 사용 가능한 API 크레딧, 지원 지역. 결제가 필요할 때는 지원되는 결제 수단이 필요합니다 | ChatGPT 사용 한도와 별도로 OpenAI Platform에서 API 요금 적용 | 로컬 CLI 작업이나 신뢰할 수 있는 환경의 자동화를 API 조직에 청구하려는 경우 |
| BetterToken 사용자 지정 제공업체 | 본인의 BetterToken 계정, API 키, 사용 가능한 잔액. 결제 옵션은 콘솔에 따라 달라집니다 | 선택한 모델의 토큰 요금에 따라 BetterToken 잔액에서 차감 | 별도 과금 방식으로 로컬 Codex를 이용하려는 경우. 루블 결제 옵션도 포함됩니다 |
로컬 CLI 세션에 BetterToken을 설정합니다
설치된 공식 Codex CLI에서 BetterToken을 통한 Codex 접속을 사용합니다. 현재 토큰 및 캐시 요금을 확인한 뒤 콘솔을 엽니다.
테스트에 사용할 수 있는 잔액이 충분한지 확인합니다. 부족하면 콘솔에서 이용 가능한 결제 옵션으로 충전하고 잔액에 반영되었는지 확인합니다. 그런 다음 BetterToken 계정 설정 안내에 따라 본인의 API 키를 생성합니다.
예제는 2026-11-22 기준 Responses 지원 모델로 등록된 gpt-6.2-sol을 사용합니다. 인증에는 BetterToken Codex 안내서에 문서화된 환경 변수 방식을 사용합니다.
Codex를 종료하고 설정 파일을 비공개 위치에 백업합니다. 아래 설정을 사용자 수준의 ~/.codex/config.toml에 병합하되, 루트 키는 모든 TOML 테이블 앞에 둡니다. 같은 키나 테이블이 이미 있다면 기존 항목을 수정하고 중복해서 추가하지 않습니다. CODEX_HOME을 설정했다면 해당 디렉터리의 config.toml을 수정합니다.
model = "gpt-6.2-sol"
model_provider = "bettertoken"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
env_key = "BETTERTOKEN_API_KEY"
requires_openai_auth = false
supports_websockets = false
Bash에서 read가 입력을 기다리면 키를 붙여 넣고 Enter를 누릅니다. 입력한 내용은 화면에 표시되지 않습니다. 프로젝트의 민감한 자료가 없는 디렉터리에서 테스트를 시작합니다.
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
codex --sandbox read-only "Reply with exactly CODEX_ROUTE_OK. Do not use tools."
Codex는 내보낸 환경 변수에서 키를 읽고 https://www.bettertoken.ai/v1/responses로 Responses 요청을 보냅니다. 이 설정에서는 auth.json을 교체하거나 OpenAI 로그인 과정에 BetterToken 키를 입력할 필요가 없습니다. 환경 변수가 전달되도록 같은 터미널에서 Codex를 시작합니다.
요청한 응답이 왔는지 확인한 뒤, BetterToken 콘솔에서 모델, 요청 시각, 상태, 요금이 일치하는 기록을 찾습니다. 응답은 연결 여부를 확인해 주고, 일치하는 기록은 어느 플랫폼이 요청을 처리했는지 확인해 줍니다. 큰 저장소를 열기 전에 과금 내역을 확인합니다.
공식 로그인 방식별로 어떤 기능을 사용할 수 있습니까?
OpenAI에 직접 접속하려면 공식 로그인 안내를 따릅니다. 플랜 혜택을 이용하려면 ChatGPT 로그인을, Platform에서 과금하려면 OpenAI가 발급한 API 키를 선택합니다. 앞서 설명한 외부 제공업체 설정은 이와 다른 접속 방식입니다.
두 공식 로그인 방식 모두 Codex CLI, IDE 확장 기능, ChatGPT 데스크톱 앱의 로컬 작업을 지원합니다. Codex cloud에는 ChatGPT 로그인이 필요합니다. 기능 제공 범위 안내에 따르면 API 키 접속에는 클라우드 기반 GitHub 코드 검토와 Slack 연동이 포함되지 않습니다.
API 키 인증은 로컬 작업이나 신뢰할 수 있는 환경의 CI 작업에 사용합니다. 클라우드 기능 이용 권한을 대신하는 용도로 선택하지 않습니다. API에서 사용할 수 있는 모델은 해당 키에 허용된 모델에 따라 달라집니다. 상위 ChatGPT 플랜을 이용해도 API 키 세션이 구독에 포함된 사용량으로 전환되지는 않습니다.
OpenAI로 돌아가려면 사용자 설정의 루트에 model_provider = "openai"를 설정합니다. 이전에 사용하던 OpenAI용 model 값도 복원하거나, 공식 로그인으로 사용할 수 있는 모델을 선택합니다. 공식 계정의 모델 접근 권한을 확인하지 않고 게이트웨이 예제의 model = "gpt-6.2-sol"을 그대로 두지 않습니다.
게이트웨이를 가리키도록 설정한 openai_base_url 값도 제거합니다. 저장된 인증 정보를 교체할 때는 먼저 codex logout을 실행합니다. ChatGPT로 로그인하려면 codex login을 실행합니다.
공식 API 키 로그인에는 OpenAI가 발급한 키를 사용합니다. 다음 Bash 명령은 키 값을 명령문에 직접 적지 않고 표준 입력으로 전달합니다.
read -rs OPENAI_API_KEY && export OPENAI_API_KEY
codex login --with-api-key <<<"$OPENAI_API_KEY"
codex login status
로그인한 뒤 새 세션을 시작하고, 선택한 OpenAI 모델로 앞서 나온 읽기 전용 테스트를 다시 실행합니다. 응답을 확인한 다음 아래 과금 확인 절차에 따라 ChatGPT 또는 OpenAI Platform의 해당 사용량 대시보드를 확인합니다.
키는 비공개로 유지합니다. OpenAI 과금 안내는 프로모션 API 크레딧을 포함해 API 과금과 ChatGPT 과금을 구분합니다. 구독 혜택을 검토할 때는 Codex 비용도 충당한다고 가정하지 않고, API 크레딧의 이용 조건과 제외 항목을 확인합니다.
국가나 카드가 지원되지 않으면 어떻게 합니까?
공식 API 키를 사용해도 OpenAI의 지역 요건은 그대로 적용됩니다. 2026-11-22 기준 러시아는 API 지원 국가 목록과 ChatGPT·API 통합 목록 모두에 포함되어 있지 않습니다.
가입하거나 API 키를 생성할 때 "OpenAI's services are not available in your country." 오류가 나타날 수 있습니다. OpenAI의 미지원 국가 정책은 미지원 국가에서 접속하면 계정이 정지될 수 있다고 경고합니다. 미지원 국가의 결제 수단을 사용하면 서비스 이용도 차단된다고 명시합니다.
결제에는 별도의 확인 조건이 있습니다. 카드로 결제할 때는 이용자의 위치와 카드 발급 은행의 소재지가 모두 지원 지역이어야 합니다. 카드 결제 거절 안내에 따르면 선불카드로는 API 크레딧을 구매할 수 없습니다.
러시아 이용자는 BetterToken에서 루블로 결제할 수 있으며, 공식 제공업체 구독에 흔히 필요한 해외 카드는 요구되지 않습니다. BetterToken의 API 엔드포인트에는 VPN 없이 접속할 수 있습니다. 이는 다른 업체의 다운로드, 로그인, 마켓플레이스 또는 업데이트까지 포함하는 설명이 아닙니다. 결제 경로, 지원 카드, 수수료 및 결제 처리 조건은 콘솔에 따라 달라집니다.
브라우저 데이터를 초기화하는 조치는 현재 지원 국가에 있는 경우에만 해당합니다. 여행 후 지역 감지 오류가 발생했다면 OpenAI는 쿠키와 캐시를 지우거나 다른 브라우저를 사용하도록 안내합니다. 해결되지 않으면 OpenAI 지원팀에 문의합니다.
Codex가 사용자 지정 제공업체 설정을 무시하는 이유는 무엇입니까?
제공업체 설정은 저장소의 .codex/config.toml이 아니라 사용자 수준 설정에 둡니다. 설정 참조 문서에 따르면 프로젝트 내부의 model_provider와 model_providers 항목은 무시됩니다. 프로젝트를 신뢰하도록 지정해도 이 제한은 바뀌지 않습니다.
model_provider는 제공업체 ID를 선택하고, [model_providers.bettertoken]은 해당 ID를 정의합니다. base_url은 API 루트 주소를 나타내며, env_key는 인증 정보를 담은 환경 변수의 이름을 지정합니다. 별도의 제공업체 ID를 사용합니다. openai, ollama, lmstudio 등 내장 ID는 예약되어 있습니다.
wire_api에서 지원하는 값은 responses뿐입니다. Chat Completions만 지원하는 게이트웨이는 이 설정에 사용할 수 없습니다. 기본 URL에는 /responses까지 포함한 전체 요청 URL이 아니라 https://www.bettertoken.ai/v1을 사용합니다.
인증 방식을 섞지 않습니다. OpenAI 문서에 따르면 requires_openai_auth = true일 때 Codex는 env_key를 무시합니다. 예제는 이 값을 명시적으로 false로 설정합니다. 파일 기반 인증 설정에서 복사한 true 값과 결합하지 않습니다.
supports_websockets = false는 이 예제에서 HTTP/SSE 전송 방식을 유지합니다. 첫 테스트에서는 선택적 조정 항목을 추가하지 않습니다. service_tier 같은 필드의 지원 여부는 게이트웨이 측에 확인해야 합니다. Codex에 설정 필드가 있다는 사실만으로 게이트웨이의 지원을 확정할 수는 없습니다.
설정이 여전히 반영되지 않는다면 CODEX_HOME과 명령줄 또는 선택한 프로필에서 덮어쓴 값을 확인합니다. CLI에서 /debug-config는 설정 계층과 정책 출처를 표시합니다. 설정을 바꾼 뒤에는 Codex를 다시 시작하고 새 세션을 엽니다. 추가 연결 점검은 사용자 지정 제공업체 설정 안내에서 확인할 수 있습니다.
실제 과금 계정은 어떻게 확인합니까?
인증 방식, 요청 경로, 사용 기록을 함께 확인합니다. codex login status는 인증 방식을 보여 줄 뿐, 과금 증빙은 아닙니다. env_key를 사용하는 제공업체라면 기존 ChatGPT 로그인 상태만으로 모델 사용료가 청구될 계정을 판단하지 않습니다.
Codex를 시작한 것과 같은 환경에서 다음 명령을 실행합니다.
codex login status
그런 다음 선택된 model_provider와 base_url을 확인합니다. 세션 내부의 /status는 활성 모델과 토큰 사용량을 표시합니다. 긴 작업을 시작하기 전에 이 정보를 짧은 테스트 요청과 대조합니다.
ChatGPT 로그인이라면 Codex 사용량 대시보드에서 플랜에 포함된 사용량의 소진 내역을 확인합니다. 구매 내역은 ChatGPT 계정이나 워크스페이스의 결제 설정에서 확인합니다. 플랜에 포함된 사용량은 요청마다 별도의 금액으로 청구되지 않을 수도 있습니다.
공식 API 키라면 OpenAI Platform 사용량 보고서와 API 조직의 결제 설정을 확인합니다. 프로젝트, 모델, API 키, 보고 기간이 정확한지 점검합니다. 대시보드 시각은 UTC이며, 최근 활동이 표시되기까지 시간이 걸릴 수 있습니다.
BetterToken이라면 콘솔에서 요청 기록과 잔액을 확인합니다. 대시보드에는 요청 시각, 모델, 상태, 토큰 사용량, 요금이 표시됩니다. 이 요금이 개인 OpenAI Platform 계정에 표시되거나 ChatGPT 사용 한도에서 차감되는 것은 아닙니다.
테스트가 실패하면 해당 원인을 점검합니다
환경 변수가 없다는 오류가 나타나면 키를 다시 입력하고 같은 Bash 터미널에서 Codex를 실행합니다. BetterToken이 401을 반환하면 BetterToken에서 발급한 유효한 키인지 확인합니다. 402는 잔액이 부족하다는 뜻입니다.
요청 형식 때문에 거절되면 선택한 프로토콜과 기본 URL을 앞의 최소 설정과 비교합니다. 다시 테스트하기 전에 제공업체별 선택 필드를 제거합니다. BetterToken의 Responses 참조 문서는 잘못된 요청 형식이나 매개변수에 400을 사용한다고 설명합니다.
응답은 받았지만 예상한 사용 기록이 없다면 더 큰 작업을 보내기 전에 중단합니다. 제공업체, 인증 정보의 출처, 대시보드 계정, 보고 기간을 다시 확인합니다. 모델 이름이나 로그인 성공만으로는 실제 과금 경로를 입증할 수 없습니다.