q quicktuiv1 获取应用

指南 · tmux

如何从手机接入 tmux 会话

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

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

安装服务端

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

macOS / Linux

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

Windows (PowerShell)

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

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

配对应用

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

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

# macOS / Linux
quicktui-server --pair-qrcode

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

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

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

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

在 iPhone 或 iPad 上打开 QuickTUI 应用，扫描二维码，服务器就添加好了。如果你更喜欢手动输入信息，也可以用 URL 和 token 添加（浏览器客户端登录仍使用 access token）。

打开、接入与重新接回

要和 Agent 打交道？在 tmux 会话里启动 Claude Code、Codex 或任意 CLI 工具，然后从手机上盯着它。参见从 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 或隧道，或经由公网地址访问它。

相关内容