{"name":"--cloud","slug":"cloud","family":"cli","title":"CLI flags","noun":"CLI flag","description":"With a task description, create a new [cloud session](\/docs\/en\/claude-code-on-the-web). 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).","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":{"version":"2.1.166","released_at":"2026-06-05 19:01:59","spans":25}},"aliases":[],"entries":[{"version":"2.1.305","anchor":"cloud-with-a-named-resume-maps-resume-to-a-cloud-session","heading":"Groundwork for resuming a cloud session with --resume","line":"Code that would let `--resume` pick up a cloud session alongside `--cloud` is present but cannot be reached in this build","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"cloud-sessions-sign-in-screen-on-auth-failure-existing-ses","heading":"Cloud sessions can open a sign-in screen when sign-in fails","line":"If sign-in fails when starting a `--cloud` session, Claude Code can now show a sign-in screen and carry on instead of only printing an error","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"remote-session-login-hint-removed-login-handler-takes-a-k","heading":"\/login accepts an argument and drops its cloud-session workaround","line":"The cloud-session tip for `\/login` is gone, and `\/login` now reads an argument and reports when it does not recognise it","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"home-directory-cloud-binding-message-reworded","heading":"Clearer message when a folder can't be used for cloud sessions","line":"The message for a folder that can't be bound to cloud sessions now covers home folders, hidden folders and repositories rooted there","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"cloud-mcp-offer-gains-a-not-now-answer-that-re-asks-when-a","heading":"Sharing MCP servers with cloud sessions now has a \"Not now\" answer","line":"The prompt offering your MCP servers to claude --cloud sessions adds \"Not now\", which asks again once you add an MCP server","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.302","anchor":"cloud-session-and-refusal-messages-changed","heading":"New and reworded messages for cloud sessions and missing start folders","line":"Claude Code now explains how to open another cloud session and says plainly when a server's start folder no longer exists","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text"},{"version":"2.1.299","anchor":"cloud-cloud-and-tengu-remote-backend-handling","heading":"Internal rework of how --cloud sessions are started","line":"The code that starts cloud sessions with `--cloud` was reorganised, with no change you can see","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text"},{"version":"2.1.296","anchor":"remote-session-create-can-carry-a-builtin-tool-restriction","heading":"Cloud session creation is prepared to limit built-in tools, but nothing is limited yet","line":"Creating a session with --remote can now pass a built-in tool restriction, though in this version no restriction is ever sent","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"cloud-flag-selection-also-applies-with-an-environment-query","heading":"The --cloud form is now suggested in one more case","line":"Claude Code now uses the --cloud form in its hint text when an environment query is present, not only when a pool is","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"cloud-now-accepts-a-prompt-piped-on-stdin-or-a-positional","heading":"--cloud without a description can take the task from your prompt","line":"Claude Code now accepts `--cloud` with no description in more cases, using the starting prompt as the task","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"}],"entries_total":99,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"claude-code-on-the-web","title":"Use Claude Code in the cloud","documented":false},{"source":"claude-code","path":"cloud-environments","title":"Configure cloud environments","documented":false},{"source":"claude-code","path":"env-vars","title":"Environment variables","documented":false},{"source":"claude-code","path":"github-enterprise-server","title":"Claude Code with GitHub Enterprise Server","documented":false},{"source":"claude-code","path":"glossary","title":"Glossary","documented":false},{"source":"claude-code","path":"headless","title":"Run Claude Code programmatically","documented":false},{"source":"claude-code","path":"hipaa-setup","title":"Set up Claude Code (local mode) for a HIPAA-ready organization","documented":false},{"source":"claude-code","path":"overview","title":"Overview","documented":false},{"source":"claude-code","path":"plugins\/cli-hints","title":"Recommend your plugin from your CLI","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/cloud","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}