OpenClaw에 ChatGPT Codex(OAuth) 연동하기
— 왜 쓰는지, 어떻게 쓰는지, 다른 AI들과 무엇이 다른지

최근 OpenClaw를 쓰는 개발자들 사이에서 “API 키 없이 ChatGPT 구독만으로 에이전트를 굴리는 방법”이 실질적인 대안으로 자리 잡았습니다. 키워드는 바로 OpenAI Codex OAuth 연동입니다.

이 글에서는:

ChatGPT Codex(OAuth)가 무엇인지
OpenClaw에 Codex를 OAuth 방식으로 연동하는 전체 과정
Codex를 쓸 때 어떤 점이 좋은지 (특히 비용 구조와 운영 관점)
Anthropic Claude, Google Gemini, API-Key 기반 OpenAI 모델들과의 비교
어떤 경우에 Codex/OAuth를 쓰고, 어떤 경우엔 API-Key나 다른 프로바이더를 써야 하는지

를 프로그래머 관점에서 논리적으로 정리해 보겠습니다.

1. ChatGPT Codex(OAuth)란 무엇인가?

1.1 용어 정리

OpenAI Codex (여기서 말하는 Codex)
예전의 “코드 전용 Codex 모델”과는 다른, ChatGPT 계정 기반의 OAuth 엔드포인트입니다.
ChatGPT Plus/Pro/Business 구독에 포함된 모델들(예: gpt-5.3-codex)을 “ChatGPT 웹 UI가 아닌 제3자 도구에서” 사용할 수 있게 하는 브리지 역할을 합니다.
OAuth 인증
API 키를 직접 발급/관리하는 대신,
브라우저에서 ChatGPT 계정으로 로그인 → OpenClaw에 접근 권한을 부여하는 표준 OAuth 플로우입니다.
OpenClaw의 openai-codex 프로바이더
OpenClaw 안에서는 이 OAuth 기반 프로바이더를 openai-codex라는 이름으로 취급합니다.
모델 예: openai-codex/gpt-5.3-codex, openai-codex/gpt-5.1 등.

1.2 왜 OAuth 기반이 중요한가?

API 키 노출 리스크 감소
코드/서버 설정에 직접 API 키를 넣지 않습니다.
토큰은 OpenClaw의 인증 프로파일 안에 저장되고, 브라우저 OAuth를 통한 재인증으로 갱신됩니다.
ChatGPT 구독을 재활용
이미 ChatGPT Plus/Pro를 사용 중이라면,
별도의 OpenAI API 요금 없이 (또는 매우 낮은 추가 비용으로) OpenClaw 에이전트를 돌릴 수 있습니다.
여러 자료에 따르면, 2026년 기준:
- ChatGPT Plus: $20/월
- ChatGPT Pro: $200/월
- Business: $30/사용자/월
ToS(이용약관) 관점에서의 명확성
Anthropic Claude나 Google Gemini는 일반 “구독 계정 OAuth를 제3자 도구에 붙이는 방식”에 대해 모호하거나 제한적인 조항이 생겼습니다.
반면, OpenAI의 Codex OAuth는 제3자 툴 통합을 전제로 한 공식 플로우로 소개되고 있어, OpenClaw와 같은 도구에서 사용 시 법적/정책적 리스크가 상대적으로 낮다는 평가가 많습니다.

2. OpenClaw에 ChatGPT Codex(OAuth) 연동하기

아래 절차는, 이미 OpenClaw가 설치되어 있고 기본적인 셋업(텔레그램, 디스코드 등 채널 연결)이 되어 있다는 전제입니다.

2.1 전체 흐름 개요

OpenClaw 설정 백업
Onboarding Wizard 실행 (openai-codex 선택)
브라우저에서 ChatGPT 계정으로 OAuth 로그인
기본 모델을 openai-codex 계열로 변경
Per-agent 모델 오버라이드 확인/수정
(선택) 기존 Anthropic/Gemini/API-key 인증 정리

2.2 Step 1: 설정 백업

OpenClaw는 .openclaw 디렉토리 아래에 채널 설정, 모델 설정, 메모리, 크론 등 중요한 상태를 모두 저장합니다.

cd ~
tar -czf openclaw-backup.tgz .openclaw

이 백업 하나면, 모델 설정을 망쳐도 바로 복원 가능하니, 실험 전 항상 만들어 두는 것을 추천합니다.

