官方 ChatGPT App
適合普通 Codex 遠程控制。從 Mac 上的 Codex App 開始設置手機連接，掃 QR 後在 ChatGPT App 內完成連接。
Official ChatGPT Remote + Self Hosted Relay
用 iPhone 接續 Mac 上的 Codex
Codex 現在已支持通過 ChatGPT 手機 App 連接 Mac 端。CodexMobile 會與官方方案並行： 普通遠程控制可使用 ChatGPT App；需要自托管 VPS、私有 Relay、獨立 App 和安裝包交付時，使用 CodexMobile。
官方路徑
ChatGPT App 可連接正在運行 Codex App 的 Mac，用於日常遠程控制和審批。
自托管路徑
CodexMobile 使用客戶自己的 VPS、域名與 Token，連線權限掌握在自己手上。
Mac 控制中心
菜單欄負責保持喚醒、連線診斷、Codex App 檢查、配對和自托管參數。
托管待開放
沒有 VPS 的用戶可優先使用官方 ChatGPT 遠程連接；托管 Relay 後續另行通知。
Two Paths
官方遠程連接和 CodexMobile 自托管並行
Mac 菜單欄客戶端
以 ZIP 安裝包交付，負責啟動本機服務、自動重連、防止待機、生成手機配對 QR 與管理桌面端參數。
新版菜單欄會檢查 Codex CLI、Codex App、Remote Control 和 ChatGPT Remote Ready 狀態，也可一鍵打開 Codex App。
VPS Relay 部署包
客戶有 VPS 時，部署 App API、Relay、Nginx HTTPS 與 systemd 服務，手機從外網安全轉回 Mac。
托管 Relay 服務
托管 Relay 暫未開放。收費方式、設備數、支持範圍和服務邊界確定後，會在官網另行通知。
CodexMobile iPhone App
已開放 TestFlight 公開測試，面向自托管 Relay、私有 Token、獨立 App 體驗和客戶化交付。
Default Path
默認流程：客戶使用自己的 VPS
1
部署 VPS Relay
在客戶 VPS 上部署 CodexMobile App API，配置 HTTPS 域名與 `CODEXMOBILE_APP_API_TOKEN`。
→
2
安裝 Mac 客戶端
在 Mac 菜單欄填 API URL、App Token、Mac Service Token 與專案根目錄，再啟動本機服務和桌面橋接。
→
3
手機掃碼配對
Mac 菜單欄生成 QR，iPhone 掃描後自動填入 API URL 和 Token，再測試連線。
Configuration
參數放在客戶端設置裡
手機端設置
- API URL：自托管 VPS Relay 地址，可由 Mac 配對 QR 自動寫入。
- Token：`CODEXMOBILE_APP_API_TOKEN` 或托管服務分配的用戶 Token。
- Face ID：可選開啟，每次重新打開 App 時驗證後再查看內容。
- 測試連線：保存前確認手機能連到 Relay 並通過認證。
Mac 菜單欄設置
- 手機連線 API URL。
- 手機 App Token 與 Mac 本機服務 Token。
- 專案根目錄：手機端看到和新建項目的默認桌面位置。
- Codex 診斷：檢查 Codex CLI、Codex App、Remote Control 和 ChatGPT Remote Ready。
- 開機自啟、自動連線、保持 Mac 醒著、重新連線和打開 Codex App。
Managed Relay
托管 Relay 暫未開放
目前先開放自托管 VPS 和 TestFlight 體驗
托管 Relay 會適合不懂 VPS、沒有域名、不想維護 HTTPS 和 systemd 的客戶。但目前收費方式、設備數、 支持範圍和服務邊界仍在整理中，因此暫不對外開放。
現階段建議有 VPS 的用戶先走自托管部署；沒有 VPS 的用戶可以先加入 TestFlight 了解手機端體驗，等待托管 Relay 後續開放通知。
客戶自己有 VPS
你提供部署包和安裝說明，客戶自己保存服務器、域名和 Token。
客戶沒有 VPS
托管 Relay 目前不接受購買或申請，後續會在官網公布開放時間和方案。
最小化數據
托管模式應明確說明 Relay 的日誌、保存範圍、Token 失效和撤銷方式。
Architecture
手機、VPS、Mac 三段式連線
iPhone
CodexMobile App
查看桌面會話、補充需求、處理審批、上傳附件、接收桌面截圖。
→
VPS
Relay / App API
驗證手機 Token，轉發請求到 Mac，提供外網可訪問的 HTTPS API。
→
Mac
Menu Bar + Desktop Bridge
維持本機服務、反向隧道與 Codex Live 會話，讓手機接續同一個 thread。
Next Step
先選官方路徑或自托管路徑
只需要遠程控制 Codex 時，可先使用官方 ChatGPT App。需要私有 Relay、自己的 VPS 和獨立 App 交付時，再使用 CodexMobile 自托管方案。