Happy CLI 刪除後無法重新配對？完整解決教學（2026）

最近在 Threads 上，我偶然發現了一個非常有趣的 GitHub 專案。這個工具的核心功能在於實現手機行動端與遠端本機（Local Machine）上的 Claude Code 之間的無縫連線。對於時常需要隨時隨地處理程式碼需求、或是想在沙發上也能享受行動編碼便利性的開發者來說，這無疑是一個極具吸引力的解決方案。

為了驗證其實際效能與穩定性，我決定親自下場測試。沒想到過程中遇到了一個讓我研究了許久的問題：刪除後完全無法重新配對。這篇文章記錄完整的問題過程與最終解法。

發現問題：無法重置的配對機制

在初步完成關聯後，我注意到介面預設提示為簡體中文。基於好奇心以及對開發者背景的猜測，我動了「剁掉重練」的念頭，想測試看看如果完全清除連線資訊，系統是否能乾淨地重新開始，以及資料是否會遺留。

我嘗試了最直觀的方法：

• 關閉並刪除電腦端的終端機連線進度
• 解除安裝手機上的對應 App

然而，當我試圖重新進行配對時，困難出現了。正常流程中，安裝後需要描繪 QR Code 並在終端機輸入 happy 指令來觸發認證與連線。但在我的測試環境中，無論如何重新嘗試，系統都會跳過認證步驟，直接進入與 Claude Code 的關聯介面，完全不提示新的認證碼。

嘗試過的無效方案

為了找回消失的 QR Code 認證流程，我查閱了 GitHub 上的文件。文件中雖然提到了一些指令：

• happy --auth
• happy

但我反覆輸入這些指令，甚至嘗試了 npm install -g 全域安裝、在特定資料夾進行局部安裝、甚至徹底移除套件後重新安裝，結果都令人沮喪：只要一點擊連線，系統就會偵測到先前的設定並直接開啟 Claude Code。

Happy CLI 無法配對的根本原因：清除隱藏的設定檔

在翻閱了更多技術討論並詢問 AI 輔助分析後，我終於找到了問題的根源。

原來，該工具在第一次配對成功時，會在電腦的家目錄（Home Directory）中自動生成一個隱藏的連線設定檔。這個檔案記錄了之前的配對資訊，且因為它是隱藏檔（通常以 . 開頭），一般的刪除操作或解除安裝指令並不會影響到它。只要這個設定檔存在，系統就會預設你已經完成認證，從而跳過重新配對的步驟。

完整操作步驟

確認根本原因後，解法其實非常簡單。以下是完整的重置步驟：

1. 終端機快速刪除（推薦）：執行 rm -rf ~/.happy，一行指令搞定
2. Finder 手動刪除：開啟 Finder → 選單列點「前往」→ 輸入 ~/.happy → 將資料夾移至垃圾桶
3. 確認已刪除：在終端機執行 ls ~/.happy，若顯示「No such file or directory」代表刪除成功
4. 重新安裝 App：在手機上重新安裝 Happy CLI App
5. 重新執行配對：在終端機輸入 happy，這次應該會正常顯示 QR Code 認證流程

重點整理

這次的測試經驗提醒我們，在玩轉各類開源工具時，除了表面的 App 和套件，隱藏在系統底層的設定檔往往才是程式碼運作的關鍵所在。

項目	說明
問題根因	首次配對時自動生成的 ~/.happy 隱藏設定檔未被清除
無效方案	重新安裝 App、npm 全域/局部重裝、happy --auth 指令
正確解法	手動刪除 ~/.happy 資料夾
適用平台	macOS、Linux（相同步驟）
刪除指令	rm -rf ~/.happy

延伸閱讀：如果你正在深入使用 Claude Code，推薦參考這篇基礎概念解析：Claude Code 完整教學：Command、Skills、Agent 是什麼？怎麼用？

FAQ 常見問題

Q：為什麼刪除 App 後無法重新配對？

Happy CLI 會在家目錄下建立 ~/.happy 隱藏設定檔，記錄配對資訊。即使刪除 App 或重新安裝套件，這個設定檔仍然存在，系統會自動跳過認證流程。

Q：如何完全移除 Happy CLI 的所有設定？

在終端機執行 rm -rf ~/.happy 即可完整清除所有配對設定。或在 macOS Finder 使用「前往」功能輸入 ~/.happy 手動刪除。

Q：刪除 ~/.happy 後會影響其他資料嗎？

不會。這個資料夾只包含 Happy CLI 的配對資訊，刪除它不會影響其他檔案或 Claude Code 的使用。

Q：Linux 使用者也有相同問題嗎？

是的，解決方法相同，都是刪除 ~/.happy 隱藏資料夾，指令也一樣：rm -rf ~/.happy。

Q：Windows 使用者也有相同問題嗎？

Happy CLI 主要支援 macOS 和 Linux。Windows 使用者若透過 WSL2 使用，解法相同；原生 Windows 環境路徑可能不同，建議參考官方 GitHub 文件。

Q：Happy CLI 可以免費使用嗎？

Happy CLI 是免費開源的 GitHub 專案，你可以在 GitHub 倉庫找到原始碼和更多技術細節。

---

參考來源

• Happy CLI GitHub 倉庫
• Happy CLI 官方文件