2.3 Step 2: Onboarding Wizard 실행

터미널에서:

openclaw onboard --auth-choice openai-codex

이제 인터랙티브 위저드가 뜹니다. 주로 나오는 질문과 권장 선택은 다음과 같습니다.

화면/질문	권장 선택	이유
“This is risky” 경고	Proceed	Codex의 동작 특성 차이에 대한 안내일 뿐, 설정 파괴는 하지 않습니다.
Setup mode	Quickstart	대부분의 기본값을 사용해 빠르게 셋업하기 좋습니다.
Existing values (재설정 여부)	Use existing values	“Reset”를 선택하면 채널, 메모리, 크론 설정까지 초기화될 수 있습니다.

이 단계를 거치면 브라우저가 자동으로 열리면서 ChatGPT 로그인 화면이 나타납니다.

2.4 Step 3: 브라우저에서 ChatGPT OAuth 인증

브라우저에서 ChatGPT 계정(Plus/Pro/Business 등)으로 로그인합니다.
“OpenClaw가 귀하의 ChatGPT 계정에 접근하도록 허용”과 같은 승인 화면에서 Authorize를 클릭합니다.
성공 시 브라우저는 “성공적으로 인증됨” 정도의 메시지를 보여주고, 터미널로 돌아옵니다.

중요 팁:
몇몇 가이드에 따르면, 인증이 끝난 후 위저드가 기존 설정을 덮어쓸 수 있으므로,
인증 직후에는 위저드를 끝까지 진행하지 않고, 필요한 시점에 바로 종료하는 방식을 추천합니다.
(최근 버전에서는 이 문제가 상당히 완화되었지만, 백업이 있으니 그래도 보수적으로 움직이는 것이 안전합니다.)

2.5 Step 4: 기본 모델을 Codex로 설정

이제 OpenClaw의 기본 모델을 openai-codex로 바꿉니다.

openclaw models set openai-codex/gpt-5.3-codex

상태 확인:

openclaw models status --plain

출력에서 primary가 openai-codex/gpt-5.3-codex와 같이 나오면 설정 완료입니다.

primary: openai-codex/gpt-5.3-codex
fallbacks: ...
auth: openai-codex (OAuth)
...

2.6 Step 5: 에이전트별 모델 오버라이드 확인

많이 놓치는 부분입니다. openclaw models set은 글로벌 기본값만 바꿉니다.
만약 각 에이전트에 개별 model.primary가 지정되어 있으면, 여전히 예전 Claude나 Gemini를 쓰고 있을 수 있습니다.

openclaw.json 혹은 에이전트 설정을 열어서 다음과 같이 되어 있는지 확인합니다:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-codex/gpt-5.3-codex" // 글로벌 기본값
      }
    },
    "list": [
      {
        "id": "branding",
        "model": {
          "primary": "anthropic/claude-opus-4-6" // ← 이런 식으로 남아 있으면 Codex로 교체 필요
        }
      }
    ]
  }
}

전략은 둘 중 하나입니다.

모든 에이전트를 Codex로 통일
개별 model.primary를 삭제하고 defaults만 사용.
핵심 에이전트만 Codex로, 일부는 기존 모델 유지
예:
- main / coding / automation → openai-codex/gpt-5.3-codex
- writing / marketing → anthropic/claude-sonnet 유지

2.7 Step 6: 기존 프로바이더 정리 (선택)

Anthropic나 Gemini 인증 정보를 완전히 제거하고 싶다면:

# (예) Anthropic 관련 fallbacks 제거
openclaw models fallbacks clear

# 특정 프로바이더 auth 순서 제거
openclaw models auth order clear --provider anthropic

# .env에서 키 제거 (~/.openclaw/.env)
# ANTHROPIC_API_KEY=... 등 삭제

# 게이트웨이 재시작 및 헬스 체크
openclaw gateway restart
openclaw doctor

이렇게 하면 Codex + ChatGPT 구독만으로 동작하는 깔끔한 구성을 만들 수 있습니다.

3. Codex(OAuth)로 운영하는 것이 왜 좋은가?

3.1 비용 구조: “구독 vs API 토큰”

Codex(OAuth) + ChatGPT 구독

