How to use Claude Code over Tailscale

Commission keeps Claude Code on your own network by using Tailscale twice. Tailscale Serve publishes the hub on your Mac to your tailnet, at https://your-mac.your-tailnet.ts.net, so your iPhone and browsers reach it from anywhere. The hub reaches your other machines over SSH, including Tailscale SSH. Nothing listens on the internet, and there's no Commission account.

Why Tailscale

Tailscale puts your devices on one private network, your tailnet, over Wi-Fi or mobile data, without port forwarding. It gives each device a name and an HTTPS certificate for it. Commission builds on that instead of running its own relay or cloud: your phone talks to your hub, and your hub talks to your machines, all inside your tailnet. Tailscale is free for personal use.

Tailscale Serve for the hub

The hub listens only on 127.0.0.1:4317 on your Mac. When you install it, the installer asks before it runs Tailscale Serve, which publishes that port to your tailnet over HTTPS:

tailscale serve --bg 4317

The hub is then at https://your-mac.your-tailnet.ts.net, and it stays published after restarts. Settings › Connect phone shows the exact address and a QR code for the iPhone app. Commission never uses Tailscale Funnel, so the hub is never on the public internet.

On a new tailnet, Tailscale may ask 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. Until the hub is published, Settings › Connect phone shows that command too. commission doctor checks both Tailscale and Tailscale Serve.

Tailscale SSH for your machines

Your other machines are added over SSH. With Tailscale SSH turned on for a machine, you don't need SSH keys: Tailscale checks who's connecting. Add it by its tailnet name:

commission machine add you@server.your-tailnet.ts.net

Commission still checks the machine's host key, and shows you the fingerprint the first time. Tailscale SSH doesn't forward the kind of connection Commission normally uses to reach a machine's host, so for those machines the hub falls back to the host's loopback port by itself. You don't have to set anything. Plain OpenSSH across your tailnet works just as well. Adding a Linux server to Commission covers the rest of the setup.

Check-mode approvals

A Tailscale SSH policy can use check mode, which makes you approve a connection in the browser before it goes through. Commission shows Approve this connection in Tailscale with an Approve in Tailscale button, in the Mac app, the browser and the phone. Tap it, approve, and the waiting connection carries on by itself. It stays approved for a while, and Commission asks again when Tailscale does.

Commission waits up to ten minutes for you. If nobody approves in time, approve when Tailscale asks and choose Retry. To avoid the prompt for your own devices, set the policy action to accept instead of check.

Keep your tailnet to your own devices

Commission has no login of its own. Being on your tailnet is the trust step: anyone who can reach your hub there can use it as you, on every machine you've added. That's what makes setup a single QR code, and it's why your tailnet should hold only your own devices.

  • Don't share your tailnet, or the hub's Mac, with other people.
  • If your tailnet is shared, use Tailscale's access controls so only your own devices can reach the hub's Mac.
  • Remove old phones and computers from your tailnet when you stop using them, and a lost phone in Tailscale's admin console.

Web pages can't drive your hub: it only answers requests addressed to its own tailnet name or to 127.0.0.1, and refuses browser requests from any other site.

What else Commission does with your tailnet

  • Machines. Devices that aren't in Commission yet are listed on the Machines page, ready to add. Each machine's Tailscale tags show there too.
  • Reachability. A machine's Connection section uses tailscale ping and tailscale netcheck to say whether it's offline, relayed, slow or just needs its host restarted.
  • Taildrop. Send a file… in the session menu puts a file in the session's folder, peer to peer. On Linux, run tailscale set --operator first.

These read from Tailscale or use its own commands. Commission doesn't change your tailnet policy, and it still never uses Funnel.

On your phone

Install Tailscale on the iPhone and sign in to the same tailnet as the Mac, then connect the Commission iPhone app. On Android, until the Android app arrives, install Tailscale from Google Play and open the hub's address in Chrome. Keep Tailscale connected: without it, your phone can't reach the hub.

Questions

Is my hub exposed to the internet?No. It listens on 127.0.0.1 only, and Tailscale Serve publishes it to your tailnet, not the internet. Commission never uses Tailscale Funnel.
Can I use Commission without Tailscale?Not for the phone. The installer needs Tailscale, and your iPhone reaches the hub only over your tailnet. Your other machines can be reached over any SSH connection.
Do I need Tailscale SSH?No. Commission works with ordinary SSH keys too. Tailscale SSH just means you don't have to manage keys for the machines on your tailnet.
Who can use my hub?Anyone who can reach it on your tailnet, as you. There's no separate Commission login, so keep your tailnet to your own devices, or limit access to the hub's Mac with Tailscale's access controls.
Why does Commission ask me to approve in Tailscale?Your tailnet's SSH policy uses check mode for that machine. Approve the connection in the browser and it carries on. Setting the action to accept for your own devices stops the prompt.

Put your hub on your tailnet

Install Tailscale on your Mac and phone, install the hub, and say yes when it offers Tailscale Serve. Commission is free while it's in beta.