Codex Max 是基于 CoimgRain/Codex-Mini 原项目开发的 Windows 适配版。它保留原项目的 HTTP 服务、手机网页、token 鉴权、Codex session/history/status 解析和发送后追踪回复状态机制，重点补齐 Windows 上通过手机远程操控 Codex Desktop 的能力。
你可以在手机上打开一个本地网页，把文字或图片发送到 Windows 上正在使用的 Codex 对话中，并在网页里同步查看 Codex 的回复过程和结果。本仓库也保留 macOS 平台控制层，方便继续跟随原项目演进。
📌 开源版 / 构建版说明
本仓库提供 Codex Max 的开源维护版本，适合有服务器或开发能力的朋友自行部署、改造和二次开发。由于我个人精力有限，也希望通过开源让更多人一起参与改进。
目前官方 DMG 构建版仅支持 macOS。源码版已加入 Windows MVP 适配，并提供与 macOS App 同职责的 Windows 客户端源码工程，可构建免安装便携包或 Windows 安装包；Windows 版本暂不包含服务器中转能力。
如果你不想折腾部署，或者没有自己的服务器，可以直接下载我构建好的 DMG 应用 使用。DMG 构建版会持续维护，并优先提供最新功能；部分新功能可能不会第一时间同步到开源版，开源版会保持可用和维护，但节奏可能略滞后。感谢大家的支持，我也会在能力范围内持续把 Codex Max 优化好。
上面的提示是当前项目的版本定位：开源版方便自部署和二次开发，DMG 构建版适合直接安装使用并优先体验最新功能。
- 项目名：Codex Max
- 基线版本：基于上游 Codex Mini v3.0.5 源码适配
- 主要目标：Windows 本地源码版 / 免安装客户端 / 手机局域网遥控 Windows 上的 Codex Desktop
- 上游项目：CoimgRain/Codex-Mini
- 上游 macOS Release 参考：codex-mini-beta-v3.0.5
Codex Max 目前优先交付 Windows 可运行 MVP。macOS 相关能力和上游脚本仍保留在仓库中，方便对照和后续同步，但本仓库的主要维护方向是 Windows 版。
QQ 群：760669553
欢迎加入群里交流使用问题、反馈 bug、提出功能建议。后续有最新版本也会在群里及时沟通。
Windows 版当前以源码构建和免安装客户端为主：
- 克隆本仓库到 Windows 电脑。
- 确认 Codex Desktop 已安装、已登录，并能正常打开目标对话。
- 运行
.\scripts\build-codex-max-windows-single-exe.ps1构建单文件客户端。 - 打开
dist\windows\Codex Max SingleExe\Codex Max.exe。 - 在客户端里复制局域网入口，用手机浏览器打开。
- 手机和 Windows 电脑需要在同一个 Wi-Fi / 局域网。
- 建议把网页添加到手机主屏幕，作为 App 打开使用。
macOS DMG 安装包请参考上游 CoimgRain/Codex-Mini。
iPhone 上打开 Codex Max 网页后，按下面三步操作：
- 点浏览器底部或菜单里的“分享”
- 如果没看到“添加到主屏幕”，先点“查看更多”
- 点“添加到主屏幕”，之后从桌面图标打开 Codex Max
Windows 推荐先用 CDP 调试端口启动 Codex Desktop。CDP 可用时，Codex Max 会直接控制 Codex 的渲染页面，无需把 Codex 窗口拉到前台；CDP 不可用或发送图片附件时，会回退到原来的 GUI/剪贴板自动化路径。
Windows 版复用原有 HTTP 服务、手机网页、token 鉴权、Codex session/history/status 解析和发送后追踪回复状态的机制，只替换桌面自动化层。当前 Windows 控制层优先连接 Codex Desktop 暴露的 Chrome DevTools Protocol（CDP）页面 target，直接在 app://-/index.html 渲染层中新建项目线程、聚焦 ProseMirror 输入框、插入文本、点击发送按钮、停止按钮，并通过顶部智能菜单切换推理等级。只有在 CDP 不可用、需要发送图片附件，或执行模型/线程菜单类操作时，才回退到旧的 codex:// 深链 + UI Automation / 剪贴板 / SendKeys 路径。
开启 Codex Desktop CDP 的调试脚本：
powershell -ExecutionPolicy Bypass -File .\scripts\start-codex-cdp.ps1 -ForceRestart脚本会用 --remote-debugging-port=9222 重启 Codex，并检查 http://127.0.0.1:9222/json/list 是否暴露了 title: Codex、url: app://-/index.html 的 page target。本地服务默认连接 127.0.0.1:9222；如需换端口，可同时设置：
$env:CODEX_MAX_CDP_PORT = "9333"
powershell -ExecutionPolicy Bypass -File .\scripts\start-codex-cdp.ps1 -ForceRestart -Port 9333Windows 客户端工程位于 windows/CodexMini，职责对齐 macOS App。当前 Windows 客户端使用 WPF 实现，界面结构复刻 macOS SwiftUI 控制面板：顶部状态、HTTP/端口/线程指标、常用操作、本机入口和日志/启停入口。
客户端面板右侧会显示当前局域网入口二维码，手机扫码即可打开带 token 的控制页。操作区的“受控 Codex”按钮会调用本地服务重启官方 Codex Desktop，并自动附加 --remote-debugging-port 参数；手机页在处于 GUI 回退模式时也会显示一个小的 CDP 启动按钮。
- 生成并持久化手机访问 token
- 准备本地服务 payload
- 启动、停止、重启隐藏的 Node 本地服务
- 展示 HTTP 状态、端口、线程数量、最新线程标题和日志入口
- 打开网页、复制局域网入口
构建免安装便携版：
.\scripts\build-codex-max-windows-portable.ps1构建单文件免安装 exe：
.\scripts\build-codex-max-windows-single-exe.ps1默认输出：
dist\windows\Codex Max SingleExe\Codex Max.exe
单文件版会把 .NET Desktop Runtime、本地服务 payload 和 Node 一起嵌入 exe，首次运行时释放到 %APPDATA%\Codex Max 后启动本机服务。
默认输出：
dist\windows\Codex Max Portable
dist\windows\Codex-Max-Windows-Portable.zip
解压后直接运行 Codex Max.exe。便携版默认自带 .NET Desktop Runtime、Node、本地服务 payload 和 Windows 控制层，不需要先安装 Node 或 .NET。
构建客户端目录：
.\scripts\build-codex-max-windows.ps1也可以直接指定输出目录或内置 Node：
.\scripts\build-codex-max-windows.ps1 -OutputDir .\dist\windows\CodexMini -NodePath "C:\Program Files\nodejs\node.exe"构建后打开输出目录里的 Codex Max.exe。客户端会自动启动本机服务，并在界面里显示手机可访问的局域网入口。
构建完整 Windows 安装包：
.\scripts\build-codex-max-windows-installer.ps1如果希望安装包内置 .NET Desktop Runtime，让用户无需另装 .NET，可使用：
.\scripts\build-codex-max-windows-installer.ps1 -SelfContained安装器使用 Inno Setup 6 编译，输出到 dist\windows\installer\Codex-Max-Windows-Setup.exe。安装后会创建开始菜单入口，可选创建桌面快捷方式，并在安装完成后启动 Codex Max.exe。
开发调试时也可以直接运行服务：
npm install
$env:MOBILE_TYPER_TOKEN = "your-token"
node server.js然后把终端里打印的局域网地址复制到手机浏览器打开。手机和 Windows 电脑需要在同一个 Wi-Fi / 局域网；Codex Desktop 需要已安装、已登录，并且能在当前 Windows 桌面会话里通过 codex:// 拉起。
Windows 当前限制：
- 纯文本发送、新建项目线程、停止响应和推理模式切换优先走 CDP，可在 Codex 窗口后台完成。
- 图片附件、模型切换、归档、置顶、重命名等操作暂时仍会回退到 GUI/剪贴板路径。
- 如果 Codex 不是用
--remote-debugging-port启动，手机端顶部会显示GUI，表示当前处于前台自动化回退模式；显示CDP时才是无感控制。 - 不支持锁屏后操作、UAC 弹窗处理或管理员认证处理；这些系统级界面不在 CDP 渲染层内。
/send串行进入控制队列。CDP 纯文本发送不使用系统剪贴板；GUI 回退和图片附件仍会临时写入 Windows 剪贴板，发送期间请避免手动改剪贴板。- Windows 自动化层会启动一个隐藏的常驻 helper，避免每个 GUI 动作都重新启动 PowerShell；keep-awake 仍使用独立保持亮屏进程。
- keep-awake 使用 Windows
SetThreadExecutionState，服务退出或关闭 keep-awake 后会停止保持亮屏。
Codex Max 是一个手机到 Mac 上 Codex Desktop 的轻量桥接工具，核心流程大致如下：
- Mac 上运行一个本地服务，默认由
Codex Max.app管理 - 手机网页把文字或图片发送到这台 Mac
- 本地服务读取 Codex Desktop 的会话状态，并通过 macOS 自动化把内容粘贴到当前 Codex 线程里
- 本地服务继续读取 Codex 会话日志，把可见回复、运行状态、工具调用过程等同步回手机网页
- 在同一个 Wi‑Fi 下，手机优先直连局域网入口，速度更快
- 开启 Pro 后，手机也可以走服务器中转入口；当你在外面、不在同一个局域网时，仍然可以连接自己的 Mac 并远程操控 Codex
也就是说，Codex Max 本身不是云端聊天服务。服务器中转只负责把手机请求转回你自己的 Mac，真正的 Codex 登录状态、线程切换、输入和回复读取仍然发生在你的 Mac 上。
- 本地局域网功能永久免费：手机和 Mac 在同一个 Wi‑Fi / 局域网下即可使用
- Pro 会员解锁外网入口：通过服务器中转连接自己的 Mac，不在同一个 Wi‑Fi 下也可以使用
- 当前支持 7 天免费试用、月度、季度和年度计划
- Pro 激活后请重新复制新的外网入口到手机上；旧的局域网入口只适合同一网络下使用
- 服务器中转只做连接转发，不代替你的 Codex 账号，也不保存聊天正文或图片内容
- 请不要把自己的访问链接、令牌或电脑隐私信息发给陌生人
- 为了保持服务稳定，图片大小、图片频率和套餐流量会有合理限制
- 请确保 Mac 上已经安装并登录 Codex Desktop
- 请保持 Codex Desktop 可正常使用
- 请不要把自己的访问链接、令牌或电脑隐私信息发给陌生人
- 当前是 Beta 版本，可能存在兼容性问题，欢迎进群反馈
本仓库提供 Codex Max 的开源维护版本，适合希望自行部署、接入自己的服务器或进行二次开发的用户。
如果你更希望开箱即用，或者想优先体验最新功能，建议直接下载 Releases 中的 DMG 构建版。构建版会持续维护，部分新功能可能会先在构建版中发布，再逐步同步到开源版本。