q quicktuiv1 获取应用

指南 · Codex CLI

如何从手机运行 Codex CLI

OpenAI 的 Codex CLI 是一个终端 Agent，所以从手机运行它，归根结底就是接上它所在的终端。本指南会在你自己电脑上的 tmux 会话里启动 Codex CLI，从 QuickTUI 应用驱动它，并在你断开连接后让会话保持存活。

Codex CLI 会在你的文件上实打实地干活，耗时以分钟计而非几秒，所以你希望它待在一台不会走开的机器上。把它留在电脑的 tmux 里，再从手机接一个视图上去。QuickTUI 是原生 iPhone 和 iPad 应用（另有浏览器客户端），接入你自己托管的电脑上真正的 tmux：同一个 Codex 会话，从任何地方都能触及。

安装服务端

在你想运行 Codex CLI 的机器上运行安装器。它会配置好 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 手动添加服务器。连接默认直连，所以你的代码和密钥绝不经过我们的服务器。单台电脑免费且功能完整；QuickTUI Pro 为一次性买断，可用于无限电脑配置。

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

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

在会话里启动 Codex CLI

在电脑上，打开一个命名的 tmux 会话并在其中启动 Codex：

tmux new-session -s codex
codex

在应用里接入 codex 会话，你就来到了实时提示符前。像在本地一样下达指令、读取输出、批准或引导 Agent。

让会话保持存活

任意 Agent，同一个终端。QuickTUI 驱动的是真正的 tmux，所以它不绑定单一工具：在会话里运行 Codex、Claude Code 或任意 CLI，然后从手机上统一盯着它们。参见从手机操控 AI Agent。

常见问题

我离开后 Codex CLI 还会继续运行吗？

会。Codex 跑在你电脑的 tmux 里，所以在你断开后仍会继续。当你重新打开应用时，QuickTUI 的会话保活会重新接回同一个实时会话。

我能同时跑 Codex 和 Claude Code 吗？

能。各自启动在独立的 tmux 会话里，然后在应用里来回切换。QuickTUI 是面向任意 CLI Agent 的完整终端，而非单一工具的客户端。

我需要 SSH 吗？

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

相关内容