{"name":"--forward-home-settings","slug":"forward-home-settings","family":"cli","title":"CLI flags","noun":"CLI flag","description":"The hidden --no-home-settings flag becomes --forward-home-settings true or false, so you can force it on.","description_source":"entry","described_by":{"version":"2.1.246","anchor":"no-home-settings-replaced-by-forward-home-settings-true-fals"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.309","builds":0,"mined_builds":150,"first_cited":{"version":"2.1.246","released_at":"2026-08-25 19:17:34","spans":3}},"aliases":[],"entries":[{"version":"2.1.307","anchor":"new-hidden-cli-flag-runner-declares","heading":"A new hidden --runner-declares command-line flag","line":"Claude Code now recognises a hidden `--runner-declares` flag, listed beside flags used for launching sessions elsewhere","released_at":"2026-10-21 20:47:18","reason":"found in this entry's text"},{"version":"2.1.293","anchor":"cloud-session-creation-settings-forwarding-consent-reworked","heading":"Cloud sessions now check consent before sending this machine's settings","line":"Whether creating a cloud session sends your machine's settings now depends on several consent signals, with a notice step in the terminal","released_at":"2026-10-07 17:18:04","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"cloud-and-pool-flags-no-longer-confuse-prompt-detection","heading":"Cloud and pool flags no longer confuse prompt detection","line":"Cloud flags like --pool and --ref no longer swallow their values as your prompt.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.246","anchor":"no-home-settings-replaced-by-forward-home-settings-true-fals","heading":"--no-home-settings replaced by --forward-home-settings <true|false>","line":"The hidden --no-home-settings flag becomes --forward-home-settings true or false, so you can force it on.","released_at":"2026-08-25 19:17:34","reason":"named in this entry, found in this entry's text"},{"version":"2.1.246","anchor":"forwarding-your-home-settings-to-a-cloud-session-now-records","heading":"Forwarding your home settings to a cloud session now records explicit consent","line":"Forwarding your home settings to a cloud session now records your consent separately from permission.","released_at":"2026-08-25 19:17:34","reason":"named in this entry, found in this entry's text"}],"entries_total":5,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"--forward-subagent-text","slug":"forward-subagent-text","description":"Emit [subagent](\/docs\/en\/sub-agents) text and thinking blocks in the output stream as `assistant` and `user` messages with `parent_tool_use_id` set, so you can reconstruct each subagent's transcript. Without this flag, Claude Code omits the text and thinking blocks of a subagent that runs in the [foreground](\/docs\/en\/sub-agents#run-subagents-in-foreground-or-background). Requires `--print` and `--output-format stream-json`. Claude Code also forwards messages from [nested subagents](\/docs\/en\/sub-agents#let-subagents-spawn-their-own-subagents), setting `parent_tool_use_id` to the ID of the Agent or Skill tool call that started each one; this requires Claude Code v2.1.219 or later, and messages of subagents that a forked skill spawns, and of nested forked skills, require v2.1.275 or later. The [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](\/docs\/en\/env-vars) environment variable enables the same behavior. Requires Claude Code v2.1.211 or later"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/forward-home-settings","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}