用開源應用程式，把 Codex 帶上手機

Codex 是 Happier 預設以 App Server 模式啟動的代理程式，而有用的後果是它會拒絕：如果新的工作階段無法使用該模式，啟動就直接失敗，而不是安靜地退回較弱的東西；因此 ACP 或 MCP 是你刻意做的選擇，而不是在背後發生、讓工作階段的行為和上一個不同的備援。

那個選擇牽涉到什麼，是寫下來的，不是憑感覺。在預設執行環境上，Codex 對話可以分支、回溯到較早的位置，也可以去問用量上限解除了沒有；改選 MCP 或 ACP 執行環境，這個版本就會把這三項都拿掉，而這正是安靜降級會是錯誤好意的原因。Codex 也保留了可以交還給你的廠商 TUI——happier attach 會讓你在已經在跑的工作階段上看到真正的 Codex 介面；當那個終端機握著它時，你從應用程式送出的任何內容都會在佇列裡等待，而不是跑到你的游標底下。

它也是二個能在工作階段中途更換帳號的代理程式之一。Codex 訂閱或 OpenAI 金鑰只要連過就好，之後工作階段若在其中撞到上限，就能被帶到同群組的其他設定檔上，而不是被放棄——每回合最多一次，每個工作階段小時最多三次，所以這是救援而不是輪替。登入本身仍然是廠商的流程：供應商頁面會在你選的電腦上執行 codex login，它寫下的憑證就留在那裡。

Codex CLI 是 OpenAI 的終端機程式設計代理程式，以發行版執行檔的形式從 openai/codex 儲存庫提供。happier codex 會在你指定的儲存庫裡啟動那個執行檔——相同的核准提示、相同的工作目錄、相同的帳號，與你自己執行它時並無不同。

改變的是你可以從哪裡讀它。對話紀錄、檔案差異和核准要求會出現在手機上的 Happier 應用程式、瀏覽器分頁或桌面應用程式裡，離開你的電腦之前就已經端對端加密。

iOS 和 Android 應用程式、macOS、Windows 和 Linux 的桌面應用程式，以及 app.happier.dev，全都是連向你電腦上執行中的 Codex CLI 行程的用戶端 — 不是唯讀的鏡像。回應權限請求、送出下一則指示、瀏覽儲存庫、閱讀差異。對話紀錄在離開你的電腦前就已端對端加密，所以承載它的伺服器持有的是密文。

Happier 安裝在已經放著你儲存庫的那台電腦上，而 happier codex 會在那裡以一般子行程的方式啟動 Codex CLI，在你指定的目錄裡，並以你當初登入的方式登入。代理程式和 OpenAI 之間沒有閘道，你的原始碼在其他任何地方也沒有副本。

Happier 會先在你的 PATH 上找 codex，執行你裝的那份。如果沒有，它可以把 openai/codex 的發行版執行檔下載到 ~/.happier/tools/providers/codex/ 並留在那裡。你自己的安裝永遠優先。

OpenAI 自己介紹 Codex CLI 的頁面在 github.com/openai/codex。Happier 不會鏡像一份，因為把別人的安裝說明抄一份過來，抄的就是一份會過期的東西。

Happier 這一側的設定參考 — Happier 文件中的 Codex CLI。

Codex CLI 是 Happier 可以指向「你連結過一次的憑證」的代理程式之一，而不是指向那台電腦當下登入的帳號。它接受 a Codex subscription or an OpenAI API key。

已連結服務是以憑證為鍵，而不是以代理程式為鍵，所以同一份 Codex subscription 在每一台你連結過的電腦上，都能給任何接受它的代理程式選用 — 這也正是把你自己的帳號組成一個池、跨多台電腦使用會有幫助的原因。憑證的加密與解密都在你自己的裝置上進行；文件頁面 記載各種設定檔的規則，因為每個代理程式接受哪些種類的設定檔，正是會隨版本變動的那類細節。

Codex CLI 是 Happier 執行的 13 個命令列程式設計代理程式之一，它們共用同一份工作階段清單、同一個權限收件匣、同一套鍵盤快速鍵和同一份 MCP 設定。

You define an MCP server once and Codex CLI receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

這在你同時跑不只一個的日子最重要：不同供應商的工作階段並排在一起，而點一下通知會開啟提出該請求的工作階段，而不是應用程式的大門。完整清單在這裡。

在終端機輸入 happier codex 就會在你所在的地方啟動工作階段，而同一個工作階段同時也在應用程式裡。你在那個 shell 裡讀到的是 Happier 自己對該工作階段的顯示 — 對話紀錄、權限提示、工具輸出 — 而不是 Codex CLI 的介面。沒有人得放棄終端機才能得到一個手機用戶端。

當你想用 Codex CLI 自己的 TUI 時，在擁有該工作階段的電腦上執行 happier attach <session-id>，就會在 tmux 裡把它交給你，而且歷史紀錄已經在那裡了。在預設執行環境下這種交接是獨占的：只要終端機握著工作階段，你從應用程式送出的訊息會排在佇列裡等，而不是在你眼皮底下被打進去；等你把控制權交回來，它才會送出去。

attach 指南列出了各種情況，而不是承諾全部都行。

在放著你程式碼的電腦上執行一道指令，然後在你想工作的儲存庫裡執行 happier codex。

逐步說明在指南裡。全部都採 MIT 授權，而中繼站是你可以自己執行的。