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-oauth로http://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
- GeekNews: https://news.hada.io/topic?id=28569
- GitHub: https://github.com/EvanZhouDev/openai-oauth
- NPM: https://www.npmjs.com/package/openai-oauth
Related Notes
- codex — OpenAI Codex CLI 엔티티 페이지
- 2026-03-30-openai-codex-plugin-claude-code — Claude Code에서 Codex를 연결하는 공식 플러그인
- 2026-03-29-claude-code-cli-mcp-auth — 로컬 CLI가 OAuth 캐시를 다루는 방식과 인증 UX
- 2026-04-10-claude-code-multi-account-proxy — 여러 AI 코딩 CLI를 API처럼 재노출하는 프록시 계열 비교
- 2026-04-08-free-budget-ai-coding-strategy — 비용 절감/우회적 접근을 둘러싼 실전 전략 메모
- 2026-04-15-claude-code-vs-codex-comparison — Codex의 실제 실행 성향 비교
- moc-ai-models