얼마 전 카카오 선물하기 대란 당시, ChatGPT Pro를 90% 할인가 29,000원에 다섯 개를 꽉 채워서 샀다. 그리고 Codex OAuth 인증 방식으로 OpenClaw에 GPT-5.3-Codex를 비롯한 GPT 모델들을 등록하는 데 성공했다.
배경
ChatGPT Pro 월 구독 요금은 원래 200달러다. 그런데 카카오가 한국 시장 프로모션(추측)으로 90% 할인된 월 29,000원(약 $20)에 잠깐 풀었다. 정확한 상품 이름은 'ChatGPT Pro 1개월 이용권'이다. 망설임 없이 구매했고 "이걸로 OpenClaw에도 쓸 수 있으면 대박인데"가 출발점이었다.

https://www.news1.kr/it-science/internet-platform/6072799
"29만원짜리 챗GPT프로가 2.9만원? 이건 사야해!"…카카오 단독 할인
선물하기, 챗GPT 프로 이용권 프로모션…최대 5개까지 플러스 이용권은 1+1로…카카오 "챗GPT 포 카카오 경험 확대" 카카오(035720)가 선물하기에서 챗GPT 프로·플러스 이용권 프로모션을 단독으로
www.news1.kr
OpenClaw에서 OpenAI 모델을 쓰려면 API 키(일명 종량제)가 필요하다..고 생각했다. ChatGPT 구독과 OpenAI API는 별개 상품이고, 구독료를 내도 API 접근은 안 된다. 그게 상식이었다. 그런데 Codex CLI가 나오면서 상황이 바뀌었다. Codex CLI의 OAuth 토큰을 OpenClaw에 등록하면, ChatGPT 구독만으로 GPT-5.2와 5.3-Codex를 쓸 수 있다. API 키 없이.
우연히 레딧(Reddit)에서 이런 글을 발견했다
"You can link your chatgpt subscription through codex and get an oauth link. Works great, just as well as if it were from an API." — u/sheitmar
반신반의하면서 시도했는데, 진짜 됐다.
OAuth 인증 진행 순서
아래 조건들을 만족한다는 전제 하에 OAuth 인증 과정을 단계별로 설명한다.
- ChatGPT Pro 또는 Plus 구독 (Plus도 가능하다)
- OpenClaw 최신 버전 (2026.2.x 이상 권장) 설치 완료
- Node.js 설치 완료
1단계: Codex CLI 설치
npm install -g @openai/codex
설치 확인:
codex --version
에러 없이 'codex-cli 0.107.0'와 같이 버전 값이 출력되면 설치 성공이다.
2단계: Codex 로그인
codex login
브라우저가 열리면서 ChatGPT 계정 인증 화면이 뜬다.


(당연히) 카카오 'ChatGPT Pro 1개월 이용권'에 연동된 ChatGPT 계정으로 로그인해야 한다. 로그인하면 터미널에 Successfully logged in이 출력된다.

