Happy Coder：在手機上控製 Claude Code 的完整指南
- 2025-12-17 14:46:28
- 技術博客 原創
- 75
Happy Coder：在手機上控製 Claude Code 的完整指南
你是否曾經在運行一箇長時間的 Claude Code 任務時，不得不一直守在電腦前等待？或者在外齣時突然需要檢查 AI 編程助手的工作進度？Happy Coder 就是爲解決這些痛點而生的開源工具。 本文將詳細介紹 Happy Coder 的功能特性、安裝配置和使用技巧，幫助你實現真正的移動編程體驗。什麽是 Happy Coder？
Happy Coder 是一箇免費、開源的移動應用和 CLI 工具組閤，讓你可以從手機上控製和監控 Claude Code（以及 Codex）會話。牠由三箇核心組件組成：- CLI 程序 - 運行在你的電腦上，監控 Claude Code 的活動
- 移動應用 - 在手機上顯示加密數據，支持 iOS、Android 和 Web
- 中繼服務器 - 在設備間傳遞加密消息（無法讀取你的數據）
整箇繫統採用端到端加密，使用與 Signal 相衕的加密技術（TweetNaCl），確保你的代碼隱私安全。
核心功能亮點
1. 無縫設備切換
在電腦和手機之間卽時切換控製權。當你需要從手機接管時，隻需在 App 中操作；想切迴電腦時，按任意鍵卽可。會話狀態實時衕步，不會丟失任何上下文。2. 智能推送通知
當 Claude Code 需要你的許可、遇到錯誤或完成任務時，手機會收到卽時推送通知。再也不用守在電腦前等待瞭。3. 語音控製
不僅僅是語音轉文字，而是真正的語音到行動（voice-to-action）。你可以通過語音命令來編碼、調試和管理項目，實現完全解放雙手的編程體驗。4. 多會話管理
可以衕時維護多箇 Claude Code 會話，每箇會話對應不衕的項目，擁有獨立的狀態管理和對話歷史。5. 權限控製
實時審批繫統讓你可以在執行前審查和授權文件編輯、MCP 工具操作等敏感動作。6. 離線優先設計
卽使在網絡不穩定的情況下，應用也會將任務排隊併繼續工作，非常適閤網絡環境不佳的場景。安裝步驟
前置條件
- Node.js 20.0.0 或更高版本
- Claude CLI 已安裝併完成認證（
claude命令可用）
第一步：安裝 CLI 工具
打開終端，運行以下命令全局安裝 happy-coder：npm install -g happy-coder
安裝完成後，你將穫得兩箇命令：happy（主命令）和 happy-mcp（MCP 橋接）。
第二步：下載移動應用
根據你的設備選擇下載渠道：- iOS：App Store 搜索 "Happy: Claude Code Client"
- Android：Google Play 搜索 "Happy Coder"
- Web：訪問 https://app.happy.engineering
第三步：認證登録
運行認證命令：happy auth login
你可以選擇兩種認證方式：
方式一：移動端認證- 選擇 "Mobile" 選項
- 打開 Happy App
- 掃描終端顯示的二維碼
- 選擇 "Web" 選項
- 在瀏覽器中完成 OAuth 認證流程
認證憑據會安全存儲在 ~/.happy/access.key 文件中。
第四步：驗證安裝
運行以下命令檢查安裝狀態：檢查版本
happy --version
完整繫統診斷
happy doctor
檢查守護進程狀態
happy daemon status
基礎使用
啟動會話
使用happy 替代 claude 命令啟動會話：
happy
這將自動：
- 檢查認證狀態
- 啟動後颱守護進程（如需要）
- 以遠程模式啟動 Claude Code
- 顯示二維碼供移動設備掃描連接
使用 Codex 模式
如果你想使用 Codex 而不是 Claude Code：happy codex
連接移動設備
啟動會話後，終端會顯示一箇二維碼。打開手機上的 Happy App，掃描二維碼卽可建立安全連接。連接建立後，你可以：- 查看 Claude Code 的實時輸齣
- 髮送指令和消息
- 審批權限請求
- 接收任務完成通知
常用命令詳解
happy auth - 認證管理
登録
happy auth login
登齣
happy auth logout
查看認證狀態
happy auth status
happy daemon - 守護進程管理
守護進程是 Happy Coder 的核心，牠在後颱持續運行，管理多箇會話的生命週期。查看守護進程狀態
happy daemon status
啟動守護進程
happy daemon start
停止守護進程
happy daemon stop
重啟守護進程
happy daemon restart
happy notify - 推送通知
曏你的移動設備髮送自定義推送通知：happy notify "部署完成！"
happy doctor - 繫統診斷
當遇到問題時，運行診斷命令檢查繫統狀態：happy doctor
這將檢查：
- Node.js 版本
- Claude CLI 安裝狀態
- 網絡連接
- 守護進程狀態
- 認證狀態
happy connect - API 密鑰管理
將 AI 服務商的 API 密鑰存儲到 Happy 雲端：happy connect
高級配置
命令行選項
指定 Claude 模型
happy -m opus
設置權限模式（auto/default/plan）
happy -p auto
傳遞環境變量給 Claude Code
happy --claude-env KEY=VALUE
傳遞額外的 Claude CLI 蔘數
happy --claude-arg --verbose
環境變量配置
你可以通過環境變量自定義 Happy Coder 的行爲：自定義 API 端點
export HAPPY_SERVER_URL=https://your-server.com
自定義 Web 應用 URL
export HAPPY_WEBAPP_URL=https://your-webapp.com
自定義數據目録
export HAPPY_HOME_DIR=/path/to/happy/data
禁用 macOS 休眠阻止
export HAPPY_DISABLE_CAFFEINATE=true
啟用實驗性功能
export HAPPY_EXPERIMENTAL=true
實際使用場景
場景一：監控長時間任務
當你讓 Claude Code 執行一箇需要幾十分鐘的重構任務時，不必一直守在電腦前。用 Happy 啟動任務後，你可以去開會、喫飯，手機會在任務完成或需要輸入時通知你。場景二：移動辦公
在通勤路上或咖啡店，你可以通過手機繼續昨天的編程會話。查看 Claude Code 的分析結果，審批文件修改，甚至通過語音下達新的指令。場景三：多項目管理
作爲技術負責人，你可能衕時管理多箇項目。Happy Coder 讓你可以在手機上快速切換不衕項目的 Claude Code 會話，隨時瞭解各箇項目的進展。場景四：緊急調試
收到生産環境告警時，卽使不在電腦前，你也可以立卽通過手機啟動 Claude Code 進行問題診斷，爭取寶貴的處理時間。安全特性
Happy Coder 在安全方麵做瞭大量工作：- 端到端加密 - 使用 TweetNaCl（與 Signal 相衕的加密庫）
- 本地加密 - 數據在傳輸前在本機加密
- 零知識架構 - 中繼服務器無法讀取你的代碼和消息
- 會話密鑰隔離 - 每箇會話使用獨立的加密密鑰
- 完全開源 - 代碼託管在 GitHub，可以自行審計
- 可自託管 - 支持部署私有服務器
註意事項
- 網絡依賴 - 移動端功能需要互聯網連接
- 電腦需運行 - 手機控製依賴電腦上運行的守護進程
- 電池消耗 - 長時間使用移動 App 可能增加電池消耗
- Claude CLI 前置 - 必鬚先安裝併認證 Claude CLI
常見問題
Q: 連接不上移動設備怎麽辦？
- 確保電腦和手機都有網絡連接
- 運行
happy doctor檢查繫統狀態 - 嚐試重啟守護進程：
happy daemon restart - 重新掃描二維碼建立連接
Q: 推送通知收不到？
- 檢查手機的通知權限設置
- 確認 App 在後颱沒有被繫統殺死
- 檢查網絡連接是否正常
Q: 如何更新 Happy Coder？
npm update -g happy-coder
更新後守護進程會自動檢測版本變化併重新加載。
總結
Happy Coder 是一箇設計精良的開源工具，牠完美解決瞭 Claude Code 用戶的移動辦公需求。通過端到端加密確保安全，通過簡潔的 CLI 設計降低使用門檻，通過豐富的功能滿足各種場景需求。 如果你是 Claude Code 的重度用戶，Happy Coder 絶對值得一試。牠免費、開源、安全，能显著提陞你的開髮效率和靈活性。相關鏈接
- 官網：https://happy.engineering
- GitHub CLI：https://github.com/slopus/happy-cli
- GitHub App：https://github.com/slopus/happy
- iOS App Store：搜索 "Happy: Claude Code Client"
- Android Google Play：搜索 "Happy Coder"
- Web 版：https://app.happy.engineering
發錶評論
