指南 · Claude Code
如何从 iPhone 运行 Claude Code
Claude Code 跑在终端里,而当会话活在你自己的电脑上时,终端正是 iPhone 能够触及的东西。本指南会在一个 tmux 会话里启动 Claude Code,从 QuickTUI 应用驱动它,在你离开时让它继续运行,还能并排跑好几个会话。

让长时间的终端工作变得可靠,靠的就是同一套办法:把进程留在电脑的 tmux 里,再从任何地方接一个视图上去。QuickTUI 是原生 iPhone 和 iPad 应用(另有浏览器客户端),接入你自己托管的电脑上真正的 tmux,所以无论你的手机是否正看着它,Claude Code 都在持续思考和编辑。
安装服务端
在你想运行 Claude Code 的机器上运行安装器:你的工作站、一台家用电脑,或是一台云主机。它会配置好 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
Windows 说明:会话后端是 qscn,不是 tmux。请在 App 里用 New Session 建会话;下文的 tmux new-session 示例适用于 macOS/Linux。
用下面的平台命令完成配对,或者用 URL 和 token 手动添加服务器。连接默认直连,所以你的代码和密钥绝不经过我们的服务器。
# macOS / Linux
quicktui-server --pair-qrcode
# Windows(PowerShell)
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" --pair-qrcode
在会话里启动 Claude Code
在电脑上,打开一个命名的 tmux 会话并在其中启动 Claude Code:
tmux new-session -s claude
claude
在应用里接入 claude 会话,你就来到了实时提示符前。像在终端里一样输入、审阅 diff、批准工具调用,精确地引导 Agent。
让它持续运行,并同时跑多个
- 让它继续干活。断开或关闭应用,Claude Code 仍在电脑的 tmux 里运行。稍后重新打开,会话保活会重新接回实时画面。
- 扛得住网络变化。从 Wi-Fi 切到 LTE 再到 5G、切到后台,或是连接中断,都不会打断这次运行。
- 多个会话。为另一个任务或仓库启动第二个会话(
tmux new-session -s review),并在应用里来回切换。
常见问题
关闭应用后 Claude Code 还会继续运行吗?
会。Claude Code 跑在你电脑的 tmux 里,所以在你断开后仍会继续。当你重新打开应用时,QuickTUI 的会话保活会重新接回同一个实时会话。
我能同时跑多个 Claude Code 会话吗?
能。用 tmux new-session -s name 各自启动在独立的 tmux 会话里,然后在 iPhone、iPad 和浏览器上的应用里来回切换。
我的代码会经过 QuickTUI 的服务器吗?
不会。连接默认直连,所以你的代码和密钥只在你的设备与你自己的电脑之间流转。