--cloud
A Claude Code CLI flag, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
What it is
With a task description, create a new [web session](/docs/en/claude-code-on-the-web) on claude.ai. With a session ID (session_... or cse_...) or a claude.ai/code URL, queue a message into that existing session instead, with -p. See [send a follow-up message](/docs/en/claude-code-on-the-web#send-follow-ups-from-the-cli).
Anthropic's own wording. Read off CLI reference, captured 2026-08-28.
Presence across releases
The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Changelog entries naming it
-
v2.1.248Cloud sessions are told which files a sync changed underneath them
Cloud sessions are told which files a sync changed so Claude re-reads them before editing.
named in this entry
-
v2.1.247Cloud sessions can report which worker generation they are on
Cloud sessions track which worker generation they're on and re-register only after a worker restart.
named in this entry
-
v2.1.247File sync is not offered when the repository layout is unsupported
File sync is no longer offered for repository layouts it cannot actually handle.
named in this entry
-
v2.1.247Better explanation when a cloud checkout follows a branch change
When your cloud checkout's branch moves, Claude is now told who moved it and whether its commits followed.
named in this entry
-
v2.1.246Cloud sessions wait for the first file upload before sending your message
Cloud sessions hold your first message until your project files have actually uploaded.
named in this entry
-
v2.1.246Cloud sessions explain which of your hooks cannot be pinned
Cloud sessions now tell you which of your hooks couldn't be pinned and were skipped.
named in this entry
-
v2.1.246Forwarding your home settings to a cloud session now records explicit consent
Forwarding your home settings to a cloud session now records your consent separately from permission.
named in this entry
-
v2.1.246Cloud sessions started from your home directory cannot bind a device
Starting a cloud session in your home directory now blocks device linking and tells you to use a project folder.
named in this entry
-
v2.1.242
--printwith--cloudcan message an existing cloud sessionYou can now use --print with --cloud to message an existing cloud session.
named in this entry
-
v2.1.242Cloud-hosted sessions now refuse local CLI options instead of quietly dropping them
Running with --cloud now tells you which local CLI options were ignored or refused, and why.
named in this entry
-
v2.1.242Cloud sessions report queued commands dropped by an interrupt
Headless cloud clients now see a cancelled status for each queued command an interrupt dropped.
named in this entry
-
v2.1.238
claude --cloudexplains when your local changes cannot be uploadedclaude --cloudnow says why your local changes could not be uploaded and points you at--ref.named in this entry
-
v2.1.236A wire format for forwarding your local hooks into a cloud session, with nothing sending it
Your local hooks could be registered with a cloud session, but nothing sends the messages yet.
named in this entry
-
v2.1.232--project no longer starts a cloud session
Passing --project alone won't start a cloud session; --ref and --on-branch now need --cloud or --environment.
named in this entry
-
v2.1.232Headless cloud sessions wired up but unreachable
Running --cloud without a terminal is wired up but unreachable in this build.
named in this entry
-
v2.1.229Whitespace-only prompts are rejected for
--cloudand--environmentWhitespace-only prompts on
--cloudand--environmentare rejected instead of sent empty.named in this entry
-
v2.1.224
--teleportand--cloudshow up inclaude --help--teleportand--cloudnow show up inclaude --help.named in this entry
-
v2.1.224cloud CLI: piped stdin no longer silently overrides a task description
Piped input no longer silently overrides a task description you passed to --cloud.
named in this entry
-
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
-
v2.1.221--cloud reattach hint spelled out in the error
The --cloud conflict error now spells out how to pass a session id and where to find one.
named in this entry
Documentation pages
- CLI reference reference table Claude Code CLI
- Use Claude Code on the web mentions it Claude Code CLI
- Configure cloud environments mentions it Claude Code CLI
- Environment variables mentions it Claude Code CLI
- Claude Code with GitHub Enterprise Server mentions it Claude Code CLI
- Glossary mentions it Claude Code CLI
- Run Claude Code programmatically mentions it Claude Code CLI
- Overview mentions it Claude Code CLI
- Choose a sandbox environment mentions it Claude Code CLI
- Self-hosted environments mentions it Claude Code CLI
- Self-hosted environments quickstart mentions it Claude Code CLI
- Test self-hosted environments end to end mentions it Claude Code CLI
- Claude Code settings mentions it Claude Code CLI
A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.
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.