2 minute read

Want to run Claude Code from your iPhone or iPad? Here’s how I set it up - and yes, it actually works great for quick fixes on the go.

Claude Code running on iPad via Termius
Yes, even on iPhone - Termius has a great mobile keyboard


What You Need

  • An Ubuntu machine (local, cloud VM, whatever)
  • Termius app on your iPhone/iPad (free version works)
  • A Tailscale account (also free)

Step 1: Set Up Your Dev Machine

SSH into your Ubuntu machine and run my setup script:

Friendly reminder: Always read scripts before running them.

TLDR: ./setup-machine.sh && sudo tailscale up → tailscale login → npm install -g @anthropic-ai/claude-code

git clone https://github.com/anuraj-rp/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup-machine.sh

Don’t want everything? Run individual scripts instead:

./install-tailscale.sh  # Required - for remote access
./install-nodejs.sh     # Required - for Claude Code
./install-tmux.sh       # Recommended - keeps sessions alive

Skip what you don’t need: install-docker.sh, install-vim.sh, install-starship.sh, install-nerdfonts.sh

All scripts support cleanup - e.g. ./install-vim.sh --clean (remove configs) or --clean-all (full uninstall).

The full setup installs:

  • tmux - keeps your sessions alive when you disconnect
  • vim with plugins (NERDTree, themes, git integration)
  • Docker
  • Tailscale - the magic that makes this work from anywhere
  • Starship prompt - because life’s too short for ugly terminals

Step 2: Connect to Tailscale

sudo tailscale up

Follow the URL it gives you to authenticate. Then grab your Tailscale IP:

tailscale ip

Keep this IP handy - you’ll need it for Termius.

Step 3: Set Up Termius

  1. Open Termius → tap “+” → “New Host”
  2. Enter your Tailscale IP as hostname
  3. Add your username and password (or set up SSH keys)

Connect and you’re in!

Step 4: Using tmux (Essential for Mobile)

Start a named session:

tmux new -s dev

Now here’s the beauty - if your connection drops (happens on mobile), just reconnect and run:

tmux attach -t dev

Everything’s exactly where you left it.

Quick tmux commands (prefix is Ctrl+a):

What Keys
New window Ctrl+a c
Next/prev window Ctrl+a n / Ctrl+a p
Split screen Ctrl+a \| or Ctrl+a -
Detach Ctrl+a d

Step 5: Install Claude Code

npm install -g @anthropic-ai/claude-code

Now just run claude and start coding from your phone!

Step 6: Add Claude HUD (Optional)

Claude HUD adds a statusline showing context usage, active tools, running agents, and todo progress.

Install it from within Claude Code:

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

Pro Tips

tmux plugins - Press Ctrl+a Shift+i after first launch to install session persistence and vim integration.

Multiple machines? Run tailscale status to see all your devices. Add each to Termius and switch between them easily.

Why This Works So Well

Tailscale creates a secure mesh network between your devices. Termius gives you a proper terminal with a mobile-friendly keyboard row (Ctrl, Esc, arrows). And tmux means you never lose your work when switching apps or losing signal.

I’ve used this setup on trains, buses and coffee shops. It’s surprisingly usable for quick bug fixes and code reviews. Give it a shot!