openai-oauth - ChatGPT 계정으로 OpenAI API를 무료로 사용하기

ChatGPT/Codex의 로컬 OAuth 인증 캐시를 재사용해 http://127.0.0.1:10531/v1에 OpenAI 호환 프록시를 띄우는 비공식 커뮤니티 프로젝트다.

개요

GeekNews 요약과 GitHub README 기준으로, openai-oauth는 npx openai-oauth 한 줄로 로컬 프록시를 실행해 /v1/responses, /v1/chat/completions, /v1/models를 OpenAI 호환 방식으로 노출한다. 핵심 아이디어는 OpenAI Codex CLI가 내부적으로 사용하는 chatgpt.com/backend-api/codex 경로와 로컬 OAuth 토큰을 활용하는 것이다.

즉 새로운 API 키를 발급하는 방식이 아니라, 이미 npx @openai/codex login으로 생성된 ~/.codex/auth.json을 바탕으로 계정이 가진 Codex 플랜 접근 권한을 로컬 프록시로 재노출한다. README는 Vercel AI SDK Provider(createOpenAIOAuth())도 함께 제공해 TypeScript 앱에서 바로 붙일 수 있다고 설명한다.

핵심 포인트

  • npx openai-oauthhttp://127.0.0.1:10531/v1에 OpenAI 호환 localhost 엔드포인트 생성
  • /v1/responses, /v1/chat/completions, /v1/models 지원
  • 스트리밍, tool calls, reasoning traces 동작
  • 계정별 Codex 모델 목록을 자동 탐색하거나 --models로 수동 제한 가능
  • 로그인 플로우는 포함하지 않으며 npx @openai/codex login으로 인증 파일을 먼저 만들어야 함
  • 프록시는 무상태라 /v1/responses 호출 시 전체 대화 히스토리를 직접 보내야 함
  • 공식 OpenAI 프로젝트가 아니라 비공식 커뮤니티 도구이며, auth.json은 비밀번호급 자격증명으로 다뤄야 함

왜 중요한가

이 프로젝트가 흥미로운 이유는 단순히 “무료 API”라는 자극적인 문구 때문이 아니라, Codex CLI라는 제품 계층의 인증/접속 방식을 다시 API 계층으로 끌어내렸다는 점이다. 이는 codex가 단순한 CLI를 넘어, 별도 요금제·모델 카탈로그·특수 엔드포인트를 가진 실행 플랫폼이 되고 있음을 보여준다.

동시에 리스크도 명확하다. README와 GeekNews 댓글 모두 이 도구를 개인 로컬 실험 용도로만 다뤄야 한다고 강조한다. 토큰 캐시를 공유하거나 호스팅 서비스처럼 재배포하면 계정 정지·해지, 자격증명 노출, 정책 위반 위험이 커질 수 있다. 따라서 이 노트는 우회 수단 추천이 아니라, 2026년 현재 OpenAI 생태계의 인증 경계와 비공식 확장 패턴을 기록하는 메모로 보는 편이 맞다.

Sources