q quicktuiv1 Get the App

Guide ยท Claude Code

How to run Claude Code from your iPhone

Claude Code runs in a terminal, and a terminal is exactly what your iPhone can reach when the session lives on your own server. This guide starts Claude Code inside a tmux session, drives it from the QuickTUI app, keeps it running while you are away, and runs several sessions side by side.

Claude Code running in a QuickTUI terminal session on iPhone
Driving a Claude Code session from the QuickTUI iPhone terminal.

The pattern is the same one that makes long-running terminal work reliable: keep the process on the server in tmux, and attach a view to it from wherever you are. QuickTUI is a native iPhone and iPad app (plus a browser client) that attaches to real tmux on a server you host, so Claude Code keeps thinking and editing whether or not your phone is looking at it.

Install the server

Run the installer on the machine where Claude Code should run: your workstation, a home server, or a cloud box. It sets up the QuickTUI service and can install tmux 3.2+ if needed.

macOS / Linux

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

Windows (PowerShell)

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

Pair the app by scanning quicktui-server --qrcode, or add the server manually by URL and token. The connection is direct by default, so your code and keys never touch our servers.

Start Claude Code in a session

On the server, open a named tmux session and launch Claude Code inside it:

tmux new-session -s claude
claude

From the app, attach to the claude session and you are at the live prompt. Type, review diffs, approve tool calls, and steer the agent exactly as you would in the terminal.

Keep it running and run several at once

How this compares. Anthropic offers a built-in way to control Claude Code remotely. QuickTUI's scope is different: it is a full terminal for any CLI agent (Claude Code, Codex, or anything else) running over real tmux on a server you self-host, with multiple sessions and no plan requirement. Pick whichever fits your setup.

FAQ

Does Claude Code keep running when I close the app?

Yes. Claude Code runs in tmux on your server, so it continues after you detach. QuickTUI's session keeper reattaches to the same live session when you reopen the app.

Can I run more than one Claude Code session?

Yes. Start each in its own tmux session with tmux new-session -s name, then switch between them in the app across iPhone, iPad, and the browser.

Does my code go through QuickTUI's servers?

No. The connection is direct by default, so your code and keys stay between your device and your own server.

Related