lockstep
4 min readNaman Jain

Claude Code Remote Control: control a local session from your phone

Claude Code Remote Control: start it three ways, connect from a phone or browser, server mode, security, limits, and how it differs from cloud sessions.

You start a long refactor at your desk, then have to leave for a meeting. Claude Code is halfway through and will need you to approve a migration in twenty minutes. With Remote Control, the approval prompt shows up on your phone, and the work keeps running on your laptop.

This guide covers setup and use from Anthropic's Remote Control documentation, checked on 16 November 2026.

What it does

Remote Control connects claude.ai/code or the Claude app on iOS or Android to a Claude Code session on your machine. Claude keeps running locally, so your files, MCP servers, tools, and project configuration all stay available. Per the docs, you can:

  • Send messages from your terminal, browser, and phone interchangeably
  • See subagents and workflows running in the background, and stop them remotely
  • Attach photos and files from your phone; other files are downloaded to your machine
  • Reconnect automatically if the laptop sleeps or the network drops

Requirements

  • Plan: Pro, Max, Ultra, Team, or Enterprise. API keys aren't supported.
  • Sign-in: a claude.ai login via /login.
  • Team and Enterprise: an Owner must turn on the Remote Control toggle in Claude Code admin settings.
  • Not available for organizations with Zero Data Retention or the HIPAA configuration.

Three ways to start

ModeCommandUse when
Server modeclaude remote-control (or claude rc)You want sessions you start and drive remotely, several at once
Interactiveclaude --remote-control "My Project"You want a normal terminal session that's also reachable remotely
From a running session/remote-control (or /rc)You're mid-task and want to continue from another device

The desktop app and VS Code extension use /remote-control.

Server mode waits for remote connections, prints a URL, and shows a QR code when you press the spacebar. Useful flags:

  • --spawn worktree gives each new session its own git worktree, so parallel sessions don't edit the same files. The default, same-dir, shares the directory.
  • --capacity <N> caps concurrent sessions; the default is 32.
  • --permission-mode acceptEdits sets the starting mode for the server's sessions.
  • --continue brings back the session the last server in this directory started.

Connecting from another device

  • Open the URL Claude Code prints, in any browser.
  • Scan the QR code to open it in the Claude app.
  • Find it by name at claude.ai/code or in the app's Code tab.

Name sessions with /rename or --name so you can find them. Run /mobile in Claude Code to get a QR code for installing the app.

Remote Control vs cloud sessions

Remote ControlCloud session
Runs onYour machineAnthropic's infrastructure
Local MCP servers and toolsAvailableOnly what's in the repository
Machine must stay onYesNo
Needs a local cloneYesNo
Parallel tasksServer mode, up to its capacityMany

Anthropic's guidance: use Remote Control to continue local work from another device; use a cloud session to start work without local setup, on a repository you haven't cloned, or many tasks in parallel.

Security

Per the docs, the local session makes outbound HTTPS requests only and never opens inbound ports. Traffic goes through the Anthropic API over TLS, using several short-lived credentials each scoped to one purpose. While connected, the transcript is stored on Anthropic's servers to keep devices in sync. Admins can turn the feature off with the disableRemoteControl setting, and Team and Enterprise organizations can require Trusted Devices.

Limitations

  • The local process must keep running. Close the terminal or quit the app, and the session goes offline.
  • One remote session per interactive process. Use server mode for several.
  • Some commands are local-only, such as /plugin and /resume. Others, like /model and /effort, take the value as an argument from mobile and web.
  • Long network outages: server mode gives up after about 10 minutes; an interactive session keeps retrying.

Other ways to work away from the terminal

Anthropic's docs list several, including Dispatch (message a task from the mobile app to the desktop app), channels (push events from chat apps), Claude in Slack, and scheduled tasks. See how to resume a Claude Code session for moving sessions between machines.

Where Lockstep fits

Steering from a phone means shorter messages and less context in each one. Lockstep briefs Claude Code sessions on the team's approved decisions that apply to the work, captured from PRDs, Slack, and pull requests, so the session already knows them when you check in from your phone.

See how it works.

Sources checked 16 November 2026

For Claude Code's other surfaces, see Claude Code desktop vs CLI vs VS Code. For permission modes when you're away, see plan mode vs auto mode vs accept edits.

Frequently asked questions

What is Claude Code Remote Control?
A feature that connects claude.ai/code or the Claude mobile app to a Claude Code session running on your machine. Claude keeps executing locally, with your filesystem, MCP servers, and project configuration, while you send messages and approve actions from another device.
How do I start Remote Control?
Run claude remote-control (or claude rc) in your project for server mode, claude --remote-control for an interactive session that's also remote, or /remote-control (or /rc) inside a running session. Then open the URL it prints, scan the QR code, or find the session at claude.ai/code.
What do I need to use Remote Control?
A Pro, Max, Ultra, Team, or Enterprise plan with a claude.ai login; API keys aren't supported. On Team and Enterprise, an Owner must enable Remote Control in Claude Code admin settings first.
What is the difference between Remote Control and cloud sessions?
Remote Control runs on your machine, so local tools and configuration are available, but the machine must stay on. Cloud sessions run on Anthropic's infrastructure, need no local setup, keep going when your laptop is closed, and can run many tasks in parallel.
Is Remote Control secure?
Anthropic's docs say the local session makes only outbound HTTPS requests and never opens inbound ports. Traffic goes through the Anthropic API over TLS with short-lived, single-purpose credentials. While connected, the session transcript is stored on Anthropic servers to sync devices.

Keep reading