Claude Mobile Setup

iPhone-optimized remote access to Claude Code via Termius + Mosh + tmux.

Features

• Mosh - Survives network drops (WiFi→cellular, tunnels, sleep/wake)
• Session Picker - Quick selection of active Claude sessions on connect
• Voice Input - Speak prompts via Termius speech-to-text
• Single Window - Optimized for iPhone screen
• Shift+Tab - Native support in Termius for Claude's approval workflow

Prerequisites

• macOS with Homebrew
• Tailscale for secure remote access
• Claude Code CLI installed
• iPhone with Termius

Installation

git clone https://github.com/YOUR_USERNAME/claude-mobile-setup.git
cd claude-mobile-setup
./install.sh

What Gets Installed

File	Location	Purpose
claude-picker	~/bin/	Session selector (runs on connect)
claude-session	~/bin/	Create new Claude sessions
claude-attach	~/bin/	Attach to existing session
tmux.conf	~/.tmux.conf	Mobile-optimized tmux config

Quick Start

On Mac:

# Start a session for your project
claude-session myproject ~/projects/myapp

# Detach: Ctrl-A then d

On iPhone:

1. Open Termius
2. Connect to your Mac host
3. Select session from picker
4. Code with voice!

Termius Setup

See TERMIUS_SETUP_QUICK_GUIDE.md for detailed iPhone setup instructions.

Quick config:

• Mosh: ON
• Startup command: claude-picker

Architecture

iPhone (Termius)
    │
    │ Mosh (UDP, survives network drops)
    ▼
Mac (Tailscale IP)
    │
    ├── claude-picker (session selector)
    │       │
    │       ▼
    └── tmux session
            │
            └── Claude Code

Recommended Termius Snippets

Name	Content	Voice trigger
yes	yes	"yes"
no	no	"no"
cont	continue	"continue"
tests	run the tests	"run tests"
commit	commit these changes	"commit"

tmux Cheatsheet

Prefix: Ctrl-A

Action	Keys
Detach	Ctrl-A → d
Scroll	Ctrl-A → [
Reload	Ctrl-A → r

Mouse scrolling is enabled.

Troubleshooting

Mosh connection fails

• Ensure UDP ports 60000-61000 are accessible
• On restrictive networks, disable Mosh in Termius (falls back to SSH)

Session picker doesn't appear

• Check Termius startup command is set to claude-picker

Voice input not working

• Tap microphone icon in Termius keyboard toolbar
• Grant microphone permission if prompted

License

MIT