--remote
A Claude Code CLI flag, read out of the shipped bundle. It has been in the build since v2.1.138, including the newest one read.
Deprecated alias for --cloud, including the existing-session form
Anthropic's own wording. Read off CLI reference, captured 2026-09-26.
In the changelogs
24Releases whose published page names --remote.
-
v2.1.305
Cloud sessions can open a sign-in screen when sign-in fails
If sign-in fails when starting a
--cloudsession, Claude Code can now show a sign-in screen and carry on instead of only printing an errorfound in this entry's text, named in this entry
-
v2.1.300
Remote sessions now report the permission mode the remote machine actually applied
When you create a
--remotesession, the permission mode notice is now worked out after the session exists, from what the runner appliedfound in this entry's text, named in this entry
-
v2.1.296
Cloud session creation is prepared to limit built-in tools, but nothing is limited yet
Creating a session with --remote can now pass a built-in tool restriction, though in this version no restriction is ever sent
found in this entry's text, named in this entry
-
v2.1.292
Clearer error when remote sign-in setup fails, plus a plugin publish name
A failed sign-in setup with --remote now logs the real error, and a plugin_publish plugin operation name has been added
found in this entry's text
-
v2.1.287
Claude Code recognises
--cloudused with--attach-servewhen loading settingsStarting with
--cloudor--remoteplus--attach-serve, and without-p, now changes how some settings sources are treatedfound in this entry's text, named in this entry
-
v2.1.287
--cloudstops early when it would need a keyboard it can't readIf
--cloudwould open a session in your terminal but there is no keyboard to read from, Claude Code now exits with an error before creating itfound in this entry's text, named in this entry
-
v2.1.285
Starting a cloud session no longer offers to sync your folder
Launching with
--cloudno longer runs the folder sync offer, local-change check or upload planning, and a new warning covers failed look-upsfound in this entry's text, named in this entry
-
v2.1.284
Cloud-session attach and folder sync get new remote switches
Joining an existing cloud session, trusted-device enrollment and the folder sync offer can now be turned on by two new remote switches, off by default
found in this entry's text
-
v2.1.283
claude --remotecan now offer this machine's tools to the cloud sessionWhen
claude --remotestarts a cloud session and stays attached, it can now make tools on your own machine available to that sessionfound in this entry's text, named in this entry
-
v2.1.283
--remotecan ask before sharing local MCP servers or serving tools unattendedAn attached
--remotesession can now ask whether to share your local MCP servers, and ask again before serving tools in auto or bypass modefound in this entry's text, named in this entry
-
v2.1.283
--remotenow tells you when the directory sync offer was put offIf a
--remotesession's directory sync offer is deferred because its anchor is unavailable, you now see a warning instead of nothingfound in this entry's text, named in this entry
-
v2.1.282
Directory sync prompt notes when your answer covers every worktree
The cloud directory sync prompt now says your answer applies to every worktree when you're in a worktree other than the main one
found in this entry's text, named in this entry
-
v2.1.281
docker logs / docker inspect read-only checks now refuse remote-daemon flags and tilde paths
docker logsanddocker inspectstop running automatically as read-only when given connection flags or tilde pathsfound in this entry's text
-
v2.1.275
New 'cloud_session_default' telemetry path and 'violin_wood_gate' flag for --remote session creation
Cloud/remote session creation now tracks whether the session type was defaulted, with a new telemetry event
found in this entry's text, named in this entry
-
v2.1.268
Remote-control bridge: distinguishes org-policy denial and logs it before exiting
Remote Control now logs and distinguishes org-policy denials before exiting
found in this entry's text, named in this entry
-
v2.1.265
New --attach-serve CLI flag to attach a headless client to an existing cloud session
New
--attach-serveflag connects a headless client to an already-running cloud session instead of starting a new onefound in this entry's text
-
v2.1.238
Carrying and reporting your local permission mode in remote sessions is gated off
Remote sessions could inherit your local permission mode and effort level, but no value is compiled in.
named in this entry, found in this entry's text
-
v2.1.224
--teleportand--cloudshow up inclaude --help--teleportand--cloudnow show up inclaude --help.named in this entry, found in this entry's text
-
v2.1.221
--cloud and --remote pre-parsing
The --cloud and --remote flags no longer get special early handling and go straight to the normal parser.
named in this entry, found in this entry's text
-
v2.1.213
Docker: Additional Global Flag Pass-Through
found in this entry's text
-
v2.1.166
--cloudreplaces--remotefor cloud sessionsfound in this entry's text
- v2.1.166
-
v2.1.118
/plugin tag Command
found in this entry's text
-
v2.1.116
Remote Control Blocked Inside Remote Sessions
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
1Build by build
149One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.