← All posts

Guide ·

How to Use Claude Code From Your iPhone: Three Ways to Control Your Mac's Terminal Remotely, Including TRMNLY

Claude Code runs on your computer, but you can drive it from an iPhone. Here's how with Anthropic's Remote Control, with SSH and tmux, and with the TRMNLY terminal's iPhone remote.

A glass phone standing behind a dark glass keyboard, joined to it by a single beam of cyan light

You can't install Claude Code on an iPhone, but you can control a Claude Code session running on your Mac from one. The quickest way is Claude Code's own Remote Control: run claude remote-control (or type /remote-control in a running session) and open the session in the Claude app on your phone.1

That covers a single conversation. If you want the whole terminal on your phone, there are two more options: SSH into the Mac with tmux, or use a terminal with a phone remote built in, such as TRMNLY. This guide covers all three and what each is good for.

Option 1: Claude Code Remote Control

Remote Control connects the Claude app for iOS and Android, or claude.ai/code in a browser, to a Claude Code session running on your machine. Claude keeps running locally, so your files, MCP servers and tools stay on your computer. The phone is a window into the session.1

Requirements: a Pro, Max, Team or Enterprise plan, signed in with /login. API keys aren't supported, and on Team and Enterprise an Owner has to enable it first.1

Steps:

  1. In your project folder, run:

    claude remote-control
    

    It asks you to confirm once, then waits for connections and prints a session URL.

  2. Press the spacebar to show a QR code, and scan it with your phone to open the session in the Claude app.

  3. Already in a session? Type /remote-control (or /rc) and it carries on remotely. claude --remote-control "My Project" starts an interactive session that's also reachable from your phone.1

Limits: your computer has to stay on and the claude process has to keep running.1 You get the Claude Code conversation, not your other terminal panes, and only for Claude Code: not Codex, a test runner or a dev server.

Option 2: SSH and tmux

This is the old-fashioned way, and it works with any agent and any program.

  1. On the Mac, turn on System Settings → General → Sharing → Remote Login.

  2. Make the Mac reachable from outside your network. A mesh VPN like Tailscale is the simplest option, because it avoids opening ports on your router.

  3. Start your agent inside tmux so it survives a disconnect:

    tmux new -s work
    claude
    
  4. On the iPhone, open an SSH client, connect to the Mac, and run tmux attach -t work.

Limits: typing in a TUI on a phone keyboard is hard work without a key bar for Esc, Ctrl and arrows. Nothing notifies you when the agent stops for a permission prompt, so you have to keep checking. And Claude Code inside tmux needs extra tmux settings before Shift+Enter and notifications work.2

Option 3: The TRMNLY iPhone remote

TRMNLY is a macOS terminal built on Ghostty, and it has an iPhone app made to drive it. The app isn't a terminal of its own. It reaches your Mac through trmnly.dev, so the Mac has to be running TRMNLY, paired and online.3

Steps:3

  1. On the Mac, press ⌘,, open AI Agent, scroll to Remote Control (trmnly.dev) and turn on Enabled.
  2. Under Pair this Mac, press Start pairing and confirm the code on trmnly.dev. TRMNLY then runs a tunnel. If you don't have cloudflared, it downloads a pinned copy and verifies it.
  3. Install the iPhone app from TestFlight (it's in beta) and sign in with GitHub or a pairing code.

What you can do from the phone:

  • Read and type into any pane. The Terminal tab picks a project, a tab and a split, and by default follows whatever the Mac has focused. On a current Mac the pane streams live, in colour, at about ten frames a second.4
  • Use a real key bar. Esc, Tab, ⇧Tab, ^C, arrows and F1–F12 each send a real keystroke, so ^C interrupts Claude Code and Esc gets you out of vim. Ctrl and Alt are sticky. Send types your text and presses Return, so Claude Code takes it as a turn.4
  • Answer approvals from the lock screen. When TRMNLY's agent or an MCP client on the Mac needs your OK, the request arrives as a notification with a safety badge and the arguments. A file edit shows the diff. Allow for 15 min needs Face ID and is never offered for a dangerous tool.3
  • Get told when a job finishes. Tap 🔔 on a pane and lock the phone. You get a notification when the pane goes quiet or its command finishes.3
  • Keep the Mac awake for 1 or 4 hours while you're away.3

The remote works with anything running in a pane: Claude Code, Codex, a build. Approval cards come from TRMNLY's own agent and from MCP clients such as Claude Code connected to TRMNLY's tools.

Security. Each paired device can be limited to scopes (read, terminal, files:write, agent, gui, docker, admin) and given an expiry. A phone paired through GitHub starts unconfirmed until you confirm it on trmnly.dev, and Kill all remote access revokes every device and stops every Mac's tunnel at once.4 We covered the hardening in Your iPhone can type into your Mac's terminal.

Limits: the iPhone app is in TestFlight beta, and TRMNLY itself runs on macOS. Without the Mac, the same app can drive a TRMNLY cloud workspace instead.3

Which should you use?

  • One Claude Code conversation on a Pro or Max plan: Remote Control. It's built in and free.
  • Any program, no new software, and you don't mind a phone keyboard: SSH and tmux.
  • The whole terminal, approvals on the lock screen, and notifications when things finish: TRMNLY. The iPhone remote lesson takes 10 minutes, and the Remote control docs cover tunnels, scopes, widgets and Shortcuts.

TRMNLY is $99 per seat including 12 months of updates, with optional $69 renewals. Access is invite-only during early access, so request access to try it.

Sources

  1. 1.Claude Code docs, "Continue local sessions from any device with Remote Control." code.claude.com
  2. 2.Claude Code docs, "Configure your terminal for Claude Code: Configure tmux." code.claude.com
  3. 3.TRMNLY Learn, "The iPhone remote." trmnly.dev/learn/iphone-remote
  4. 4.TRMNLY docs, "Remote control (pair + tunnel)." trmnly.dev/docs/remote