--forward-home-settings
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.
The hidden --no-home-settings flag becomes --forward-home-settings true or false, so you can force it on.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.246.
In the changelogs
5Releases whose published page names --forward-home-settings.
-
v2.1.307
A new hidden
--runner-declarescommand-line flagClaude Code now recognises a hidden
--runner-declaresflag, listed beside flags used for launching sessions elsewherefound in this entry's text
-
v2.1.293
Cloud sessions now check consent before sending this machine's settings
Whether creating a cloud session sends your machine's settings now depends on several consent signals, with a notice step in the terminal
found in this entry's text
-
v2.1.248
Cloud and pool flags no longer confuse prompt detection
Cloud flags like --pool and --ref no longer swallow their values as your prompt.
found in this entry's text
-
v2.1.246
--no-home-settingsreplaced by--forward-home-settings <true|false>The hidden --no-home-settings flag becomes --forward-home-settings true or false, so you can force it on.
named in this entry, found in this entry's text
-
v2.1.246
Forwarding 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, found in this entry's text
First cited
3The earliest release whose published evidence quoted --forward-home-settings was v2.1.246, 25 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The 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.
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.