01 / 运行 Agent 的电脑
安装 CLI，启动 Host
在 Mac 或 Linux 上运行。安装后，按下方连接指南生成配对码。
npm install -g agent-termbridgeHost 推荐 macOS / Linux；Windows 请使用 WSL2。
TERMBRIDGE / 远程 Agent 终端
把电脑上的 Agent，
带到手边。
用手机或另一台 Mac，接着操作 Codex、Claude Code 和终端。
电脑继续运行，你随时接入。
Android · macOS · CLI
下载与安装
先连接电脑，再选择客户端。
02 / 用来连接的设备
下载你需要的 App
Android
手机端 · Android 7.0 及以上扫码连接，查看 Agent 状态，操作终端，或通过 Global 文字与语音交互。
下载 Android APK v0.1.24
68.4 MB · APK
68.4 MB · APK
macOS
电脑端 · macOS 13+ · Apple Silicon内置交互终端、多连接源标签和连接设置。直接输入，随时切换到另一台 Mac。
下载 Mac App v0.3.0
1.1 MB · ZIP
1.1 MB · ZIP
尚未经过 Apple 公证。查看安装说明 ↗
iPhone / iPad客户端开发中，暂无公开 IPA、TestFlight 或 App Store 下载。
安装包 SHA-256 校验 ↗MAC APP
每一台电脑，
都有自己的连接。
在设置中添加配对码，再通过 Host 标签切换。终端和连接设置都在 App 里。
FIRST CONNECTION
三步，把终端
带到手边。
以 Mac + Android 为例。
配对一次，下次直接连接。
- 01
在电脑上安装 CLI
准备好 Node.js，打开 Terminal 执行：
npm install -g agent-termbridge - 02
生成配对码，启动 Host
电脑通过官方中继连接。将显示的配对码按密码保管。
tb cloudflare pair
tb host enable - 03
在手机上扫码，选择会话
安装 Android App，在连接设置中选择「Scan pairing QR」。Mac App 可以在设置中粘贴同一配对码。重复配对其他电脑，就能通过标签切换。
GOOD TO KNOW
连接之前，
你可能想知道。
电脑和手机需要在同一 Wi-Fi 下吗？+
使用官方 TermBridge Cloud 中继时不需要。电脑与手机客户端分别建立 WSS 出站连接；电脑需要保持开机、联网且 Host 正在运行。你也可以自行部署 Relay。
终端内容会经过中继吗？+
会。WSS 加密传输链路，但目前不是端到端加密，终端内容会在中继中解密和转发。配对码包含连接密钥，请不要公开分享。需要自己管理中继时，可以使用 CLI 的自建 Relay 配置。
如何安装 Mac 预览版？+
下载并解压 ZIP，将 TermBridge Control Center 拖到「应用程序」。当前包适用于 Apple Silicon，采用临时签名，尚未经过 Apple 公证。若系统阻止打开，请先确认下载来源和校验值，再按系统「隐私与安全性」中的提示操作。
打开后点击齿轮或按 ⌘, 进入连接设置，粘贴配对码。运行 Agent 的电脑仍需启动 CLI Host。远程直接接入 Herdr 需要 Host 0.1.24 或更新版本。
Android 是正式商店版吗？+
目前提供可直接安装的 Debug 签名测试 APK，适合体验和反馈。按 Android 的提示允许浏览器安装此应用；如果已有不同签名的版本，不要直接卸载，以免丢失数据。
关闭客户端，会结束 Agent 吗？+
断开终端连接不会销毁已有 Herdr 会话。CLI 终端连接中，Ctrl+C 发给远端任务；Ctrl+] 打开断开提示，再按 D 退出当前连接。Host 服务与终端客户端分别管理。