README

 
   
  



  macOS Intel · 所有版本



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



  



  开始使用 · 更新内容 · 架构 · 故障排除


在 Codex 原生模型选择器中使用账户可用的 ChatGPT 网页版模型，包括 Pro。消息通过已登录的 ChatGPT 网页会话发送，并受该账户适用的使用限制约束。保留原有的界面、任务、图片和流式输出。

完整 harness 模式通过 MCP 将 ChatGPT 连接到当前任务的文件、终端、工具和审批流程。对话始终关联到你的 Codex 任务，上下文增长时也能继续工作。



 开始使用

可用模型： Free/Go → Luna / Think；具有推理控制选项的账户 → Instant–High，并按实际可用状态提供 Extra High 和 Pro。启动器会自动检测账户可用的模型。

1. 安装启动器：点击上方对应系统的下载按钮。
2. 登录 ChatGPT：在内置浏览器中登录并运行浏览器冒烟测试。
3. 安装模型：重启一次 Codex。在自动模式下，选择名称以 (Web) 结尾的模型。Pro 版本使用独立条目，Sol 推理等级通过 Effort 选择。Zero Risk 保留专用条目。
4. 需要使用工具编程时：打开启动器中的 MCP，完成下方的完整 harness 设置。

应用已包含浏览器和运行时，无需另外安装 Chrome、Node 或 Bun。


命令行安装、更新与修复

更新前请退出启动器。以下安装脚本会选择正确的平台和架构、验证发布的校验和，并保留 ChatGPT 配置文件和启动器设置。

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





模型、模式与 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。

1. 完成启动器中的必需设置。
2. 在启动器中打开 MCP。请在将使用 ChatGPT 连接器的同一个 OpenAI 账户中创建 Tunnel
   和普通 API 密钥；创建密钥本身免费，也不会消耗模型 API 额度。
3. 粘贴 Tunnel ID 和 API 密钥，然后点击 连接 Harness。
4. 在 ChatGPT 设置中启用 开发者模式。新建连接器时选择 Tunnel，选择刚创建的
   Tunnel，将 身份验证 设为 无，并将名称准确设置为 Codex Native2。
5. 在 Codex Native2 的 权限 中选择 允许所有操作；允许低风险操作 会在命令和
   补丁到达本地运行时前将其拦截。外层 Codex harness 仍会执行沙箱和审批规则。
6. 运行 验证运行时，确认 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 并创建新任务：

bash
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 或 SmartS