고정비(Subscription)
Plus: $20/월, Pro: $200/월 등 일정 금액만 내면,
OpenClaw를 통해 상당한 양의 에이전트 작업을 추가 API 비용 없이 실행할 수 있습니다.
사용 패턴에 강함
하루 종일 개인 비서/코딩 도우미/자동화 에이전트를 굴리는 “개인 혹은 소규모 팀”에게는,
예측 가능한 고정 비용이라는 점이 매우 큰 장점입니다.
실질적인 무제한에 가까운 UX (정책 범위 내에서)
실사용 기준으로, ChatGPT Plus 계정으로 하루 수백~수천 턴 정도의 에이전트 대화는 무리가 없는 편입니다.
(정확한 한도는 OpenAI 정책 변화에 따라 달라질 수 있습니다.)

API-Key 기반 OpenAI / Anthropic / Gemini

변동비(Per-token)
예: GPT-5.x, Claude 3.x, Gemini 2.x 등은 입출력 토큰 단가 + rate limit 구조입니다.
복잡한 Agent Loop, Tool Use, 대량 문서 처리, 코드베이스 분석 등은 금방 수십~수백 달러를 넘길 수 있습니다.
규모에 강함
반대로, 백엔드 서비스에 소량의 LLM 기능만 붙이는 경우에는,
“사용한 만큼만” 내는 API-Key 구조가 더 효율적일 수 있습니다.

결론:

개인/자기 사용, 실험/개발, 데스크톱 에이전트 → Codex + ChatGPT 구독이 훨씬 깔끔하고 싸게 나오는 경우가 많습니다.
프로덕션 백엔드, 고객-facing 기능 → API-Key 기반 모델이 여전히 표준 선택입니다.

3.2 운영 관점: 키 관리, 보안, 설정 복잡도

보안
API 키:
.env, CI/CD, 서버 설정에 퍼져 나가며, 유출 시 직접적인 비용 폭탄으로 이어집니다.
OAuth (Codex):
브라우저 인증으로만 접근을 부여하고, 토큰은 OpenClaw 내부에 보관됩니다.
키가 코드에 박혀 있지 않으니 리포지터리 유출 리스크가 줄어듭니다.
설정 복잡도
API-Key 모델:
프로바이더별로 환경 변수, 모델 이름, rate limit 관리, billing 대시보드 등을 따로 맞춰야 합니다.
Codex:
openclaw onboard --auth-choice openai-codex + models set 정도면 핵심 구성 완료.
이후 모델 교체도 openclaw models set openai-codex/gpt-5.1 같은 한 줄로 해결됩니다.
계정 정리
ChatGPT 구독 하나에 OpenClaw가 붙는 구조라,
“개인용 AI 스택”을 하나의 계정/영수증으로 관리하기 좋아집니다.

3.3 모델 특성: 코드/도구 사용에 강한 Codex

커뮤니티 경험 및 각종 튜토리얼을 종합하면:

Codex 강점
- 코드 작성, 리팩토링, 테스트 코드 생성
- API 스키마/스펙을 읽고 자동으로 HTTP/TCP 호출 작성
- Tool Use (MCP, OpenClaw skills)와 매우 잘 맞는 Action-style 응답
상대적 약점
- 문학적/감성적인 에세이, 스토리텔링 → 여전히 Claude 계열이 선호되는 경우가 많음
- 긴 문서 요약에서의 “톤”이나 “뉘앙스”는 Claude나 일부 Gemini 모델이 더 좋아 보인다는 평가도 존재

OpenClaw처럼 “도구를 많이 쓰는 에이전트 런타임”에서는,
이런 Codex 특성이 상당히 큰 플러스입니다.

4. 다른 AI Provider들과의 비교

여기서는 OpenClaw 관점에서 비교합니다.

4.1 OpenAI Codex (ChatGPT OAuth)

인증: OAuth (ChatGPT 계정 연동)
과금: ChatGPT 플랜의 고정비(Plus/Pro/Business 등)
강점:
- 개인/소규모 팀 용도에서 비용 효율 극대화
- 키 관리가 필요 없음
- Tool Use, 코드 작업에 최적화된 응답 스타일
약점:
- ChatGPT 계정 정책/한도에 종속
- 상용 SaaS에서 고객 요청을 처리하는 “정식 API 백엔드”로 쓰기에는 부적합

4.2 OpenAI API-Key (gpt-5.x, gpt-4o 등)

