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 pingandtailscale netcheckto 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 --operatorfirst.
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
Related
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.