Access your desktop Claude Code session from your phone using tmux & Tailscale

Access your desktop Claude Code session from your phone using tmux & Tailscale

If you use Claude Code on your computer, you may often ask it to do something and then get up to grab a coffee or something else. If you use agents, context engineered tasks, hooks etc. it makes the sessions uninterrupted for long periods of time. You may be curious to watch the progress even when you step away.

With just ssh you can open a remote session from your phone to your desktop. But that doesn’t give you mirroring of the session.

Wouldn’t it be amazing to have a real-time mirror of your desktop terminal window on your phone in an interactive way? i.e. you can type a command on your phone and it will be executed on your desktop, and any responses will stream back to your phone, while still being able to also do that from your desktop directly?

Here’s how you can do it.

1. Install tmux on your desktop

This lets you create persistent terminal sessions you can re-attach to from anywhere.

brew install tmux     # macOS
sudo apt install tmux # Debian/Ubuntu

Start a named session

tmux new -s claude

Run your Claude code session inside this tmux window.

2. Install Tailscale on both devices

This gives you a private network between your desktop and phone without firewall headaches.

  • Go to https://tailscale.com and install on:
    • Desktop (macOS/Linux/Windows)
    • Phone (iOS/Android)
  • Log into both with the same Tailscale account.

Now your phone and desktop can talk to each other as if they were on the same LAN.

3. Connect to your desktop from your phone

Use a mobile terminal app that supports SSH:

SSH into your desktop using the Tailscale IP or hostname:

ssh yourname@yourdevice-name.tailnet-yourname.ts.net

4. Reattach to the same tmux session

Once SSH’ed in from your phone:

tmux attach -t claude

Now you’re in the same session. Everything you see on your desktop terminal, you also see (and control) on your phone — and vice versa.

Access your desktop Claude Code session from your phone using tmux & Tailscale

Note: You will need to have SSH enabled on your desktop for this to work.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.