Skip to main content
Tips

beginner tip

Control a Running Claude Code Session From Your Phone

AIErudit angle: Async, mobile-driven agent work multiplies delivery throughput — kick off a task at your desk and keep steering it from anywhere. Remote Control keeps the process local (outbound HTTPS only, no open ports) while your phone acts as a window, so you supervise long runs without being chained to the terminal.

remote-controlmobileclaude-codetips
Tip visual

Published: Mar 17, 2026 Updated: 2026-04-28

Original: https://wmedia.es/en/tips/claude-code-remote-control-from-phone

Remote Control connects your local Claude Code session to claude.ai/code or the Claude app for iOS and Android. The process stays on your machine — your phone is just a window into that session. Start a task on your laptop terminal, walk out the door, and keep giving Claude instructions from the bus. That simple.

TL;DR claude --rc or /rc in an active session. Scan the QR code with your phone. Keep working from anywhere. The original terminal must stay open.

Result:

> claude --rc "Refactor API"
Remote Control session started

Session URL: https://claude.ai/code/session/abc123
Press spacebar to show QR code

╭──────────────────────────────────────╮
│ Remote Control: Refactor API         │
│ Status: Online                       │
│ Connected devices: 1                 │
╰──────────────────────────────────────╯

How to use it

1. New session with Remote Control

# Interactive session with remote access
claude --rc

# With a custom name
claude --rc "Refactor API"

Opens a normal terminal session that's also accessible from your phone or any browser.

2. Enable on an existing session

If you're already working with Claude:

/rc

Carries over your full conversation. Shows URL and QR code to connect.

3. Server mode

# No local interaction, only serves remote connections
claude remote-control --name "Backend" --spawn worktree

In server mode, each remote connection can spin up its own worktree (requires a git repository). Supports up to 32 concurrent sessions.

4. Connect from another device

  • QR code: in server mode, press spacebar to show the QR. With /rc, it appears automatically. Scan with your phone
  • Direct URL: copy the session URL into any browser
  • Session list: find it by name in claude.ai/code or the Claude app (computer icon with green dot = online)

5. What you need to know

The original terminal must stay open. If you close it or stop the process, the session ends. If your laptop sleeps, the session reconnects automatically when it wakes up — but if it loses network for more than ~10 minutes while awake, the session times out and the process exits. You'll need to run the command again.

Reference

CommandWhat it does
claude --rcInteractive session + Remote Control
/rcEnable Remote Control on an existing session
claude remote-controlServer mode (remote connections only)
--name "Name"Visible name in the session list (server mode)
--spawn worktreeEach remote session in its own worktree (server mode)
--capacity <N>Max concurrent sessions, default: 32 (server mode)
DetailValue
Original terminalMust stay open
Laptop sleepAuto-reconnects on wake
Timeout~10 min without network (while awake). Process exits.
SecurityOutbound HTTPS only, no open ports
SyncBidirectional — terminal, browser, and phone in parallel
PlansAll plans. Team/Enterprise admins must enable Claude Code first.
Min versionv2.1.51+

Official docs: Remote Control

Requirements

  • Available on all plans (API keys not supported). Team and Enterprise admins must enable Claude Code in admin settings.
  • Claude Code v2.1.51 or later
  • Claude app for iOS or Android (optional — also works from any browser)

Related: Computer use — when the terminal is not enough · Channels: control from Telegram · Claude Code on the web