Codex 很强,但它的模型选择有限,且高级功能往往需要昂贵的订阅或特定的 API 额度。ChatGPT Web for Codex 是一个非官方的桥接工具,它通过自动化浏览器操作,将网页版 ChatGPT(包括 Free、Plus 和 Pro 账户)无缝集成到 Codex 的工作流中。

这意味着你可以直接在 Codex 的模型选择器里看到并调用 ChatGPT Web — Luna 或 Pro,让网页版的强大推理能力和多模态理解力为本地代码任务服务,而无需修改原有的 Codex 配置或工作习惯。
核心亮点:无感集成,原生体验
- 真正的“原生”模型:它在 Codex 看来就是一个普通的模型选项。你依然使用 Codex 的原生界面、任务生命周期和追踪系统,只是背后的“大脑”换成了网页版 ChatGPT。
- 跨平台一键安装:提供精致的 macOS、Windows 和 Linux 启动器。一条命令即可完成安装、登录引导、环境检查和 MCP 配置。
- 本地优先,隐私隔离:每个 Codex 任务都会触发一个全新的 ChatGPT 临时聊天(Temporary Chat)。这些聊天不会存入你的普通历史记录,任务结束后即焚,确保上下文隔离。
- 完整 Harness 支持:通过 OpenAI Tunnel 和 MCP 连接器,非 Pro 模型可以调用本地的文件系统、Shell 和图片处理能力。工具调用的真实结果会直接传回浏览器,而不是被模拟成文本。
工作原理:浏览器里的“影子舞者”
- 上下文编译:当你向 Codex 发送请求时,桥接程序会将当前任务的上下文(代码、提示词、图片)打包。
- 临时会话:它在后台启动一个专用的 Chrome/Chromium 实例,登录你的 ChatGPT 账户,并创建一个临时聊天窗口。
- 流式交互:它将上下文发送给 ChatGPT,并实时捕获网页上的推理过程、工具活动和 Markdown 输出,流式传回 Codex 界面。
- 工具闭环:在完整模式下,如果 ChatGPT 决定调用工具(如读取文件),请求会通过 Tunnel 传回本地 Codex 运行时,执行后再将结果发回网页端继续推理。
快速上手
1. 安装启动器
- 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
2. 完成三项检查
打开启动器应用,按照指引完成:
- 登录:在弹出的专用 Chrome 窗口中登录 ChatGPT 并保持窗口打开,直到启动器捕获会话。
- 冒烟测试:运行内置的浏览器健康检查。
- 安装模型:点击按钮,重启 Codex。现在你应该能在模型列表里看到
ChatGPT Web — ... 了。
3. 启用完整 Harness (可选)
如果你希望 ChatGPT 能读写本地文件:
- 在启动器中打开 MCP 页面。
- 创建一个新的 OpenAI Tunnel 和 API Key。
- 在 ChatGPT 网页端的开发者模式中,新建名为
Codex Native2 的连接器,权限设为“允许所有操作”。 - 在启动器中填入 Tunnel ID 和 Key,点击连接。
注意事项与限制
- 非官方项目:这是基于浏览器自动化的方案,ChatGPT 网页 UI 的重大变更可能会导致工具失效(虽然它会明确报错而非静默失败)。
- 账户安全:浏览器状态包含登录凭据,请仅在可信的个人设备上使用,不要共享启动器配置文件。
- Pro 模式限制:由于 ChatGPT Pro 目前不暴露自定义 MCP 连接器,它在完整模式下只能进行只读操作或深度分析,无法主动发起复杂的本地工具链调用。
- 并发上限:为避免账号被封,启动器限制最多同时运行 5 个绑定的浏览器标签页。