準備工作
先確認你的 Mac 與帳號
- Mac 機型與系統：點選「 → 關於這台 Mac」，記下年份、macOS 版本與記憶體。
- CLI 是否相容：Claude Code 目前支援 macOS 13+、4 GB+ 記憶體及 x64／ARM64；其他 CLI 與 Node.js 也需符合自己的版本需求。
- 帳號：準備所選 Agent 可使用的帳號方案。Happy 連接既有帳號，AI 用量與費用仍依供應商方案。
按 Command＋空白鍵，搜尋「終端機」，開啟後貼上指令並按 Enter。一次執行一個區塊，等畫面完成再繼續。
選一套就好
安裝 Agent 的 CLI 版本
先安裝 Codex CLI。第一次啟動時選擇 Sign in with ChatGPT，完成瀏覽器登入。
curl -fsSL https://chatgpt.com/codex/install.sh | sh安裝完成後，關閉終端機再重新開啟，輸入：
codex目前 Happy 的 agy 整合沒有逐項核准提示；預設使用沙盒，工具仍會直接執行。初次使用請保留預設權限，在測試資料夾操作。
這裡需要 CLI。只安裝一般聊天 App 或桌面介面，不一定已具備所需的終端機指令。切換選項只會改變本頁教學，不會在你的電腦安裝軟體。
讓 Agent 協助設定
安裝 Happy CLI
Happy CLI 需要 Node.js 20 以上。如果你不熟悉安裝環境，可以把下面這段話貼到已登入的 Codex 對話裡，請它檢查並協助設定。
我使用 Intel Mac mini，手機是 iPhone。請先檢查這台 Mac 的 macOS、處理器、Node.js 與 npm 版本，確認 Codex CLI 可用且已登入。請閱讀 https://github.com/slopus/happy/tree/main/packages/happy-cli 的最新說明，協助安裝 Happy CLI。需要我手動操作時，一次只教一個步驟，保留既有檔案；若需要密碼，請讓我在本機輸入。完成後協助手機配對、背景服務檢查及行動網路測試，並說明重開機後要如何恢復連線。
已經有 Node.js？展開手動安裝指令
先確認版本；Node.js 必須至少為 20，且所選 Node.js 版本需支援你的 macOS。
node --version
npm --versionnpm install -g happy如果顯示找不到指令或 EACCES 權限錯誤，把錯誤貼給 Agent 協助檢查。安裝套件名稱已由舊的 happy-coder 改為 happy。
第一次設定
用 iPhone 配對 Mac
- 在 iPhone 安裝並開啟 Happy: Codex & Claude Code App ↗，依畫面完成初次設定。
- 另外開啟 Mac 的終端機視窗，執行下方配對指令。
- 若出現方式選單，選擇手機方式（Mobile Authentication）。
- 用 Happy App 內的掃描功能掃描 QR code，在手機確認連接，等待 Mac 顯示成功。
happy auth loginHappy 配對與 Agent 登入是兩件事。配對成功後，所選 Agent 仍需在 Mac 完成自己的登入。App 目前要求 iOS 15.1 以上。
建立工作空間
從專用資料夾啟動對話
在 Mac 終端機逐行輸入，建立使用者資料夾下的 HappyWork，再啟動 Codex：
mkdir -p ~/HappyWork
cd ~/HappyWork
happy codex手機應能看到這個工作對話。之後以中文交代任務，並說清楚檔案位置、要做什麼，以及成果儲存位置。
檔案預設是在 Mac 的工作資料夾；手機看到完成訊息，不代表成果已自動同步到手機。需要隨身取用時，另指定你已設定好的雲端同步資料夾。
想改用另一套 Agent，就在已安裝並登入該 CLI 後，以對應的 happy codex、happy claude 或 happy agy 開啟新的工作對話。單獨執行 happy 預設使用 Claude。
確認 Mac 可被連接
啟動並檢查背景服務
背景服務（daemon）讓手機能建立和管理工作對話。Happy 通常會自動啟動它；你可以另外開一個終端機視窗檢查：
happy daemon start
happy daemon status初期先保留目前的工作視窗。Mac 重開機後，登入使用者，再執行 happy daemon start 並測試手機連線。無人看管的開機恢復需要另外設定和實測。
Happy 的 macOS 文件提醒，自動啟動方式可能影響登入憑證與鑰匙圈存取。先把手動恢復流程跑通，再處理自動化。背景服務說明 ↗
把日常使用準備好
設定電源、通知與工作檔案
Mac 持續醒著
在「系統設定」搜尋睡眠，開啟「避免在顯示器關閉時自動進入睡眠」。螢幕可關閉，主機需開機、連網；位置依 macOS 版本而異。
iPhone 開啟通知
允許 Happy 傳送通知，並測試完成或等待輸入時是否收到提醒；也留意專注模式的通知設定。
Mac 找得到檔案
Windows 的本機檔案不會自動出現在 Mac。使用 Google Drive 等同步服務時，先確認工作檔案已下載且可讀取。
先使用檔案副本
測試時保留原檔，另存新版本。先保留預設操作權限，核對提示後再允許所需操作。
驗證真的能外出使用
切到行動網路，完成一個小任務
- 讓 Mac 保持開機、連網，先保留工作視窗。
- 將 iPhone 的 Wi-Fi 關閉，改用行動網路。
- 在 Happy 的工作對話貼上下面這段指令；若出現核准要求，確認後再允許。
- 手機收到完成訊息後，在 Mac 確認檔案與內容。Mac 閒置約半小時後，再下第二次指令測試。
請在目前的 HappyWork 工作資料夾建立「手機連線測試.txt」，內容寫「我已經可以從 iPhone 下指令」。若已有同名檔案，請另存新檔。完成後告訴我完整儲存位置與檔案內容。
手機能下指令 → Agent 有回覆 → Mac 上有正確檔案 → 閒置後仍能接收下一個任務。
出門前用一分鐘確認
我的外出前檢查表
這是你自己的確認紀錄，勾選會保留在目前瀏覽器。本頁不會連到 Mac 檢查安裝或連線狀態。
完成實際測試後，再勾選對應項目。
先看現象，再處理
遇到問題怎麼辦
終端機顯示 command not found
先關閉並重新開啟終端機，再試一次。仍失敗時，把錯誤及你執行的指令貼給 Agent，請它確認安裝位置與指令搜尋路徑。若連 Agent 都啟動不了，回到該 CLI 的官方安裝說明。
npm 安裝出現 EACCES 或 permission denied
這通常是安裝目錄的寫入權限問題。把完整錯誤貼給已登入的 Agent，請它協助設定可用的 Node.js／npm 安裝環境，保留現有設定。密碼只在本機輸入。
手機看不到 Mac，或一直連接中
確認 Mac 醒著且能上網、Happy 配對完成，再執行 happy daemon status 檢查背景服務。若服務沒啟動，執行 happy daemon start。需要診斷時，執行下方指令。
happy doctor對外提供診斷結果前，先移除金鑰、Token、個人檔案內容等資訊。
Agent 做到一半停住
先看手機是否有等待核准或需要你回答的提示，再檢查 Mac 的網路與 Agent 登入、帳號用量。收到完成訊息後，仍以實際成果檔案確認任務是否完成。
重開機後連不上，或 Claude 顯示 401
先在 Mac 登入使用者並開啟終端機，確認 Agent 自己能正常登入使用，再啟動 Happy。若另設了自動啟動，請讓 Agent 依 Happy 最新 macOS 背景服務說明檢查鑰匙圈與登入環境。
常見問題
開始前可能會想問
Intel Mac mini 可以使用嗎？
Intel 本身不代表不能使用。先確認年份、macOS 和各 CLI 的系統需求；Claude Code 目前支援 macOS 13 以上與 x64 處理器。2018 Mac mini 的最新相容系統為 macOS Sequoia。實際安裝與登入仍需在你的 Mac 驗證。
Happy 可以直接遙控整個 Mac 桌面嗎？
Happy 的核心用途是傳送 Agent 指令、查看對話與處理支援的操作核准。需要看 Mac 桌面或點擊 Word 等視窗時，還需要相應的遠端桌面或操作工具。
重開機後可以立刻從手機連線嗎？
不能只因啟動過 daemon 就假設重開機後會自動恢復。初期請登入 Mac，重新執行 happy daemon start，再檢查狀態及測試手機連線。
Happy 免費代表 AI 不限量嗎？
本教學與檢查表免費。AI 使用仍依原有帳號方案或 API 計費；Happy App 也有部分內購功能。
資料都留在 Mac，完全不會上網嗎？
Happy 專案說明，手機與主機間的對話同步使用端對端加密。這與 AI 模型如何處理輸入是不同環節，不能據此視為完全離線；提供給 Agent 的內容仍需依所選 AI 服務的資料政策使用。
換成 Claude 或 Antigravity，要重新配對手機嗎？
同一台 Mac 的 Happy 配對通常可繼續使用；各 Agent 仍須分別安裝與登入。用對應指令建立新工作對話，本頁上方的選項只切換教學流程。
需要時回到原始說明
下載與參考來源
軟體與介面持續更新，指令或選單若有差異，請以以下來源與實際版本為準。這份教學的確認日為 2026 年 10 月 7 日。
Happy 為獨立第三方專案；本頁由奕鈞老師整理，非各產品官方教學。