一条命令即可连接：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。