miuuyy /codex-chatgpt-web

Use ChatGPT Web (including Pro) as a native model in Codex — with context, tools, streaming and images, without using Codex quota.

★ 15,743⑂ 1,229👁 44⑃ 326● 536▤ 67
TypeScriptMITCreated 2026-07-26
Download: v6.1.18v6.1.18 ↓6.1.182026-11-08
+14
Daily
+267
Weekly
+1,651
Monthly
15,743
stars
1,229
forks
44
watchers
326
prs
536
issues
67
releases

README

 
   
  



  macOS Intel · All releases



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



  



  Get started · What’s new · Architecture · Troubleshooting


Use the ChatGPT Web models available on your account, including Pro, from Codex’s native model picker. Messages run through your signed-in ChatGPT Web session and are subject to the limits applied to that account. 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

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


Windows PowerShell

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 p

Top issues

Discussions

Latest release

v6.1.18 v6.1.18 2026-11-08
V6 brings ChatGPT Web models into Codex's model and Effort selectors, optional Pro usage estimates, Bigger Context, and control over browser conversations. 6.1.18 improves long-task continuation, preserves goal changes, and fixes macOS passkey-session import.

 [!IMPORTANT]
 If Codex shows only Luna (Web) despite a paid ChatGPT account, install this update, open Setup → Install into Codex → Reinstall, and fully restart Codex. The update preserves your launcher settings and ChatGPT profile.

 Changes in 6.1.18

- Current workspace folders survive partial updates and compaction. The bridge check

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON