codex-chatgpt-web README

The project's README from github.com/miuuyy/codex-chatgpt-web. As one markdown file: README.md.

Switch to web models. Stay in Codex. Your ChatGPT plan. Your workflow. Maximum capabilities.

Windows · x64  macOS · Apple silicon  Linux · x64

macOS Intel · All releases

English · 简体中文 · 日本語 · 한국어

A live ChatGPT Web turn using the native Codex harness

Get started · What’s new · Architecture · Troubleshooting

Use the ChatGPT Web models available on your account, including Pro, from Codex’s native model picker—with ChatGPT Web’s separate usage limits, without spending your Work or Codex quota. Keep the same interface, tasks, images, and streaming.

Full harness mode connects ChatGPT to the current task’s files, terminal, tools, and approvals through MCP. Conversations stay tied to your Codex task, so you can keep working as the context grows.

Get started

Available models: Free/Go → Luna / Think. Paid accounts → GPT-6 Sol and GPT-5.6 Sol, with Instant–High, plus Extra High and Pro when available. Each version has its own entry; existing GPT-5.6 chats keep GPT-5.6. Availability depends on your account and workspace.

  1. Install the launcher using the download for your system above.
  2. Sign in to ChatGPT in the embedded browser and run the browser smoke test.
  3. Install models and restart Codex once. In automatic mode, choose a model ending in (Web). Pro versions have separate entries; Sol reasoning is selected through Effort. Zero Risk keeps its dedicated entry.
  4. For coding with tools, open MCP in the launcher and complete the Full harness setup below.

The app includes its browser and runtime. No separate Chrome, Node, or Bun installation is needed.

Terminal install, updates & repair

Quit the launcher before updating. These installers select the platform and architecture, verify the published checksums, and preserve your ChatGPT profile and launcher settings.

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
Models, modes & MCP setup

Automatic modes offer Luna/Think when the account has no reasoning selector; otherwise Instant–High, with Extra High and Pro available independently when exposed by the account.

Mode Sending messages Local Codex tools
Browser-only Automatic No
Full harness (With Automation) Automatic Yes, through MCP
Zero Risk Paste and send manually Yes, through a separate MCP connector

Zero Risk does not read or operate the ChatGPT page. Choose the model and Codex Zero Risk connector yourself, paste and send the prepared prompt, then confirm Sent in the launcher. Automatic models ending in (Web) expose their supported Effort choices in Codex. Instant and each Pro version have separate entries to preserve their context budgets; older saved model entries keep their original fixed mode.

Full harness

Full mode connects ChatGPT's tool calls back to the current Codex task through the official OpenAI tunnel-client. The tunnel is outbound: it does not expose a public IP, open an inbound port, or require router forwarding.

The launcher's MCP page guides the complete setup. For the exact clicks, see the video walkthroughs.

Limits

See Limits for the current ChatGPT message allowances for GPT-5.6 Sol Pro and GPT-6 Astra. Context limits depend on the account type and selected effort. Plus Medium/High uses a measured 90,000-token window. GPT-5.6 supports up to 270,000 tokens with experimental 3× context enabled, with native Codex compaction supported throughout.

GPT-6 Sol supports Bigger Context at Medium, High and available Extra High: 120,000 tokens on Plus, with compaction at 110,000, and 240,000 on Pro, with compaction at 220,000. GPT-6 Instant uses standard context. GPT-5.6 and GPT-6 Pro keep their existing Bigger Context limits.

  1. Finish the required setup, open MCP, create the Tunnel and regular API key, then press Connect harness.
  2. Enable ChatGPT Developer Mode and create a new Tunnel connector named exactly Codex Native2, with Authentication: None and Allow all actions.
  3. Run Verify runtime to confirm that Codex Native2 is attached and available.

Write/modify actions also require the ChatGPT workspace and its administrator policy to permit them. See developer mode and MCP apps. Unexpected approval prompts fail closed unless --auto-approve-tool-calls is explicitly enabled; that option clicks Allow once, never a permanent grant.

Diagnostics & subagents

Use Activity for safe local diagnostics and Settings → Run doctor for end-to-end health. Settings can also cancel a retained browser turn or remove the Codex integration before uninstall. Save chats in ChatGPT keeps task conversations in ChatGPT history. Off by default; independent of New browser chat for each turn. Set CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS=1 only when every browser checkpoint needs a screenshot.

New installs use Compatibility V1 for cross-backend subagents. Native preserves Codex's own feature settings and enables plaintext Web-to-Web V2 delegation. Restart Codex and start a new task after changing the protocol:

codex-chatgpt-web subagents status
codex-chatgpt-web subagents compatibility-v1
codex-chatgpt-web subagents native
Requirements & security

  • This is unofficial browser automation, not an OpenAI API. ChatGPT UI changes can break selectors; drift fails explicitly instead of silently switching model or transport.
  • Browser state is a sensitive login artifact, and the loopback listener is reachable by processes running as the same local user. Never share the launcher profile; use a trusted workstation.
  • Release packages currently target macOS 13+ (arm64/x64), Windows x64, and Linux x64. Runtime, tests, and packaging are gated on all three in CI; account-bound browser and MCP flows use the separate release validation.
  • Builds are not yet platform-signed, so Gatekeeper or SmartScreen may warn. The installers verify the published SHA-256 manifest before installation.

Read the complete architecture and security model before enabling full mode. Report vulnerabilities through SECURITY.md.

