Remote Control โ Claude Code on Mobile
Claude CodeAccess 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
--nameSpecify session name--spawn worktreeRun in isolation with Git worktree--capacity NMaximum concurrent sessions (default 32)
Requirements and Caveats
-
⚠
Claude Code v2.1.51 or later required (
claude --versionto 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
Type /remote-control in existing session โ access from mobile with full conversation history
New session: Run claude remote-control in terminal
Scan QR code with Claude mobile app, or connect via session name at claude.ai/code
All local MCP servers, files, and tools remain fully accessible
Tags
Source
Anthropic Docs