๐Ÿ“ฑ

Remote Control โ€” Claude Code on Mobile

Claude Code

Access from smartphone/browser with claude remote-control

Claude Code has a built-in remote-control feature that lets you continue a session running on your local PC from your smartphone or another device's browser. No SSH tunneling or separate server setup needed โ€” just scan a QR code or visit claude.ai/code.

Method 1: Remote Control (Official Built-in Feature)

A feature built into Claude Code v2.1.51+, allowing you to connect from mobile without any SSH setup.

Continue an existing session on mobile (most practical!)

While inside an active Claude Code session, type /remote-control to connect from mobile with your current conversation history fully preserved.

/remote-control

โ†’ A QR code appears โ†’ Scan with the Claude mobile app โ†’ Continue the same session on mobile

To start a new session (from terminal):

claude remote-control claude remote-control --name "My Project"

New session vs. existing session

Command Behavior
/remote-control Preserves existing session โ€” keeps conversation history, most practical
claude remote-control Creates a new session (server mode)
claude --remote-control New session + local input also available

How to Connect

  • 1
    Scan QR code โ€” Press spacebar to display a QR code โ†’ Scan with the Claude mobile app
  • 2
    claude.ai/code โ€” Open in browser and connect via session name
  • 3
    Claude mobile app โ€” Session appears automatically in the session list

Key Benefits

  • No SSH required โ€” Connects over HTTPS without any port forwarding or key setup
  • Local environment preserved โ€” All MCP servers, project files, and custom tools remain accessible
  • Multi-device โ€” Send messages simultaneously from terminal, browser, and smartphone
  • Auto-reconnect โ€” Automatically reconnects even after network interruption

Server Mode Options

claude remote-control \ --name "My Project" \ --spawn worktree \ --capacity 32 \ --verbose
  • --name Specify session name
  • --spawn worktree Run in isolation with Git worktree
  • --capacity N Maximum concurrent sessions (default 32)

Requirements and Caveats

  • Claude Code v2.1.51 or later required (claude --version to check)
  • Pro, Max, Team, Enterprise subscription required
  • Closing the local terminal ends the session โ€” keep the terminal open
  • Session times out after approximately 10 minutes of network disconnection

Method 2: Direct SSH Access (Alternative)

If Remote Control is not available in your environment, you can also connect directly via SSH.

Platform Recommended App Features
Android Termux Full Linux environment, recommended to install from F-Droid
iOS Blink Shell Mosh support, keyboard customization (paid)
iOS Termius Multi-device sync, clean UI
ssh user@ServerIP tmux new -s work && claude

With tmux, even if the connection drops, restore with tmux attach -t work

Comparison: Remote Control vs SSH

Item Remote Control SSH
Setup difficulty Very easy (single command) SSH key setup required
Mobile app Official Claude app Termux, Blink, etc.
Code execution location Local PC Remote server
PC power Must be on Only server needs to be on

How to Use

1

Type /remote-control in existing session โ†’ access from mobile with full conversation history

2

New session: Run claude remote-control in terminal

3

Scan QR code with Claude mobile app, or connect via session name at claude.ai/code

4

All local MCP servers, files, and tools remain fully accessible

Tags

#mobile #remote-control #qr-code #smartphone #browser

Source

Anthropic Docs