Mine is a simple workflow with SSH, tmux, and a couple of notification hooks, but it’s been reliable enough that I now use it almost daily.

This post documents my personal setup. If you’re on different devices or platforms, most of the ideas still apply.

Prerequisites

At a high level, the idea is:

• Claude Code runs on my Mac.
• tmux keeps the session alive.
• my phone SSHs in over Tailscale.
• Claude Code hooks send notifications when it stops or needs input.

Install the following tools on your Mac and/or iPhone:

I chose this combination of tools based on my familiarity with them (like tmux), cost (Termius and ntfy have generous free tiers), and ease of use (Tailscale).

I also wanted to (1) share the same Claude Code sessions between devices and (2) get notified on both devices when Claude Code needs my attention.

Enable Remote Login on your Mac

This step allows your Mac to accept SSH connections from other devices, enabling your iPhone to connect to it remotely.

1. On your Mac, choose Apple menu , then click System Settings.
2. Click General ⚙️ in the sidebar, then click Sharing. (You may need to scroll down.)
3. Click next to Remote Login.
4. Turn on Remote Login.
5. Turn on "Allow full disk access for remote users".

Set up Tailscale

Tailscale creates a VPN between your devices, protecting the SSH connection between your Mac and iPhone.

1. Sign in with the same Tailscale account on both your Mac and iPhone.
2. Turn on Tailscale on both devices.
3. On your Mac, click on the Tailscale menu bar icon.
4. Note your Mac's Tailscale IP address (it will look like 100.x.x.x). You'll use this IP address in the next step.

Set up Termius

Termius is an SSH client that lets your iPhone connect to your Mac's terminal, allowing you to control Claude Code remotely.

Generate a Termius SSH key

1. On your iPhone, open Termius.
2. Go to the "Keychain", and tap the add button (+), then "Generate Key".
3. Tap "Save" to create the key with default settings.
4. Tap on the newly created key, then export icon, and then "Copy Public Key". We'll use this in the next step.

Add the Termius key to Mac

1. Return to your Mac and create the ~/.ssh/authorized_keys file if it doesn't exist:

    mkdir -p ~/.ssh && touch ~/.ssh/authorized_keys
   

2. Ensure proper permissions:

    chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys
   

3. Append the copied public key from Termius to the end of the authorized_keys file:

   echo "REPLACE_THIS_WITH_YOUR_TERMIUS_PUBLIC_KEY" >> ~/.ssh/authorized_keys
   

   Your Termius public key should look something like "

   ssh-ed25519 AAAA... Generated By Termius

   ".

Add your Mac as a Host in Termius

1. Return to Termius on your iPhone.
2. Go to "Hosts", and tap the add button (+), then "New Host".
3. Enter the following details and leave other fields as default:
   • "Label": Any custom identifier for your Mac (e.g., "My Personal Mac").
   • "IP or Hostname": Enter the Mac's Tailscale IP noted earlier (e.g., 100.123.45.67).
   • "Username": Your Mac login username.
   • "SSH.id, Key, Certificate, FIDO2": Select the SSH key generated earlier.
4. Tap "Save", then "Connect".

Share the same Claude Code session

tmux lets us access the same terminal session from both the Mac and iPhone. You can start a Claude Code session on your Mac, then seamlessly switch to your iPhone to continue from exactly where you left off and vice versa.

Before connecting from your iPhone, create a tmux session on your Mac:

tmux new -s session_name

Next, navigate to your code directory and start Claude Code:

claude

You can now work normally on your Mac. The tmux session persists in the background even if you close the terminal window.

Next, switch back to Termius on your iPhone and run:

tmux attach -t session_name

You'll see the exact same session that's running on your Mac, with all history and state intact.

Both devices can now view and control the same Claude Code session simultaneously. Any commands you type on your iPhone will appear on your Mac in real-time, and vice versa.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title \"🔔 Claude Code\" -message \"I need your input\" -sound default -activate 'com.googlecode.iterm2' && curl -d \"🔔 Claude Code: I need your input\" ntfy.sh/my-topic"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title \"✅ Claude Code\" -message \"I'm done!\" -sound default -activate 'com.googlecode.iterm2' && curl -d \"✅ Claude Code: I'm done!\" ntfy.sh/my-topic"
          }
        ]
      }
    ]
  },
}