快速开始

在 Mac 和 iPhone 上安装 Tactic Remote，完成首次连接并运行第一个会话。

Windows: 透過帳號連接 Windows.

本指南将帮助你完成 Tactic Remote 的安装和首次连接。你需要一台 Mac（或 Windows PC）和一部 iPhone。

耗时： 首次设置约 10 分钟。之后重连只需几秒。

前置条件

Tactic Remote Mac App —— 內建本地伺服器與固定版本的 Node runtime。首次啟動時會檢查本機相依項，並可協助安裝 Homebrew、tmux 等基礎元件。
至少一個 AI 編程 agent CLI —— Tactic Remote 可以啟動 Claude Code、OpenAI Codex 或 Sourcegraph Amp。首次建立工作階段前，請先安裝並登入你想使用的 agent。
# Claude Code（官方文件目前建議 native installer） curl -fsSL https://claude.ai/install.sh | bash # OpenAI Codex npm install -g @openai/codex # Sourcegraph Amp npm install -g @sourcegraph/amp
如果你已經能在終端機正常執行 claude、codex 或 amp，Tactic Remote 就可以呼叫它。
tmux —— 讓 Mac/Linux 終端機工作階段在斷線後繼續存活。Mac App 會檢查並可協助安裝；CLI 使用者可在 macOS 上執行 brew install tmux。

如果你使用的是終端機一行命令啟動方式，而不是 Mac App，且尚未安裝 Node.js 或 Homebrew：

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

Tactic Remote 在 Mac 上支援兩種安裝路徑：

從下載頁面取得 Tactic Remote Mac App。開啟 DMG 並將應用程式拖入 Applications。

首次啟動後，應用程式出現在 選單列。點擊圖示可以看到：

Mac App 內建了伺服器，整個流程更直觀，也更適合不常使用終端機的使用者。

在終端機中執行這條指令：

npx tacticremote

伺服器啟動後會顯示一個 QR Code。用 iPhone 掃描即可連線，就這麼簡單。

需求：Node.js 16+、tmux（macOS 上執行 brew install tmux），以及至少一個已安裝的 agent CLI（claude、codex 或 amp）。

適用於 macOS 和 Linux。

該選哪種方式？ 偏好圖形介面的使用者可以選擇 Mac App。偏好 Terminal 的使用者可以選擇 CLI 一鍵啟動方式，也可以在 macOS 和 Linux 上保持一致流程。

Bonjour 自動發現： 如果兩台裝置在同一 WiFi，iOS App 也可以透過 Bonjour 自動發現你的 Mac——在伺服器列表中查找。

List the files in the current directory.

如果你在手機上看到 agent 的串流回應，代表一切正常。