一條指令即可連線：npx tacticremote

我們已將 Tactic Remote 伺服器發布為 npm 套件。現在只需一條指令即可啟動服務：

npx tacticremote

無需全域安裝，無需設定檔，無需 Homebrew tap。在終端機執行該指令，以 Tactic Remote iOS 應用程式掃描 QR 碼，即可完成連線。

為什麼選擇 npx？

過去，要將 iPhone 連線至 Claude Code，需要下載 Mac 選單列應用程式或透過 Homebrew 安裝。兩種方式都很好用，但都需要額外步驟——尤其是在新機器、Linux 伺服器或無法執行圖形介面的遠端 VM 上。

使用 npx tacticremote，伺服器可以在任何安裝了 Node.js 的環境中執行：

• Mac、Linux 或任何裝有 Node.js 的機器 — 無需特定平台的安裝程式。
• 遠端 VM 和雲端執行個體 — SSH 登入後執行指令，用手機掃描 QR 碼即可接入。
• 新機器零設定 — npx 隨用隨下載，用完自動清除。

運作原理

執行 npx tacticremote 後，伺服器會：

1. 在 8765 埠啟動一個 WebSocket 服務。
2. 偵測本機 IP 位址並在終端機輸出 QR 碼。
3. 等待 Tactic Remote iOS 應用程式發起連線。

連線成功後，你可以從 iPhone 完整存取 Claude Code 工作階段——傳送提示、核准工具呼叫、瀏覽檔案，並接收推播通知。

指令選項

CLI 支援與 Mac 應用程式相同的選項：

npx tacticremote [options]

  -p, --port <n>      監聽埠號                   (預設: 8765)
  --path <dir>        允許存取的根目錄            (預設: $HOME)
  --api-key <key>     設定身份驗證金鑰
  --tunnel            啟用 Cloudflare 通道以支援遠端存取
  --no-qr             不顯示 QR 碼
  -h, --help          顯示說明資訊

如需在區域網路之外進行遠端存取，加上 --tunnel 參數可自動建立 Cloudflare 通道——無需帳號，無需任何設定。

仍然偏好 Homebrew 或 Mac 應用程式？

現有使用者無需做任何變動。Mac 選單列應用程式和 Homebrew tap（brew install TacticSpaceTech/tap/tacticremote）仍完整支援。npx 只是為想立即上手或在非 Mac 平台工作的使用者提供了一條更便捷的途徑。

從 App Store 下載 iOS 應用程式，馬上試試看——伺服器端只需一條 npx tacticremote。