快速开始

在 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

服务器启动后会显示一个二维码。用 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 的流式响应，说明一切正常。