인증: API 키 (환경 변수, Secret Manager 등)
과금: 토큰 단가 + rate limit
강점:
- 프로덕션 서비스, 대량 트래픽 상황에 적합
- 모델 및 버전 선택 폭이 넓고, 엔터프라이즈 계약 가능
약점:
- 키 관리/보안/리밋 관리 필요
- 개인용 “무제한 비서”로 쓰기엔 비용 불안정

4.3 Anthropic Claude (OAuth/Key)

인증: 원래는 OAuth + Pro/Opus 계정 연동도 많이 쓰였으나,
최근 ToS 변경으로 제3자 도구와의 OAuth 통합이 애매해진 상태라는 커뮤니티 의견이 많음.
강점:
- 자연어 글쓰기, 장문 문서 편집, 섬세한 요약에 강함
약점:
- 고성능 모델(Opus 등)은 토큰 단가가 매우 높음 → Agent Loop에 쓰면 $100/월 쉽게 넘김
- OAuth 기반 통합의 정책 리스크

4.4 Google Gemini (OAuth/Key)

인증: Google 계정 기반 OAuth, 또는 API Key
강점:
- 멀티모달(이미지/비디오), 검색/도큐먼트 연계 기능 등 Google 생태계와의 통합
약점:
- OAuth 기반 제3자 통합에 대한 정책/ToS 해석이 민감해짐
- 순수 코드/에이전트 작업에서는 Codex/Claude 대비 장점이 애매한 경우도 많음

4.5 어떤 조합이 현실적인가?

실제 OpenClaw 사용자들이 채택하는 전략은 대략 다음 패턴으로 수렴합니다:

개인 비서 + 코딩 에이전트 중심
- 기본: openai-codex/gpt-5.3-codex
- 특정 작업(글쓰기/브랜딩 등)에만 Claude나 기타 모델을 API-Key로 추가
프로덕션 백엔드 + OpenClaw
- 백엔드 서버: OpenAI/Anthropic/Gemini API-Key 모델
- OpenClaw: 운영자/개발자 도우미로 Codex OAuth 사용 (개발/운영 자동화)

이 조합을 쓰면:

프로덕션은 전통적인 API-Key 패턴으로 안정적인 모니터링/과금 관리가 가능하고,
개인 작업/운영 자동화는 Codex + 구독 고정비로 마음 편하게 굴릴 수 있습니다.

5. 정리: 언제 Codex(OAuth)를 선택해야 하는가?

Codex(OAuth)를 선택해야 할 때

이미 ChatGPT Plus/Pro/Business 구독이 있다.
OpenClaw를 개인/팀 내부의 비서, 코딩 도우미, 자동화 에이전트로 쓰고 싶다.
“이번 달에 에이전트 얼마나 돌렸지?” 같은 API 요금을 신경 쓰고 싶지 않다.
코드 생성, CLI/툴 자동화, MCP/Skills 연동 등 툴 사용 비중이 높다.

다른 프로바이더/API-Key를 선택해야 할 때

외부 사용자에게 서비스를 제공하는 프로덕션 백엔드에서 LLM을 쓴다.
클라이언트별 과금/사용량을 세밀하게 측정, 관리해야 한다.
특정 모델(예: Claude의 장문 글쓰기, Gemini의 멀티모달)이 필수 요건이다.
컴플라이언스, 엔터프라이즈 계약 등으로 인해 특정 클라우드/벤더를 강제해야 한다.

6. 마무리

OpenClaw + ChatGPT Codex(OAuth) 조합은,
“개인/팀용 AI 비서 스택을 합리적인 비용과 단순한 운영으로 구축하고 싶은 개발자”에게 현재 시점에서 가장 현실적인 선택지 중 하나입니다.

openclaw onboard --auth-choice openai-codex
브라우저에서 ChatGPT 계정으로 OAuth 로그인
openclaw models set openai-codex/gpt-5.3-codex
에이전트별 모델 오버라이드 정리

이 네 가지를 마치면, 사실상 셋업은 끝입니다.

이후에는:

코드 리뷰/리팩토링, CLI 자동화, 서버 상태 점검, GitHub 이슈 처리 등
대부분의 “개발자 일상 업무”를 Codex 기반 에이전트로 밀어 넣을 수 있습니다.

