What
Remote Control lets you start Claude Code sessions from elsewhere. Running claude remote-control starts a parent process that launches child sessions.
--settings <file>is a new option forclaude remote-control: a JSON settings file for the sessions it spawns, read once at start. It is passed to each child session as--settings=<file>.- It must come straight after
remote-control. It is an error if it follows--or an option that needs a value. If you put it beforeremote-control, the error now suggestsclaude remote-control --settings <file>, next to the existing--permission-modehint. - Remote Control refuses to start if the file has parse errors or cannot be pinned, saying sessions would skip part or all of the --settings file.
- With it, sessions started from a project do not get the auto-compact or auto mode that Remote Control otherwise turns on for them.
- Settings pinning: the parent records a fingerprint of the file in
CLAUDE_CODE_BRIDGE_SETTINGS_BINDING. If the file changed since Remote Control started, or the record is damaged, the child session does not start. - Start folder check: the parent puts the checked folder in
CLAUDE_CODE_BRIDGE_CHILD_START_DIR. If the child's real folder differs, it exits with code 78, saying the folder "is no longer where it was when it was checked (moved, removed, or replaced with a link)". - These variables are passed on to child processes. A new
CLAUDE_CODE_NOTIFICATIONS_HOSTsits next toCLAUDE_CODE_MCP_APPS_HOSTin the same lists; what reads it was not seen. - Registration now carries a device ID and advertises directory browsing. When input closes, the spawn-mode prompt says you can run
claude remote-controland choose, or pass--spawn=same-diror--spawn=worktree.
Why
You can control the settings of every session Remote Control starts. A settings file or folder swapped after Remote Control checked it stops the session instead of being used.
Names in the bundle--settings
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.
Confirmed since
Anthropic's documentation has since written up --settings, on Speed up responses with fast mode.
* **In non-interactive mode**: pass Fable 5.2 as [`--model`](https://code.claude.com/docs/en/cli-reference#cli-flags) and fast mode in [`--settings`](https://code.claude.com/docs/en/cli-reference#cli-flags), for example `claude -p "Summari…fast-mode see the edit
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up --settings, on Speed up responses with fast mode.
Anthropic's release notes agree
Added --settings <file> to claude remote-control, which applies a settings file to every session it starts; if the file changes, no new…