🧭 Decision Guide
Why trending now: Cannot be determined from the provided materials
Try it if you
-
You want to use ChatGPT Web or Pro's separate quota from Codex's native model picker.The README says ChatGPT Web models, including Pro, are available from Codex's native model picker with separate ChatGPT Web usage limits.
-
Your Codex task needs ChatGPT to access current files, the terminal, tools, and approvals.The README's “Full harness” section says Full harness connects the current Codex task's files, terminal, tools, and approvals through MCP.
-
You run macOS 13+, Windows x64, or Linux x64 and want the bundled browser and runtime.The README's “Requirements & security” section lists macOS 13+, Windows x64, and Linux x64; “Get started” says separate Chrome, Node, or Bun installation is unnecessary.
Skip it if you
-
You need a stable OpenAI API integration rather than ChatGPT Web UI automation.The README explicitly says this is unofficial browser automation, not an OpenAI API, and ChatGPT UI changes can break selectors.
-
Your environment disallows unsigned applications and cannot accept Gatekeeper or SmartScreen warnings.The README's “Requirements & security” section says builds are not yet platform-signed and Gatekeeper or SmartScreen may warn.
-
You cannot keep the ChatGPT browser login state on a trusted workstation.The README says browser state is a sensitive login artifact, the loopback listener is reachable by same-user processes, and users should use a trusted workstation.
-
Your ChatGPT workspace or administrator policy does not allow Developer Mode, MCP apps, or write actions.The README's “Full harness” section says write and modify actions require the ChatGPT workspace and administrator policy to permit them.
Requirements
- Release packages target macOS 13+ (arm64/x64), Windows x64, and Linux x64.
- Full harness requires ChatGPT Developer Mode, a Tunnel connector named Codex Native2, Authentication set to None, and Allow all actions.
- Full harness requires creating the Tunnel and regular API key in the launcher's MCP page, pressing Connect harness, and running Verify runtime.
- The source development path requires Bun 1.4.0.
- The installer verifies the published SHA-256 manifest before installation.
First step (verbatim from README)
curl -fsSL https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.sh | sh
Watch out
-
In Automatic mode, choose a model ending in (Web); Pro versions have separate Codex entries.README “Get started” and “Models, modes & MCP setup” sections.
-
After changing the subagent protocol, restart Codex and start a new task.The README's “Diagnostics & subagents” section explicitly requires restarting Codex and starting a new task after switching Compatibility V1 or Native.
-
Enabling --auto-approve-tool-calls clicks Allow once only and does not grant permanent permission.The approval note in the README's “Full harness” section.
-
Do not share the launcher profile because it contains sensitive browser login state.README “Requirements & security” section.
Alternatives
-
OpenAI API:It is a better fit when you need a formal API interface rather than ChatGPT Web browser automation.README “Requirements & security” section
-
Zero Risk mode:It is a better fit when you need MCP tool capability but do not want automatic reading or operation of the ChatGPT page.README “Models, modes & MCP setup” section
Not stated in the README
- The README does not provide complete message allowances for every ChatGPT account type; it only links to the Limits discussion for GPT-5.6 Sol Pro and GPT-6 Astra.
- The README does not state how quickly browser automation is repaired after ChatGPT UI changes.
- The README does not provide release-package information for Windows ARM64 or Linux ARM64.
- The README does not quantify performance or latency differences between Full harness and Browser-only.
- The README does not state the platform-specific probability of installation blockage caused by unsigned builds.
💡 Deep Analysis
6
Yes
I can use ChatGPT Web, but I cannot allow automation to operate the ChatGPT page. I still want the model to have Codex tool access. Does Zero Risk fit better than Full harness?
Yes, Zero Risk fits your safety constraint better because it does not read or operate the ChatGPT page and leaves the send action for your confirmation; the trade-off is that continuous automatic sending is lost.
- The README explicitly says, “Zero Risk does not read or operate the ChatGPT page.”
- It requires you to choose the model, select the
Codex Zero Riskconnector, paste the prepared prompt, and confirm Sent in the launcher. - The mode table lists Sending messages as “Paste and send manually,” while Local Codex tools remain available through a separate MCP connector.
- Compared with Full harness, it reduces browser automation and accidental-send risk, but it cannot provide the same continuous autonomous execution experience.
It therefore fits workflows requiring human confirmation for every Web submission while retaining an MCP tool channel. If you also prohibit all tool calls, you should not enable that connector.
- Models, modes & MCP setup: Zero Risk does not read or operate the ChatGPT page
- Models, modes & MCP setup: Choose the model and `Codex Zero Risk` connector yourself, paste and send
- Mode table: Zero Risk | Paste and send manually | Yes, through a separate MCP connector
- Project insight solution_analysis: provides a manual-confirmation Zero Risk mode
Yes
I already have ChatGPT Plus or Pro, mainly use Codex for Q&A and code analysis, and do not need local files or terminal access. Is Browser-only mode suitable for me?
Yes, because your goal is to reuse ChatGPT Web models rather than connect local tools; Browser-only provides automatic sending and a Codex model entry without granting local access.
- The README says the project can use ChatGPT Web models available on the account, including Pro, with separate Web usage limits.
- Browser-only sends messages automatically, while Local Codex tools are marked No, matching your constraint.
- Models exposed by Plus or Pro are detected by the launcher. Pro versions have separate entries, and reasoning strength is selected through Effort.
- After installation, you must sign in, run the browser smoke test, install models, and restart Codex once; otherwise the model entry may not appear as expected.
If you later need to edit the current repository or run commands, Browser-only is no longer sufficient as a full tool-enabled agent.
- Get started: Use the ChatGPT Web models available on your account, including Pro
- Models, modes & MCP setup: Browser-only | Automatic | No
- Get started: Install models and restart Codex once
- Project description: without spending your Work or Codex quota
curl -fsSL https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.sh | sh
Yes
I use ChatGPT Free or Go and my account has no reasoning selector. Can the project give me Luna or Think in Codex instead of requiring Pro configuration?
Yes. The README explicitly provides a Luna / Think path for Free and Go accounts, so a reasoning selector or Pro entitlement is not required.
- The Available models section states: Free/Go → Luna / Think.
- The README says accounts with reasoning controls instead receive Instant–High, with Extra High and Pro when available.
- The launcher detects which models the account can actually use, so the available entry depends on account state rather than a manually forced Pro configuration.
- After installing models, you must restart Codex; in automatic mode, choose a model whose name ends in
(Web).
This means the project can improve Codex access for Free or Go users, but it cannot upgrade the account to Pro or guarantee the quota and long-term availability of Luna / Think.
- Get started: Available models: Free/Go → Luna / Think
- Get started: Accounts with reasoning controls → Instant–High, plus Extra High and Pro when available
- Get started: The launcher detects what your account can use
- Get started: In automatic mode, choose a model ending in (Web)
irm https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.ps1 | iex
Yes
I work on a real code repository in Codex and need ChatGPT to access the current task's files, terminal, and approval flow. Should I use Full harness instead of Browser-only?
Yes, provided that you can complete the MCP and ChatGPT Developer Mode setup; Full harness is the mode that explicitly connects the current Codex task to local tools.
- The Full harness documentation says MCP connects ChatGPT to the current task’s files, terminal, tools, and approvals.
- The mode table marks Full harness as Automatic for sending and Yes for Local Codex tools, while Browser-only is explicitly No.
- The project insight requires an outbound tunnel through the official OpenAI tunnel-client, plus Codex Native2 configuration, workspace permissions, and approval behavior.
- This is more than text forwarding: task-linked conversations allow context to remain associated with the Codex task.
It therefore fits interactive coding, but it is not an unsupervised local executor. The chain can still fail if the workspace or administrator policy blocks MCP, writes, or tool calls.
- Get started: For coding with tools, open MCP in the launcher
- README Full harness description: connects ChatGPT to the current task’s files, terminal, tools, and approvals through MCP
- Models, modes & MCP setup: Full harness (With Automation) | Automatic | Yes, through MCP
- Project insight solution_analysis: an outbound tunnel through the official OpenAI tunnel-client
It depends
My ChatGPT workspace is administrator-managed, and I cannot confirm whether Developer Mode, MCP, or file writes are approved. Can I still use this project for Codex tasks requiring local tools?
It depends. If the workspace blocks Developer Mode, MCP, or writes, Full harness is not suitable, although Browser-only may still work for tasks that do not need local tools.
- The README bases Full harness tool access on MCP and tells users to open MCP setup for coding with tools.
- The project insight adds that Full harness requires ChatGPT Developer Mode, workspace permissions, and potentially administrator approval.
- Browser-only explicitly has Local Codex tools set to No, so it cannot bypass workspace policy to access files, terminals, or approvals.
- Zero Risk avoids automatic ChatGPT-page operation, but it still relies on a separate MCP connector for local tools; it is not a workaround for a workspace prohibition.
The practical decision is therefore: use Browser-only in a managed workspace if local tools are unnecessary; before using any tool-enabled mode, confirm that Developer Mode, MCP applications, and the required workspace operations are approved.
- Get started: For coding with tools, open MCP in the launcher
- Project insight usage_limitations: Full harness requires ChatGPT Developer Mode, MCP connections, workspace permissions, and potentially administrator approval
- Mode table: Browser-only | Automatic | No
- Mode table: Zero Risk | Paste and send manually | Yes, through a separate MCP connector
It depends
I need to deploy it on macOS Intel, Windows x64, and Linux x64, and I want the package to include the browser and runtime. Does this project meet that requirement?
It depends. Those three platforms are within the project’s stated coverage, and the application includes its browser and runtime, but platform signing, first-run warnings, and unsupported architectures may still block deployment.
- The README lists macOS Intel, while the project insight identifies macOS 13+ arm64/x64, Windows x64, and Linux x64 as the main supported package targets.
- The Get started section says the app includes its browser and runtime, so separate Chrome, Node, or Bun installation is not required.
- Installers select the platform and architecture, verify published checksums, and preserve the ChatGPT profile and launcher settings.
- The project data identifies TypeScript as the main language and v6.1.2 as the latest release; the project insight also states that release packages are not platform-signed, which may trigger Gatekeeper or SmartScreen.
The target platforms and no-extra-runtime requirement therefore match well. If your organization requires signed installers or a different architecture, the README provides no sufficient guarantee.
- README header: macOS Intel · All releases
- Get started: The app includes its browser and runtime. No separate Chrome, Node, or Bun installation is needed
- Terminal install, updates & repair: select the platform and architecture, verify the published checksums
- Project insight usage_limitations: packages mainly cover macOS 13+ arm64/x64, Windows x64, and Linux x64
curl -fsSL https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.sh | sh
✨ Highlights
-
Codex's model picker can call ChatGPT Web and Pro
-
Full harness connects files, terminal, and tools through MCP
-
Plus Medium/High supports a 90,000-token context window
-
Releases target macOS 13+, Windows x64, and Linux x64
-
Browser login state is sensitive and the listener is reachable by same-user processes
🔧 Engineering
-
Run Codex tasks with ChatGPT Web models, images, and streaming
-
Full harness routes Codex tools back through OpenAI tunnel-client
-
Zero Risk uses the Codex Zero Risk connector for manual paste-and-send
⚠️ Risks
-
It is not an OpenAI API; ChatGPT UI changes can break selectors
-
Full mode requires correct Developer Mode and Codex Native2 configuration
-
Builds are unsigned, so Gatekeeper or SmartScreen may warn
-
Write actions depend on ChatGPT workspace and administrator policies
👥 For who?
-
Developers who need ChatGPT Web or Pro quotas inside Codex
-
Teams using MCP that want ChatGPT to access current-task tools
-
Users on macOS 13+, Windows x64, or Linux x64