{"name":"--remote","slug":"remote","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Deprecated alias for `--cloud`, including the existing-session form","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"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, named in this entry"},{"version":"2.1.300","anchor":"remote-session-create-permission-mode-can-differ-on-the-run","heading":"Remote sessions now report the permission mode the remote machine actually applied","line":"When you create a `--remote` session, the permission mode notice is now worked out after the session exists, from what the runner applied","released_at":"2026-10-14 14:27:26","reason":"found in this entry's text, named in this entry"},{"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, named in this entry"},{"version":"2.1.292","anchor":"new-plugin-publish-operation-and-a-click-chain-fix","heading":"Clearer error when remote sign-in setup fails, plus a plugin publish name","line":"A failed sign-in setup with --remote now logs the real error, and a plugin_publish plugin operation name has been added","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text"},{"version":"2.1.287","anchor":"cloud-remote-now-checked-together-with-attach-serve-an","heading":"Claude Code recognises --cloud used with --attach-serve when loading settings","line":"Starting with `--cloud` or `--remote` plus `--attach-serve`, and without `-p`, now changes how some settings sources are treated","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text, named in this entry"},{"version":"2.1.287","anchor":"cloud-launch-refuses-when-it-would-need-the-keyboard","heading":"--cloud stops early when it would need a keyboard it can't read","line":"If `--cloud` would open a session in your terminal but there is no keyboard to read from, Claude Code now exits with an error before creating it","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text, named in this entry"},{"version":"2.1.285","anchor":"directory-sync-and-bundle-divergence-preflight-removed-from","heading":"Starting a cloud session no longer offers to sync your folder","line":"Launching with `--cloud` no longer runs the folder sync offer, local-change check or upload planning, and a new warning covers failed look-ups","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text, named in this entry"},{"version":"2.1.284","anchor":"new-remote-session-gates-tengu-violin-maple-tengu-violin-d","heading":"Cloud-session attach and folder sync get new remote switches","line":"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","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"claude-remote-can-now-serve-this-machines-tools-to-the","heading":"claude --remote can now offer this machine's tools to the cloud session","line":"When `claude --remote` starts a cloud session and stays attached, it can now make tools on your own machine available to that session","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"},{"version":"2.1.283","anchor":"remote-asks-new-consent-questions-local-mcp-servers-an","heading":"--remote can ask before sharing local MCP servers or serving tools unattended","line":"An attached `--remote` session can now ask whether to share your local MCP servers, and ask again before serving tools in auto or bypass mode","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text, named in this entry"}],"entries_total":24,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"api","path":"manage-claude\/compliance-content-data","title":"WARNING: This operation PERMANENTLY deletes the chat, all of its messages,","documented":false},{"source":"claude-code","path":"claude-code-on-the-web","title":"Use Claude Code in the cloud","documented":false},{"source":"claude-code","path":"errors","title":"Error reference","documented":false},{"source":"claude-code","path":"plugins\/cli-reference","title":"Plugin commands reference","documented":false},{"source":"claude-code","path":"remote-control","title":"Continue local sessions from any device with Remote Control","documented":false},{"source":"claude-code","path":"self-hosted-environments-configuration","title":"Customize sessions in self-hosted environments","documented":false},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/remote","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}