← Claude Docs

Continue local sessions from any device with Remote Control - Claude Code Docs

Claude Docs · April 16, 2026
Remote Control connects claude.ai/code or the Claude app to a local Claude Code session, allowing work to continue across devices while processing remains entirely on the local machine. Sessions synchronize across all connected devices and automatically reconnect after interruptions, maintaining access to the full local environment including filesystem, MCP servers, and project configuration. The feature can be started from the CLI or VS Code extension and accessed via direct URL, QR code, or session list.

Detailed Analysis

Anthropic has introduced Remote Control, a feature for Claude Code that bridges locally running AI coding sessions with remote interfaces including the claude.ai/code web interface and the Claude mobile app for iOS and Android. The feature allows developers to initiate a Claude Code session on their primary machine and then continue interacting with that same session from a browser on another computer or from a smartphone, without interrupting the underlying computational process. Critically, the session itself never migrates to cloud infrastructure — the local filesystem, MCP servers, tool configurations, and project context remain entirely on the originating machine, with remote devices functioning purely as interface windows into the live local process. Users can launch Remote Control sessions through three pathways: server mode via the CLI (`claude remote-control`), interactive mode with the `--remote-control` flag, or from within an existing session using the `/remote-control` command. The VS Code extension also supports the feature as of version 2.1.79.

The architecture of Remote Control reflects a deliberate design philosophy prioritizing local compute sovereignty over convenience-driven cloud migration. By keeping execution on the user's machine, Anthropic preserves access to the full depth of a developer's local environment — including private repositories, local MCP integrations, and custom tool configurations that would be impossible or impractical to replicate in a cloud sandbox. Conversation state synchronizes across all connected surfaces simultaneously, meaning a developer can send a prompt from their terminal, receive a partial response, and continue the thread from a phone without any context loss. The system also includes resilience mechanisms: if the host machine's network drops or the laptop sleeps, the session is designed to reconnect automatically when connectivity resumes, reducing the friction of interrupted workflows.

The feature's multiple invocation modes reveal a nuanced approach to concurrent session management. Server mode, for instance, supports up to 32 concurrent sessions by default and offers three spawn strategies — `same-dir`, `worktree`, and `session` — that govern how individual remote connections interact with the host filesystem. The `worktree` mode, which provisions a separate git worktree per remote session, is particularly significant for team contexts where multiple collaborators might connect to the same machine simultaneously without risking file-level conflicts. The `--capacity` flag and runtime toggle between `same-dir` and `worktree` modes further suggest that Anthropic is positioning Remote Control not only as a personal productivity tool but as a potentially multi-user infrastructure primitive for team and enterprise deployments.

Remote Control situates itself within a broader industry movement toward what might be called "local-first AI agents" — systems where the intelligence and interface are decoupled from the execution environment. As AI coding agents become capable of long-running, multi-step autonomous tasks, the ability to monitor and steer those tasks from arbitrary devices becomes operationally essential. A developer who starts a large refactoring job before leaving the office gains meaningful value from being able to check tool activity, approve decisions, or redirect the agent from a mobile device without requiring the agent to pause or checkpoint state to remote servers. This pattern contrasts with fully cloud-hosted agent paradigms and addresses a specific class of user concern around data residency, credential exposure, and latency-sensitive tooling that cannot be safely replicated outside a local environment.

The feature's availability restricted to Pro, Max, Team, and Enterprise subscription tiers — with explicit exclusion of API key authentication — signals Anthropic's intent to position Remote Control as a higher-tier differentiator tied to its consumer and enterprise product lines rather than the developer API ecosystem. The requirement for admin-level enablement on Team and Enterprise plans further indicates that Anthropic anticipates organizational governance concerns around remote session capabilities, particularly in environments where code and data sensitivity is high. As AI agents increasingly operate over extended time horizons and interact with sensitive local systems, the governance layer around who can initiate, monitor, and terminate remote sessions becomes as important as the technical capability itself.

Read original article →