CodexMobile
選單

Workflow

從 TestFlight 到日常使用

  1. 先選連接方式：普通 Codex 遠程控制可用官方 ChatGPT App；自托管、私有 Relay 或獨立 App 才使用 CodexMobile。
  2. 官方路徑：打開 Mac 上的 Codex App，選「Set up Codex mobile」，用手機掃 QR 後在 ChatGPT App 完成連接。
  3. CodexMobile 路徑：通過公開 TestFlight 連結，在 iPhone 安裝 CodexMobile 測試版。
  4. 準備自托管 VPS Relay。托管 Relay 暫未開放，後續會在官網另行通知。
  5. 安裝 Mac 菜單欄客戶端，填入 API URL、App Token、Mac Service Token、專案根目錄。
  6. 在 Mac 菜單欄打開自動連線，確認本機服務、桌面橋接、Relay tunnel、Codex App 和 ChatGPT Remote Ready 狀態。
  7. 在 Mac 菜單欄生成手機配對 QR，用 iPhone 掃描後自動寫入 API URL 和 Token。
  8. 手機端測試連線後，選擇項目和 thread，接續 Mac 上的 Codex Live 會話。
  9. 外出時用手機補充需求、查看進度、審批命令、打開圖片或文件預覽。
  10. 回到 Mac 後，從同一個項目與 thread 繼續工作。

Mac Menu Bar

Mac 菜單欄是本機控制中心

連線狀態

  • 顯示 Mac 本機服務是否啟動。
  • 顯示 Relay tunnel 是否連上 VPS。
  • 顯示 desktop bridge 是否能接到 Codex Live 狀態。
  • 顯示 Codex CLI、Codex App、Remote Control 和 ChatGPT Remote Ready。
  • 顯示目前項目、thread、網路和防止待機狀態。

參數設置

  • 手機連線 API URL。
  • 手機 App Token。
  • Mac 本機服務 Token。
  • 專案根目錄：手機端項目列表、新建項目和桌面同步的默認根位置。
  • OpenAI API Key，用於手機語音轉文字等輔助能力。

配對 QR

  • 菜單欄根據 API URL 和 App Token 生成 QR。
  • iPhone 掃描後自動打開 App 並寫入設置。
  • Token 更新後，重新生成 QR 再掃一次即可。

常用操作

  • 開機自動啟動：Mac 登入後自動載入。
  • 自動連線：自動拉起本機服務和 tunnel。
  • 保持 Mac 醒著：外出遠程使用時避免睡眠斷線。
  • 刷新連線：換網路或連不上時快速恢復。

Mobile App

手機端負責接續，不負責複雜管理

連線設置

官方 ChatGPT 遠程連接不需要填 CodexMobile API。只有使用 CodexMobile 自托管時，才需要填自己的 VPS API 地址和部署時生成的 Token，也可以掃描 Mac 菜單欄生成的 QR 自動填入。

項目與會話

手機端顯示 Mac 桌面端已有的項目、置頂項目和 thread，主要目標是延續桌面工作，不在手機上做過多管理操作。

消息與審批

可以發送補充需求、處理審批卡片、停止當前回合、查看文件變更、命令輸出、生成圖片和文件預覽。

安全解鎖

可在手機端設定中開啟 Face ID。開啟後，每次重新打開 App 時先解鎖，再查看連線設定和桌面會話。

Two Service Modes

自托管和托管的區別

客戶自托管 VPS

  • 客戶自己持有 VPS、域名和 Relay token。
  • 服務方提供部署包、安裝包和說明。
  • 適合有技術能力或公司內部環境的客戶。
  • 數據和連線基礎設施由客戶自己控制。

托管 Relay 暫未開放

  • 目前不接受購買或申請。
  • 收費方式、設備數和支持範圍仍在整理。
  • 後續開放時間和方案會在官網公布。
  • 沒有 VPS 的用戶可先加入 TestFlight 了解手機端體驗。

Daily Use

使用時只記住一件事：Mac 是主工作端

CodexMobile 不是在手機上另起一套 coding agent，而是把手機作為 Mac Codex Live 會話的延續入口。 Mac 必須在線、已登入 Codex，且本機服務和 Relay 可用。

安裝說明 VPS 部署