codex-chatgpt-web

环境要求

• macOS 或 Linux 或 Windows（启动器支持三平台）
• 使用现成启动器时无需模型 API Key、无需已装 Chrome/Chromium、无需系统 Node/Bun
• 若从源码运行，需要 Bun 1.4.0
• 已安装并可启动 Codex 应用
• 拥有 ChatGPT 账号（Free/Go 或 Pro 订阅）

安装与启动步骤

1. 1安装桌面启动器

   macOS/Linux 执行该命令安装或更新启动器；重复执行会替换应用与内置运行时，但保留 ChatGPT 配置与启动器设置。

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

   复制

2. 2Windows 安装启动器

   Windows 用户改用 PowerShell 命令安装。若已安装过，请先退出启动器再执行，以完成更新或修复。

   irm https://github.com/miuuyy/codex-chatgpt-web/releases/latest/download/install-launcher.ps1 | iex

   复制

3. 3源码方式运行

   不想用启动器时从源码启动。需 Bun 1.4.0，命令会自动安装锁定依赖并打开应用。

   git clone https://github.com/miuuyy/codex-chatgpt-web.git && \
   cd codex-chatgpt-web && \
   bun run app

   复制

4. 4登录 ChatGPT 账号

   在启动器内置的 ChatGPT 浏览器中直接登录，登录页与身份提供商窗口都留在同一私有浏览器配置文件内，不跨浏览器复制会话。

5. 5运行浏览器冒烟测试

   按应用内提示执行浏览器冒烟测试，确认内置浏览器与 ChatGPT 页面通信正常，再进行后续模型安装。

6. 6安装模型并重启 Codex

   点击 Install models 安装模型，手动重启一次 Codex，然后在模型选择器中选择 ChatGPT Web — 开头的模型。

关键配置

如何确认成功

启动器完成登录与冒烟测试后点击 Install models，重启 Codex 能在原生模型选择器看到 ChatGPT Web — Luna（或 Pro 等）模型，即为成功。

常见问题

注意事项

• 登录与模型对话都在启动器内置浏览器中完成，不会在不同浏览器之间复制会话。
• 源码方式要求 Bun 1.4.0，版本不符可能无法启动。
• 模型档位取决于账号实际权限，Pro 只在账号开放时出现。
• 遇到问题可查阅仓库的 TROUBLESHOOTING.md 与 SECURITY.md。