指南 · tmux

如何从手机接入 tmux 会话

tmux 让你的终端会话在断开连接后仍在电脑上运行：长时间的构建、Agent、日志跟踪和 shell 都能保持存活。本指南带你走一遍用 QuickTUI 从 iPhone 或 iPad 接入这些会话、在掉线后重新接回，以及在需要时新建会话的完整流程。

tmux 持久化背后的想法很简单：会话活在机器上，而不在客户端。你把一个视图接上去，再断开，工作照常进行。QuickTUI 是原生应用（另有浏览器客户端），接入你自己电脑上真正的 tmux，所以你在手机上打开的会话，就是你在办公桌终端里离开的那一个。

安装服务端

在运行会话的机器上运行安装器。它会配置好 QuickTUI 服务。macOS/Linux 需自行安装 tmux 3.2+（安装器不代装 tmux）；Windows 会自动安装 qscn 会话后端。

curl -fsSL https://quicktui.ai/q.sh | sh

irm https://quicktui.ai/q.ps1 | iex

连接默认直连，所以你的代码和密钥绝不经过我们的服务器。单台电脑免费且功能完整；QuickTUI Pro 为一次性买断，解锁无限电脑配置。

配对应用

在电脑上生成配对码，扫一次即可：

Windows 说明：会话后端是 qscn，不是 tmux。请在 App 里用 New Session 建会话；下文的 tmux new-session 示例适用于 macOS/Linux。

# macOS / Linux
quicktui-server pairing qrcode

# Windows（PowerShell）
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing qrcode

桌面环境下也可在浏览器中打开二维码：

# macOS / Linux
quicktui-server pairing qrcode --browser

# Windows（PowerShell）
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing qrcode --browser

在 iPhone 或 iPad 上打开 QuickTUI 应用，扫描短期有效的二维码。客户端会固定 server identity 并注册自己的设备密钥，不需要输入 root token。

打开、接入与重新接回

• 接入正在运行的会话。QuickTUI 会列出电脑上的 tmux 会话；点一个，你就直接进入实时画面，回滚缓冲完好无损。
• 掉线后重新接回。从 Wi-Fi 切到 LTE 或 5G、把应用切到后台，或是失去信号，都不会结束会话。会话保活为你守住位置，重新打开应用就回到原处。
• 新建会话。在 macOS/Linux 上于电脑运行 tmux new-session -s work，或在应用里打开 shell 启动；Windows 请在应用里用 New Session（qscn 后端）。命名后的会话随即出现在列表里，可从任意设备接入。
• 按名字接入。命名会话在手机上最好找。如果你用 tmux new-session -s claude 启动了 Agent，它就是列表里的 claude 项，和你在电脑前用 tmux attach -t claude 打开的是同一个会话。参见从 iPhone 运行 Claude Code。

常见问题

如果我的手机掉线，会话还在吗？

在。tmux 让会话在电脑上持续运行，QuickTUI 的会话保活会在网络切换、连接中断或应用重启后重新接回，所以你能从离开的地方续上。

我要怎么新建一个 tmux 会话？

macOS/Linux 上在电脑或应用 shell 运行 tmux new-session -s name；Windows 请在应用里用 New Session（qscn）。命名后的会话会出现在 QuickTUI 的列表里，可从 iPhone、iPad 或浏览器接入。

我需要 SSH 吗？

不需要。QuickTUI 通过 HTTP/WebSocket 与它自己的轻量服务端通信。你可以在局域网内、通过 Tailscale 或 Cloudflare Tunnel 这样的 VPN 或隧道，或经由公网地址访问它。