快速入門

Luwu 讓你從手機或瀏覽器使用自己電腦上的終端機。在每台想連線的電腦上安裝 Luwu，然後從 iPhone app 或 app.luwu.dev 開啟那台電腦。

1. 在電腦上安裝

在 Mac 或 Linux 電腦上（Windows 請在 WSL 中執行）：

curl -fsSL https://luwu.dev/install.sh | sh

安裝程式會下載適合你系統的 luwu 執行檔，檢查 SHA-256，然後放到 ~/.luwu/bin。它也會在 ~/.local/bin 建立 luwu 的連結，並在 shell 的啟動檔（~/.zshrc、~/.bashrc…）加入一行有標記的設定，把 ~/.local/bin 加進 PATH。完成後請開啟新的終端機。如果要跳過這個步驟，請設定 LUWU_NO_MODIFY_PATH=1。

Luwu 的終端機就是 tmux 工作階段，所以安裝指令碼在沒有 tmux 時會一併安裝（Mac 上用 Homebrew，Linux 上用系統的套件管理器）。想自己安裝的話：Mac 上執行 brew install tmux，Debian 或 Ubuntu 上執行 sudo apt install tmux。

2. 登入

luwu

第一次執行時，Luwu 會詢問你的 email，並寄送 6 位數驗證碼。輸入新的 email 會建立新帳號。接著 Luwu 會讓這台電腦可被連線，並啟動一個背景服務；關閉終端機後服務仍會繼續執行。按 q 離開儀表板，服務會保持執行。

如果是透過 SSH 連線的 Linux 伺服器，請執行一次以下指令，讓服務在你登出後也能繼續執行：

loginctl enable-linger

3. 在 tmux 中啟動代理

tmux new -s work
claude

在 tmux 中執行的任何程式都可以連線使用：Claude Code、Codex、Gemini CLI、建置工作或 shell。

4. 在手機或瀏覽器中開啟

iPhone：安裝 Luwu（測試期間透過 TestFlight 安裝），並用同一個帳號登入。點你的電腦，再點一個視窗。
瀏覽器：前往 app.luwu.dev，用 email 或 Google 登入。選擇電腦、工作階段和視窗；你也可以在那裡建立新的工作階段。

手機或瀏覽器第一次連到某台電腦時，電腦會等你核准。可以在已經有權限的裝置上核准，也可以在電腦上核准：luwu devices 列出正在等待的裝置，luwu devices approve 名稱 讓它進來。這樣一來，只拿到你帳號密碼的人進不了你的電腦。

5. 代理需要你時收到通知

luwu hooks install

之後 Claude Code 和 Codex 完成工作或等待你回應時，會通知你的手機。當 Claude 提出有選項的問題或要求權限時，你可以直接在通知中回覆。已經在執行的代理需要重新啟動。

限制

免費版包含 1 台電腦、每台電腦 2 個透過 Luwu 建立的終端機工作階段，以及 2 支手機或瀏覽器。每個工作階段的視窗數量不限，你自己在電腦上開的工作階段不算。各方案會增加電腦、工作階段、桌面和檔案。