How to use Claude Code from your iPhone

Keep Claude Code running on your own machines and use your iPhone as its remote. Install the Commission hub on a Mac, put the Mac and the iPhone on the same Tailscale network, and scan the QR code from Settings › Connect phone with the Commission app. Every session on every machine is then on your phone: start new ones, reply to Claude, approve commands and read diffs.

What you need

  • A Mac that stays on and awake, to run the hub. The Commission Mac app needs macOS 14 or later.
  • Claude Code installed and signed in on that Mac, and on any other machine you add. Commission uses your own Claude plan and doesn't resell or meter Claude.
  • Tailscale on the Mac and on the iPhone, signed in to the same tailnet. It's free for personal use.
  • The Commission iPhone app. It's in a private TestFlight beta and there's no public link yet. Until there is, use Safari on the iPhone.

Set it up

  1. On the Mac, download the Mac app and follow its setup, or run the installer in Terminal:
curl -fsSL https://commission.sh/install | sh

The installer checks that Claude Code is installed and signed in and that Tailscale is installed, installs the hub as you (never with sudo), and asks before it publishes the hub to your tailnet with Tailscale Serve.

On a new tailnet, Tailscale may need you to turn on Serve and HTTPS certificates in its admin console first. If publishing fails, the installer prints Tailscale's message and the command to run once it's on. commission doctor then checks Tailscale and Tailscale Serve for you. How Commission uses Tailscale Serve and Tailscale SSH covers this in more detail.

  1. On the iPhone, open Tailscale and make sure it's connected.
  2. On the Mac, open Commission and go to Settings › Connect phone, in the Mac app or at http://127.0.0.1:4317 in a browser. It shows a QR code and your hub's tailnet address.
  3. Scan the code with the iPhone's Camera, or open the Commission app and tap Scan QR code. You can also type the address. There's no account and no pairing code.
  4. The app doesn't ask about notifications on first launch. The first time something needs you, it offers to turn them on. You can also turn them on in Settings › Notifications and send a test.

Until the app is public: use Safari

While the iPhone app is in its private beta, you can still use Commission on your iPhone. With Tailscale connected, open your hub's address in Safari: https://your-mac.your-tailnet.ts.net. Settings › Connect phone on the Mac shows the exact address.

It's the same UI the Mac app and desktop browsers use, so you can start sessions, reply, approve requests and read diffs. What you don't get is push notifications: those need the app. You see what needs you when you open the page.

What you can do from your phone

  • See every session on every machine in one list, with what needs you at the top, grouped into spaces if you use them.
  • Start a new session in any folder on any machine, or from a Linear or Jira issue.
  • Reply to Claude, answer its questions and stop a run. One chip in the composer sets the permission mode, model and effort.
  • Send Claude a photo, a screenshot, a PDF or a text file.
  • Answer permission requests from the notification: Allow once with Face ID, or Deny, from the lock screen.
  • Read what changed, file by file, and comment on lines to send to Claude as review notes.
  • Open a terminal in the session's folder, or on any machine without a session.
  • Open the links Claude gives you in Commission's own browser, with your bookmarks.
  • Set a reminder to come back to a conversation, and open a quick chat from any tab.
  • Keep writing while a machine is away. Messages wait under the conversation and send in order when it's back.
  • Follow a conversation you started in a terminal at your desk. The turns you take there show up as they happen.
  • On an iPad, sessions and the conversation sit side by side.

How this differs from Remote Control

Anthropic's Remote Control connects the Claude app to Claude Code running on your machine, through Anthropic's servers. In server mode (claude remote-control) it serves several sessions, and you can start new ones from the app on a machine where that command is running. Sessions from several machines show in one list on claude.ai. It needs a Pro, Max, Ultra, Team or Enterprise plan.

Commission is a hub you run yourself on your own tailnet, with no relay and no Commission cloud. It installs and keeps its own host on each machine over SSH, so you don't leave a remote-control process running on each one, and you can start a session in any folder on any machine you've added. Allow once works straight from the lock-screen notification. It also adds Activity, Linear and Jira, coordinators and Update all. The two work side by side.

For the details, see Claude Code Remote Control alternatives, compared.

Questions

Does Claude run on my phone?No. Claude Code keeps running on your Mac, server or PC. The phone is a remote for it, so your files and tools stay where they are.
Does it work away from home Wi-Fi?Yes. Tailscale connects your phone to your Mac over any network, including mobile data, without opening anything to the internet.
Is the iPhone app in the App Store?Not yet. It's in a private TestFlight beta with no public link yet. Until it opens, use Commission in Safari on your iPhone over Tailscale. Push notifications need the app.
Is there an Android app?It's on the way. Until then, open your hub's tailnet address in Chrome with Tailscale connected: it's the same app, just without push notifications.
What happens if my Mac restarts?Your sessions are still there. The hub is a LaunchAgent, so it starts again when you log in to the Mac, and a turn that was cut off continues on its own.
Does it cost anything?Commission is free while it's in beta. You use your own Claude plan, and Commission doesn't resell or meter Claude.

Put every session in your pocket

Set up the hub on your Mac, connect your iPhone over Tailscale, and every session on every machine is a tap away. Commission is free while it's in beta.