필요하다면 다음 글에서:

실제 OpenClaw 설정 파일 예시(openclaw.json)
Codex + 다른 프로바이더를 섞어 쓰는 멀티-모델 전략
비용 모니터링/알림(크론, 헬스체크, 메모리 전략)

까지 더 깊게 파볼 수 있습니다.

Amoo

OpenClaw에 ChatGPT Codex(OAuth) 연동하기 – 비용, 장단점, 다른 AI와의 비교

OpenClaw에 ChatGPT Codex(OAuth) 연동하기
— 왜 쓰는지, 어떻게 쓰는지, 다른 AI들과 무엇이 다른지

1. ChatGPT Codex(OAuth)란 무엇인가?

1.1 용어 정리

1.2 왜 OAuth 기반이 중요한가?

2. OpenClaw에 ChatGPT Codex(OAuth) 연동하기

2.1 전체 흐름 개요

2.2 Step 1: 설정 백업

2.3 Step 2: Onboarding Wizard 실행

2.4 Step 3: 브라우저에서 ChatGPT OAuth 인증

2.5 Step 4: 기본 모델을 Codex로 설정

2.6 Step 5: 에이전트별 모델 오버라이드 확인

2.7 Step 6: 기존 프로바이더 정리 (선택)

3. Codex(OAuth)로 운영하는 것이 왜 좋은가?

3.1 비용 구조: “구독 vs API 토큰”

Codex(OAuth) + ChatGPT 구독

API-Key 기반 OpenAI / Anthropic / Gemini

3.2 운영 관점: 키 관리, 보안, 설정 복잡도

3.3 모델 특성: 코드/도구 사용에 강한 Codex

4. 다른 AI Provider들과의 비교

4.1 OpenAI Codex (ChatGPT OAuth)

4.2 OpenAI API-Key (gpt-5.x, gpt-4o 등)

4.3 Anthropic Claude (OAuth/Key)

4.4 Google Gemini (OAuth/Key)

4.5 어떤 조합이 현실적인가?

5. 정리: 언제 Codex(OAuth)를 선택해야 하는가?

Codex(OAuth)를 선택해야 할 때

다른 프로바이더/API-Key를 선택해야 할 때

6. 마무리

댓글

티스토리툴바

OpenClaw에 ChatGPT Codex(OAuth) 연동하기 – 비용, 장단점, 다른 AI와의 비교

OpenClaw에 ChatGPT Codex(OAuth) 연동하기— 왜 쓰는지, 어떻게 쓰는지, 다른 AI들과 무엇이 다른지

1. ChatGPT Codex(OAuth)란 무엇인가?

1.1 용어 정리

1.2 왜 OAuth 기반이 중요한가?

2. OpenClaw에 ChatGPT Codex(OAuth) 연동하기

2.1 전체 흐름 개요

2.2 Step 1: 설정 백업

2.3 Step 2: Onboarding Wizard 실행

2.4 Step 3: 브라우저에서 ChatGPT OAuth 인증

2.5 Step 4: 기본 모델을 Codex로 설정

2.6 Step 5: 에이전트별 모델 오버라이드 확인

2.7 Step 6: 기존 프로바이더 정리 (선택)

3. Codex(OAuth)로 운영하는 것이 왜 좋은가?

3.1 비용 구조: “구독 vs API 토큰”

Codex(OAuth) + ChatGPT 구독

API-Key 기반 OpenAI / Anthropic / Gemini

3.2 운영 관점: 키 관리, 보안, 설정 복잡도

3.3 모델 특성: 코드/도구 사용에 강한 Codex

4. 다른 AI Provider들과의 비교

4.1 OpenAI Codex (ChatGPT OAuth)

4.2 OpenAI API-Key (gpt-5.x, gpt-4o 등)

4.3 Anthropic Claude (OAuth/Key)

4.4 Google Gemini (OAuth/Key)

4.5 어떤 조합이 현실적인가?

5. 정리: 언제 Codex(OAuth)를 선택해야 하는가?

Codex(OAuth)를 선택해야 할 때

다른 프로바이더/API-Key를 선택해야 할 때

6. 마무리

댓글

티스토리툴바

OpenClaw에 ChatGPT Codex(OAuth) 연동하기
— 왜 쓰는지, 어떻게 쓰는지, 다른 AI들과 무엇이 다른지