What
When Claude Code creates a cloud session (one that runs on another machine, for example with --remote), the request now says where the permission mode (how much Claude may do without asking) and the effort level came from. New fields personAskedForSession, isModeFromSettings and isEffortFromSettings tell an explicit request apart from a value that only came from your settings files.
- Self-hosted runners: if the session runs on a self-hosted runner (a machine your organization runs), a permission mode or effort that came from settings is no longer sent. Before, the permission mode was always sent. The result is marked with
settingsModeOnRunner(not_sentornot_pushed), withself_hosted_runnergiven as the reason. - Notice: new code compares the mode with and without your settings. If your settings' default permission mode doesn't apply on a self-hosted runner, a notice tells you to relaunch with
--permission-mode. It is shown as a warning when the mode isplan. The finder did not locate where this notice is called from. - Timing: the permission mode notice is now worked out after the session has been created, using the mode the runner reports, rather than only from the decision made before creation.
- Sign-in: attaching to and creating a cloud session now go through an extra authentication step first, and the access token is chosen from your profile (
consoleProfileBearer).
Why
The mode shown for a remote session may now match what the runner actually applied. On a self-hosted runner, a default mode in your local settings no longer carries over, so pass --permission-mode on launch if you want a specific mode there.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
> `--cloud` creates cloud sessions. `--remote-control` is unrelated: it lets you monitor and steer a local CLI session from claude.ai or the Claude app. See [Remote Control](/docs/en/remote-control).claude-code-on-the-web see the edit
Anthropic's documentation has since written up --remote, on Use Claude Code in the cloud.