miuuyy/codex-chatgpt-web

codex‑chatgpt‑web – ChatGPT Web 을 네이티브 Codex 모델 선택기로 연결

무엇을 하는가

• macOS, Windows, Linux 에서 사용 가능한 크로스플랫폼 데스크톱 런처 (개인용 Chromium 브라우저 내장).
• 내장 브라우저 안에서 ChatGPT Web 에 로그인하고, 선택된 ChatGPT 모델 (Luna, Instant‑High, Pro 등) 을 네이티브 Codex 모델로 노출.
• 모델 응답을 일시적인 ChatGPT 채팅을 통해 라우팅하면서, Codex 의 원래 작업 UI, 컨텍스트 라이프사이클, 스트리밍, 트레이싱 및 툴 허브를 유지.
• 두 가지 운영 모드:
  1. 브라우저 전용 – ChatGPT UI 만 사용; Codex 툴에 접근 불가.
  2. 풀 허브 – OpenAI 의 tunnel‑client 를 통해 ChatGPT 모델이 현재 Codex 작업 (파일 시스템, 쉘, 이미지 처리, 승인 등) 으로 다시 호출 가능.

왜 중요한가

• 이미 Codex (OpenAI 내부 IDE) 에서 작업 중인 사용자가 OpenAI API 키 없이 최신 ChatGPT Web 모델로 전환할 수 있음.
• Codex 의 모든 내장 기능 (작업 압축, 툴 트레이싱, UI 등) 을 유지하면서, ChatGPT Web 이 제공하는 더 풍부한 추론 수준에 접근 가능.
• 모든 통합은 로컬에서 이루어지며, 외부 트래픽은 일반적인 ChatGPT Web 요청과, 풀 허브 모드에서는 OpenAI 의 MCP 서비스로의 아웃바운드 터널만 발생.

빠른 시작

# macOS / Linux
curl -fsSL https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.sh | sh

# Windows (PowerShell)
irm https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.ps1 | iex

1. 앱을 실행하고 내장 브라우저에서 ChatGPT 에 로그인.
2. 내장 스모크 테스트를 실행.
3. 모델 설치 를 누르고 Codex 를 재시작한 후, Codex 의 모델 선택기에서 ChatGPT Web — … 모델을 선택.

소스에서 실행 (Bun 1.4.0 필요)

git clone https://github.com/miuuyy/codex-chatgpt-web.git && cd codex-chatgpt-web
bun run app   # Electron 앱 실행

풀 허브 설정 (옵션, 툴 접근용)

1. 런처에서 MCP 를 열고 새 OpenAI 터널과 API 키를 생성.
2. ChatGPT 설정에서 개발자 모드 를 활성화하고, 모든 작업 허용 으로 설정된 Codex Native2 라는 이름의 새 커넥터를 생성.
3. 터널 ID 와 API 키를 런처에 붙여넣고 허브 연결 을 클릭.
4. 런타임을 확인; 오래된 Codex Native 커넥터로는 앱이 실행되지 않음.

주요 제한 사항 및 보안 주의사항

• 이는 브라우저 자동화 이며, 직접적인 OpenAI API 가 아님. ChatGPT 의 UI 변경 시 선택자 오류 발생 가능; 침묵적으로 실패하지 않고 오류를 발생시킴.
• 브라우저 쿠키와 로그인 상태는 로컬에 저장됨; 사용자 계정에 접근 가능한 사람은 세션을 재사용할 수 있음.
• 터널 클라이언트는 아웃바운드 연결만 수행; 인바운드 포트는 열리지 않음.
• 설치 파일은 아직 코드 서명되지 않아, macOS Gatekeeper 또는 Windows SmartScreen 가 경고할 수 있음.
• 이 프로젝트는 비공식이며 OpenAI 의 승인을 받지 않음; OpenAI 의 이용 약관 및 워크스페이스 정책을 준수해야 함.

라이선스

• MIT License (see LICENSE).

추가 정보

• 아키텍처 세부 정보: docs/architecture.md
• 보안 모델: docs/security-model.md
• 릴리스 검증 절차: docs/release-validation.md

---

이 요약은 리포지토리의 README 에 기반함.