Skip to content
New: answer your agents from your phoneLearn more

Use Claude Code from your iPhone over Tailscale.

At home, the ket app reaches your Mac over Wi-Fi. Away from home, it reaches it over your own Tailscale network, with no port forwarding and no ket server between them.

How the phone reaches your Mac over Tailscale

Tailscale puts your Mac and your phone on a private network of their own, called a tailnet, wherever each one is. ket listens for paired phones on each network the Mac is on, your tailnet included. The ket app on your iPhone or iPad saves two addresses for the Mac: its home address and its tailnet address.

The app tries the home address first and gives it a second, then connects over Tailscale, sooner if the home address fails. Both routes carry the same end-to-end encryption, the Noise protocol pinned to your Mac's key. No ket server sits in between, and Claude Code and your repositories stay on the Mac.

The usual alternative is SSH into the Mac from a terminal app, with tmux to keep the session alive. That puts Claude Code's terminal on a small screen. The ket app shows each session as a conversation, with buttons for permission prompts and plans and a diff to review and merge.

Set up Tailscale on your Mac

  1. Install Tailscale on the Mac and sign in.
  2. In ket, open Settings › Devices and turn it on.
  3. Under Away from home, check the Tailscale row. It should say On, with the address your phone will use.

If the row shows another state, it names the next step:

  • Not installed: Get Tailscale opens the download page.
  • Off: turn Tailscale on from its icon in the menu bar.
  • Signed out: sign in to Tailscale. On a work tailnet, an admin may need to approve the Mac first.

Set up your iPhone or iPad

  1. Install Tailscale on the phone and sign in with the same account as the Mac.
  2. Pair the ket app with your Mac while both are on the same Wi-Fi: scan the QR code in Settings › Devices, check that both screens show the same six digits, and approve the phone on the Mac.

The pairing code carries the Mac's home address. Once the phone connects, the Mac sends its Tailscale address and the app saves it.

If you paired before setting up Tailscale, you can skip pairing again. On the Mac, choose Show code under Away from home, then scan it with the phone's Camera or in the ket app under Pair a desktop. Opening the app once at home after you turn Tailscale on works too.

Check how you're connected

The Secure pill at the top of Worktrees shows a Wi-Fi mark at home and a VPN mark over Tailscale. Tap it to see how the phone is connected.

For more detail, open the Mac under Settings › Paired desktops in the app. Its Ways to reach it list marks the address in use, and gives a reason for any that failed, such as No answer or Refused.

Use Claude Code away from home

Over Tailscale, the app works as it does at home. Start a task and ket creates a worktree for it on your Mac and starts Claude Code there. You answer its prompts and plans from the phone, then merge the result when it's done. Run Claude Code from your phone covers each step.

When the phone can't reach your Mac

After a few seconds without a connection, the app shows Can't reach with your Mac's name and a list of checks. Work through them in this order:

  1. Tailscale on both devices. Check that it's connected on the phone and on the Mac, signed in to the same account, and that the Mac's Away from home row says On.
  2. The Mac awake. Sleep or a closed lid disconnects the phone. On a MacBook, keep it on power with the lid open, and in System Settings › Battery › Options turn on the option that prevents automatic sleeping on a power adapter when the display is off.
  3. ket open on the Mac, with Settings › Devices turned on. If you quit ket with no terminals running, ket stops accepting phones about ten minutes later, until you open it again.
  4. The phone knows the Tailscale address. If the app says it only knows how to reach your Mac on its own network, scan Show code on the Mac. Do the same if the phone last connected while the Mac's Tailscale was off, because the app drops the Tailscale address then.

To use another route, such as a work VPN, add the Mac's address by hand with Add an address under Ways to reach it. It takes a ws:// address like ws://100.101.102.103:7979.

What you need

  • ket on your Mac, with Claude Code installed and signed in the way you already use it.
  • Tailscale on the Mac and on your iPhone or iPad, signed in to the same account.
  • The ket app on your iPhone or iPad, paired with the Mac.

Until ket's first release, you build the Mac app from source. More about the ket phone app.