Temporary Chat is a ChatGPT privacy mode; prompts are still processed by OpenAI.

Validation coverage: release validation.

This is independent software and is not affiliated with or endorsed by OpenAI. Use it only with your own account and in accordance with applicable Terms of Use and workspace policies; it does not bypass authentication or access controls.

Run from source & develop 

git clone https://github.com/miuuyy/codex-chatgpt-web.git && \
cd codex-chatgpt-web && \
bun run app

This source path requires Bun 1.4.0. The command installs locked dependencies and opens the app.

bun run app
bun run dev:launcher
bun run src/cli.ts dev status
bun run dev:chat compaction-lab "Reply with exactly: DEV READY"
bun run verify
bun run smoke:subagents
bun run app:package

dev:launcher uses a separate profile and account under ~/.codex-chatgpt-web-dev. dev:chat exercises the real browser and compaction paths with explicit simulated tool results, without changing your normal Codex route. See the DEV chat harness for setup and commands.

Star History

Star History Chart

Troubleshooting · Security · Contributing · MIT license · CI

Also by me: ChatGPT Persona Voice — local, near-real-time custom voices for ChatGPT and Codex.

codex-chatgpt-web (miuuyy/codex-chatgpt-web)

Searching Database…

14.4K ·GitHub
Codex-chatgpt-web
Что это такое?Десктопный лаунчер, который позволяет Codex использовать ChatGPT Web (включая Pro) как нативную модель. Контекст задачи, изображения, инструменты и потоковый вывод передаются через браузерный режим ChatGPT Temporary Chat, а не через Codex API.
Это плагин внутри Codex или отдельное приложение, которое с ним связывается?Это самостоятельное кроссплатформенное приложение-лаунчер. Оно запускает встроенную браузерную сессию и через MCP связывает её с выбором моделей в Codex. При этом Codex сохраняет свой родной интерфейс задач, контекст и обвязку инструментов (tool harness).
Как вывести ChatGPT Web в выборе моделей Codex?Установите десктопный лаунчер командой для macOS/Linux или командой Windows PowerShell, войдите в аккаунт во встроенном браузере лаунчера, запустите тест браузера (browser smoke test), затем нажмите «Install models» и перезапустите Codex, чтобы выбрать модель ChatGPT Web.
Нужен ли мне ключ API OpenAI или какое-то ПО, которое надо установить заранее?Ключ API модели не нужен. Для собранного лаунчера в системе не требуются Chrome/Chromium, Node или Bun. При запуске из исходников нужен Bun 1.4.0.
В чём подвох? Это официальная интеграция OpenAI?Нет, это неофициальная браузерная автоматизация. Если интерфейс ChatGPT изменится, селекторы могут сломаться. В таком случае проект явно выдаёт ошибку и не переключает модель или транспорт молча. Кроме того, релизные сборки пока не подписаны платформенной подписью, поэтому Gatekeeper или SmartScreen могут выдавать предупреждение.
Какие операционные системы лаунчер реально поддерживает?Релизные пакеты рассчитаны на macOS 13+ (arm64/x64), Windows x64 и Linux x64. Все три платформы проверяются в CI.
Может ли это подвергнуть риску мой аккаунт ChatGPT и куда уходят мои данные?Состояние входа в браузере — чувствительные данные, которые должны храниться только на доверенном компьютере. Temporary Chat — это лишь режим приватности: ваши запросы всё равно отправляются в OpenAI и обрабатываются там по политике Temporary Chat, а не выполняются локально.
Какие три режима работы: Browser-only, Full harness, Zero Risk?Browser-only даёт доступ к моделям ChatGPT без доступа к локальным инструментам. Full harness (With Automation) позволяет каждому уровню усилий, включая Pro, использовать файловую систему, shell и инструменты текущей задачи Codex через MCP. Zero Risk сохраняет полную обвязку Codex, но вам нужно вручную скопировать подготовленный запрос, вставить его и отправить. Так исчезает риск для аккаунта из-за браузерной автоматизации.
Это действительно экономит мою квоту Codex?Да: выбранный ход модели направляется через Temporary Chat в ChatGPT Web, а не через Codex API, поэтому квота Codex не расходуется. Однако на эту модель по-прежнему распространяются собственные лимиты сообщений вашего аккаунта ChatGPT для данного уровня.
Для чего нужен коннектор «Codex Native2»?Это коннектор ChatGPT Developer Mode Tunnel (создаётся с Authentication: None и Allow all actions), который обязательно должен называться «Codex Native2». Благодаря ему режим Full harness может возвращать вызовы инструментов ChatGPT в запущенную задачу Codex через официальный клиент туннеля OpenAI (tunnel-client).
Может ли бесплатный аккаунт ChatGPT использовать это или нужен Plus/Pro?Аккаунты Free/Go видят только уровень «Luna». Аккаунты Plus получают уровни от Instant до High effort, а аккаунты Pro дополнительно открывают уровни Extra High и Pro effort. Лаунчер сам определяет, какие уровни доступны вашему аккаунту.
What are similar projects?reticle, chat-on-steroids, OmniRoute, newsjack, holaOS, mixdog, cc-haha, rowboat
Which topics is it in?free-ai, bun, playwright, gpt, browser-automation, chatgpt, electron, artificial-intelligence, coding-agent, desktop, openai, codex
Creator
miuuyy
Size
26.8 MB
Stars
14.4K
Updated
CommitOct 17Releasev6.1.10Oct 17
Age
2mo
Commits · 90 Days