토큰은 ~/.codex/auth.json에 자동으로 저장된다.
cat ~/.codex/auth.json
{
"auth_mode": "chatgpt",
"tokens": {
"id_token": "eyJhbGci...",
"access_token": "eyJhbGci...",
"refresh_token": "rt_...",
"account_id": "a833d290-..."
},
"last_refresh": "2026-03-04T08:14:16.344786Z"
}
access_token 값을 복사해 둔다. 다시 한번 말하지만 이 부분은 그냥 에이전트에 해달라고 하는 게 편하다.
3단계: OpenClaw에 등록
여기부터는 OpenClaw 에이전트한테 'Codex CLI OAuth 인증'을 해달라고 하면 편하다. 그래도 알고 있으면 나쁠 건 없으니 쭉 설명한다. 터미널에서 아래의 OpenClaw CLI 명령어를 실행한다.
openclaw models auth add
아래와 같은 인터랙티브 프롬프트가 뜬다.
◆ Token provider
│ ○ anthropic
│ ● custom (type provider id)
custom을 선택하고 openai-codex를 직접 입력한다.
◆ Token method
│ ● paste token
paste token 선택.
◆ Profile id
│ openai-codex:manual
그대로 엔터.
◆ Does this token expire?
│ ● Yes
OAuth 토큰은 일정 기간 후 만료된다. 하지만 Codex CLI가 사용 중 자동으로 갱신하므로 대부분의 경우 재로그인 없이 계속 사용할 수 있다. 혹시나 나중에 인증 만료 오류가 뜨면 codex login으로 재발급하면 된다. 여기서는 Yes를 선택하고 만료 기간은 대략적(30d 정도)으로 넣는다.
마지막으로 아까 복사한 access_token을 붙여 넣는다.
Updated ~/.openclaw/openclaw.json
Auth profile: openai-codex:manual (openai-codex/token)
이것으로 Codex CLI OAuth 인증 과정이 모두 끝났다.
4단계: 등록 확인
openclaw models
출력에서 이 부분을 확인한다:
Providers w/ OAuth/tokens (2): anthropic (1), openai-codex (1)
- openai-codex effective=profiles:~/.openclaw/agents/main/agent/auth-profiles.json
| profiles=1 (oauth=0, token=1, api_key=0)
| openai-codex:manual=token:eyJhbGci...
openai-codex 프로바이더가 잡혔으면 성공이다. 사용량 현황도 보인다:
- openai-codex usage: 5h 100% left ⏱4h 55m · Day 100% left ⏱6d 23h
5단계: 모델 설정
에이전트의 기본 모델을 바꾸거나, 대화에서 /model openai-codex/gpt-5.3-codex로 전환하면 된다. config(openclaw.json 파일)에서 에이전트 기본 모델을 바꾸려면 아래와 같이 수정한다.
{
"agents": {
"list": [
{
"id": "my-agent",
"model": "openai-codex/gpt-5.3-codex"
}
]
}
}
하지만 파일을 직접 수정하는 것은 권하지 않는다. 사용하는 채널(텔레그램, 디스코드 등)에서 에이전트에게 기본 모델을 'gpt-5.3-codex 로 변경'해 달라고 말하는 게 쉽고 안전하다.
사용 가능한 모델
OpenClaw에서 지원하는 OpenAI provider는 openai와 openai-codex가 있는데 Codex CLI OAuth 인증으로는 openai-codex만 사용할 수 있다. openai-codex에서 사용 가능한 주요 모델은 아래와 같다.
| 모델 | 용도 및 특징 |
| openai-codex/gpt-5.2 | 범용. 안정적. |
| openai-codex/gpt-5.3-codex | 코딩 특화. 최신. |
다시 말하지만 둘 다 ChatGPT 구독에 포함된다. 추가 과금이 없다.
주의 사항
주간 사용량 한도
구독이라고 무제한이 아니다. 주간 단위로 사용량 한도가 있다. 레딧에서 "며칠 만에 일주일치를 다 썼다"는 사례가 있었다. openclaw models 출력에서 잔여량을 확인할 수 있다. 한도를 초과하면 해당 모델이 비활성화되고, 리셋까지 기다려야 한다. Pro($200) 플랜이 Plus($20)보다 한도가 넉넉하다.
토큰 만료
혹시나 자동 갱신이 안 돼서 OAuth access_token이 만료되면 앞에서 했던 과정을 반복하면 된다.
codex login
openclaw models auth add
다시 로그인하고 새 토큰을 등록하면 된다. 1분이면 끝난다.
API가 아니다
Codex OAuth는 ChatGPT 구독 기반 인증이다. OpenAI API 키가 아니다. API 전용 기능(fine-tuning, batch 등)은 사용할 수 없다. 하지만 OpenClaw에서 대화 모델로 쓰는 데는 아무 문제없다.
응용: 에이전트별 모델 분배
멀티 에이전트 환경이라면 프로바이더를 에이전트별로 나눌 수 있다.
| 에이전트 | 모델 | 인증 방식 |
| 에이전트 A | anthropic/claude-opus-4-6 | Claude OAuth (구독) |
| 에이전트 B | google/gemini-3-pro-preview | Google API 키 |
| 에이전트 C | openai-codex/gpt-5.3-codex | Codex OAuth (구독) |
세 프로바이더 모두 구독 또는 무료 크레딧 기반이면, 사실상 API 과금 없이 멀티 모델 환경을 운영할 수 있다. 물론 운영이 가능할 뿐이지 24/7 돌리는 데에 쾌적한 수준이라고 말하기는 힘들다.
요약 및 마무리
ChatGPT 구독이 있으면 5분이면 끝나는 작업이다.
npm install -g @openai/codex
codex login
openclaw models auth add
# → custom → openai-codex → paste token → 완료
"ChatGPT 구독으로는 API를 쓸 수 없다"는 건 반만 맞는 말이었다. Codex OAuth 덕분에 구독 모델로 OpenClaw에 GPT-5.3 Codex 모델을 올릴 수 있다. 하지만 API 호출(종량제) 방식이 기본이라 언제 막힐지는 알 수 없다. 그래도 최근 OpenClaw 창시자가 OpenAI에 합류한 만큼 갑자기 막아버릴 일은 당분간 없을 듯하다. 끝.