miuuyy/codex-chatgpt-web
miuuyy/codex-chatgpt-web has 15,678 GitHub stars and 1,228 forks. GitHot measured +20 stars in 24 hours and +157 in 7 days. Last checked 2026-11-12 02:38 UTC. Last push 2026-10-30.
Use ChatGPT Web (including Pro) as a native model in Codex — with context, tools, streaming and images, without using Codex quota.
实测星标增长
- 24小时
- +20
- 7天
- +157
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
README.zh-CN.md
原文
在 Codex 原生模型选择器中使用账户可用的 ChatGPT 网页版模型,包括 Pro。消息通过已登录的 ChatGPT 网页会话发送,并受该账户适用的使用限制约束。保留原有的界面、任务、图片和流式输出。
完整 harness 模式通过 MCP 将 ChatGPT 连接到当前任务的文件、终端、工具和审批流程。对话始终关联到你的 Codex 任务,上下文增长时也能继续工作。
开始使用
可用模型: Free/Go → Luna / Think;具有推理控制选项的账户 → Instant–High,并按实际可用状态提供 Extra High 和 Pro。启动器会自动检测账户可用的模型。
- 安装启动器:点击上方对应系统的下载按钮。
- 登录 ChatGPT:在内置浏览器中登录并运行浏览器冒烟测试。
- 安装模型:重启一次 Codex。在自动模式下,选择名称以 (Web) 结尾的模型。Pro 版本使用独立条目,Sol 推理等级通过 Effort 选择。Zero Risk 保留专用条目。
- 需要使用工具编程时:打开启动器中的 MCP,完成下方的完整 harness 设置。
应用已包含浏览器和运行时,无需另外安装 Chrome、Node 或 Bun。
命令行安装、更新与修复
更新前请退出启动器。以下安装脚本会选择正确的平台和架构、验证发布的校验和,并保留 ChatGPT 配置文件和启动器设置。
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
模型、模式与 MCP 设置
自动模式在账户没有推理选择器时提供 Luna/Think;否则提供 Instant–High,并分别按账户实际可用状态显示 Extra High 和 Pro。
| 模式 | 发送消息 | 本地 Codex 工具 |
|---|---|---|
| Browser-only | 自动 | 不支持 |
| Full harness (With Automation) | 自动 | 支持,通过 MCP |
| Zero Risk | 手动粘贴并发送 | 支持,通过独立 MCP 连接器 |
Zero Risk 不读取或操作 ChatGPT 页面。请自行选择模型和 Codex Zero Risk 连接器,粘贴并发送准备好的提示词,再在启动器中确认 Sent。名称以 (Web) 结尾的自动模型会在 Codex 中提供其支持的 Effort 选项。Instant 和各个 Pro 版本使用独立条目,以保留各自的上下文额度;旧任务中保存的模型条目仍使用原来的固定模式。
完整 harness
完整模式通过官方 OpenAI tunnel-client 将 ChatGPT 的工具调用连接回当前 Codex 任务。该隧道为出站连接:不会暴露公网 IP、开放入站端口, 也不需要配置路由器端口转发。
限制
有关 GPT-5.6 Sol Pro 和 GPT-6 Astra 当前的 ChatGPT 消息额度,请参阅 Limits。Token 上下文上限取决于 账户类型和所选 effort。Plus 的 Medium/High 使用实测的 90,000-token 窗口;启用实验性的 3× context 后最高为 270,000 tokens,并且全程支持原生 Codex compaction。
- 完成启动器中的必需设置。
- 在启动器中打开 MCP。请在将使用 ChatGPT 连接器的同一个 OpenAI 账户中创建 Tunnel 和普通 API 密钥;创建密钥本身免费,也不会消耗模型 API 额度。
- 粘贴 Tunnel ID 和 API 密钥,然后点击 连接 Harness。
- 在 ChatGPT 设置中启用 开发者模式。新建连接器时选择 Tunnel,选择刚创建的 Tunnel,将 身份验证 设为 无,并将名称准确设置为 Codex Native2。
- 在 Codex Native2 的 权限 中选择 允许所有操作;允许低风险操作 会在命令和 补丁到达本地运行时前将其拦截。外层 Codex harness 仍会执行沙箱和审批规则。
- 运行 验证运行时,确认 Codex Native2 已连接并可用。
写入/修改操作还需要 ChatGPT 工作区及其管理员政策允许。请参阅
开发者模式和 MCP 应用。
除非显式启用 --auto-approve-tool-calls,否则意外的审批提示会直接失败;该选项只会点击
Allow once,绝不会授予永久权限。
诊断与子代理
使用 活动 页面查看安全的本地诊断,并通过 设置 → 运行诊断 执行端到端健康检查。设置页还可
取消保留的浏览器任务,或在卸载前移除 Codex 集成。仅在需要为每个浏览器检查点保存截图时设置
CODEX_CHATGPT_WEB_BROWSER_DIAGNOSTICS=1。
新安装默认使用 Compatibility V1 以支持跨后端 subagent。Native 会保留 Codex 自身的 功能设置,并启用明文 Web-to-Web V2 委派。切换协议后,请重启 Codex 并创建新任务:
codex-chatgpt-web subagents status
codex-chatgpt-web subagents compatibility-v1
codex-chatgpt-web subagents native
系统要求与安全
- 这是非官方浏览器自动化,并非 OpenAI API。ChatGPT UI 变更可能破坏选择器;发生变化时会明确 失败,而不是静默切换模型或传输方式。
- 浏览器状态是敏感的登录凭据,loopback 监听器也可被同一本地用户运行的进程访问。切勿共享 启动器 profile,并仅在可信工作站上使用。
- 发布包目前支持 macOS 13+(arm64/x64)、Windows x64 和 Linux x64。运行时、测试和打包会在 CI 中对三种系统进行检查;依赖账户的浏览器与 MCP 流程使用单独的 发布验证。
- 构建目前尚未进行平台签名,因此 Gatekeeper 或 SmartScreen 可能会显示警告。安装程序会在安装前 验证已发布的 SHA-256 清单。
启用完整模式前,请阅读完整的架构说明和 安全模型。安全漏洞请通过 SECURITY.md 报告。
任务默认使用“临时聊天”,不会保留在 ChatGPT 历史记录中。可在设置中关闭此选项以使用普通聊天;如果连接器不可用,也请关闭此选项。提示词仍由 OpenAI 处理。
验证范围:发布验证。
本项目是独立软件,与 OpenAI 无关联,也未获得 OpenAI 背书。请仅使用自己的账户,并遵守适用的 使用条款和工作区政策;本项目不会绕过身份验证或 访问控制。
从源码运行与开发
git clone https://github.com/miuuyy/codex-chatgpt-web.git && \
cd codex-chatgpt-web && \
bun run app
源码方式需要 Bun 1.4.0。该命令会安装锁定版本的依赖并打开应用。
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 在 ~/.codex-chatgpt-web-dev 下使用独立配置和账户。dev:chat 使用真实浏览器与压缩流程,并提供明确的模拟工具结果,不改变正常 Codex 路由。设置和命令请参阅 DEV chat harness。
Star History
我的另一个项目: ChatGPT Persona Voice — 为 ChatGPT 和 Codex 提供本地、近实时的自定义声音。