LLM Wiki

github.com/miuuyy/codex-chatgpt-web — ChatGPT Web(Pro 포함)을 Codex 네이티브 모델로 쓰는 브리지

Properties3
descriptionCodex 앱의 선택 턴을 임베디드 브라우저의 새 ChatGPT Temporary Chat으로 라우팅해 Luna~Pro 모델을 네이티브 Codex 하네스에서 쓰게 하는 로컬 브리지. Full 모드는 MCP로 도구까지 연결.
tagscodex, chatgpt, mcp, open-source, dev-tools
aliasesChatGPT Web for Codex, codex-chatgpt-web

8 min read

고정 커밋 2569603f…(main HEAD와 일치 확인) 기준 정적 검사 요약. 설치·실행(ChatGPT 계정 필요)은 하지 않았고 동작 서술은 README(원본 캡처)에 근거한다. 브라우저 자동화 특성상 UI 변동 시 실동작은 달라질 수 있다.[unverified]

개요

ChatGPT Web for Codex는 miuuyy가 만든 ChatGPT Web 구독(Free/Go/Plus/Pro)을 Codex의 네이티브 모델처럼 쓰게 하는 로컬 브리지다. “모델 등급을 바꿔 워크플로우를 절약한다”는 표어대로, API 과금 없이 웹 구독만으로 Codex 앱 안에서 Luna·Instant·Medium·High·Extra High·Pro를 선택해 사용한다. Codex가 태스크·컨텍스트 수명주기·도구 하네스를 그대로 소유하고, 이 도구는 선택된 모델의 턴만 임베디드 브라우저의 새 ChatGPT Temporary Chat으로 라우팅한 뒤 reasoning·도구 활동·Markdown을 같은 태스크로 스트리밍 되돌린다.[1]

MIT 라이선스, OpenAI 비공식 프로젝트(Terms 준수 책임은 사용자), 생성 약 1개월 만에 stars 1,476을 기록한 인기 저장소다.[2]

동작 방식

Codex task ──Responses + SSE──▶ codex-chatgpt-web ──임베디드 브라우저──▶ ChatGPT
     ▲                                │                                      │
     └──── 네이티브 UI·컨텍스트·이미지·트레이싱·도구 수명주기 ──────────────────┘
  • 세션 위생: 태스크마다 새 Temporary Chat 시작(재사용·일반 히스토리 저장 없음), 컴파일된 현재 컨텍스트 전달, 브라우저 천장 측정 기반 compaction, Luna는 adaptive rolling checkpoint로 완료 상태 운반.[1]
  • Full harness 모드: 공식 OpenAI tunnel-client(아웃바운드 전용, 포트 개방 불요)로 ChatGPT 도구 호출을 같은 Codex 태스크의 파일시스템·셸·이미지·승인·설정 도구에 연결(turn-bound MCP). 호출과 결과가 같은 브라우저 응답 안에 머문다 — 텍스트로 시뮬레이션하지 않음. Pro도 다른 등급과 완전히 동일한 계약(별도 제외 없음). Browser-only 모드는 모든 경로에서 읽기 전용.[1]
  • fail-closed: UI 드리프트·기능 누락 시 조용한 폴백 대신 명시적 오류. 예상 못한 승인 프롬프트는 --auto-approve-tool-calls(Allow once만 클릭) 명시 전까지 실패 처리.[1]

주요 구성

  • 런처(Electron): 한 줄 설치(macOS/Windows/Linux). 로그인 오케스트레이션·스모크 테스트·MCP 가이드·런타임 헬스·로그 통합, 임베디드 브라우저로 턴 관람. 최대 5개 태스크 결합 브라우저 탭 병렬(계정 트래픽 캡). 모델 API 키·Chrome·시스템 Node/Bun 불요. 설치 전 SHA-256 매니페스트 검증.[1]
  • 서브에이전트 프로토콜: 신규 설치는 Compatibility V1(multi_agent 활성, [agents].max_depth ≥ 2 승격 후 복원, disconnect/제거 시 이전 설정 복원) — Web 부모→Web 자식 위헙, wait_agent는 10초 폴링으로 노출(MCP 채널 점유 방지). Native V2는 opt-in 고급 모드.[1]
  • 운영 도구: Activity 구조화 로그, Run doctor 헬스체크, 멈춘 브라우저 턴 취소, 제거 전 Codex 통합 복원. 진단 JSON 체크포인트+정지/실패 턴 스크린샷(CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS=1로 전 체크포인트 확대).[1]
  • 개발 격리: dev:launcher는 ~/.codex-chatgpt-web-dev 아래 완전 분리 프로필(별도 쿠키·CODEX_HOME·터널, Codex 변경 없음), dev:chat은 합성 외부 Codex 하네스(실제 리스너 미개방, 시뮬레이션 영수증).[1]

보안·한계 (README 명시)

  • 비공식 브라우저 자동화 — ChatGPT UI 변경이 셀렉터를 깰 수 있고, 드리프트는 조용히 대체되지 않고 명시적으로 실패한다. Temporary Chat은 프라이버시 모드일 뿐 익명·로컬 추론이 아니며 프롬프트는 여전히 OpenAI 처리를 거친다.[1]
  • Full 모드 사전조건: ChatGPT Developer Mode + 정확히 Codex Native2라는 이름의 신규 커넥터 + Allow all actions(구형 Native 재사용 금지 — ChatGPT가 커넥터 ID별 MCP 계약 캐싱; 저위험 권한은 명령·패치를 차단). 워크스페이스 관리자 정책도 쓰기를 허용해야 함.[1]
  • 브라우저 상태는 민감한 로그인 아티팩트 — 런처 프로필 공유 금지, 루프백 리스너는 같은 로컬 사용자 프로세스에 도달 가능.[1]
  • macOS 패키지는 서명 자격 증명 설정 전까지 Gatekeeper 경고 가능(인스톨러는 SHA-256 매니페스트 검증).[1]

버전·라이선스·출처

  • 라이선스: MIT (LICENSE, 1,087 bytes).[3]
  • 최신 릴리스: v3.0.3 (2026-08-25) — 체크아웃 package.json 3.0.3과 정확히 일치.[4]
  • 수집 시점 관측값: stars 1,476 · forks 179 · TypeScript · created 2026-07-26 · pushed 당일 · topics codex/chatgpt-pro/mcp/playwright/responses-api 등.[4]

정적 검사 한계

  • 설치·로그인·실제 턴 실행을 하지 않았다. 브라우저 자동화 도구의 특성상 README 서술과 실제 동작(UI 버전에 따른 셀렉터 유효성)은 다를 수 있으며 confidence: medium.
  • ToS 관점: 비공식 자동화이므로 OpenAI Terms·워크스페이스 정책 준수 책임은 사용자에게 있음(README Disclaimer).

관련 위키

Sources

[1] https://github.com/miuuyy/codex-chatgpt-web — README (고정 커밋 2569603f…, 원본 캡처: raw/articles/2026-08-25-github-miuuyy-codex-chatgpt-web.md) [2] https://api.github.com/repos/miuuyy/codex-chatgpt-web — GitHub REST API (stars/forks/license/created/pushed/topics, 2026-08-25 수집) [3] https://github.com/miuuyy/codex-chatgpt-web/blob/main/LICENSE — MIT [4] https://api.github.com/repos/miuuyy/codex-chatgpt-web/releases/latest — 릴리스 v3.0.3

백링크