{"name":"--setting-sources","slug":"setting-sources","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Comma-separated list of setting sources to load (`user`, `project`, `local`). See [agent view](\/docs\/en\/agent-view#what-carries-over-when-you-background) and [agent teams](\/docs\/en\/agent-teams#context-and-communication) for the sessions you start from this one that inherit the list","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":{"version":"2.1.119","released_at":"2026-04-23 21:36:46","spans":6}},"aliases":[],"entries":[{"version":"2.1.290","anchor":"home-settings-seeded-to-cloud-sessions-ccr","heading":"Your home Claude settings can be sent to cloud sessions","line":"If you opt in, Claude Code can upload your personal CLAUDE.md, rules, output styles and settings to a cloud session you start","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.287","anchor":"plugin-install-replace-now-has-an-error-message-requiring","heading":"plugin install --replace explains that it needs a full plugin id","line":"Running `plugin install --replace` without a name@marketplace id now says that id is needed and that nothing was installed","released_at":"2026-10-01 16:59:25","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"claudemd-scan-skips-the-project-directory-walk-when-project","heading":"CLAUDE.md search skips project folders when project and local settings are off","line":"Claude Code no longer walks up your project folders looking for CLAUDE.md files when both project and local setting sources are turned off","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"sandbox-command-exclusions-are-refused-when-user-settings-ar","heading":"Sandbox exclusions now fail clearly when user settings are turned off","line":"Adding a sandbox command exclusion now fails with an explanation when user settings are off, instead of reporting a success that did nothing","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"hidden-managed-settings-flag-added-to-claude-agents-and","heading":"Hidden --managed-settings flag added to claude agents and forwarded to dispatched sessions","line":"`claude agents` gains a hidden `--managed-settings <json>` option that is passed on to sessions it starts","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"tmux-worktree-relaunch-absolutizes-path-arguments","heading":"--tmux worktree relaunch absolutizes path arguments","line":"When --tmux relaunches Claude Code for a worktree, relative file paths in flags are now turned into full paths","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"claude-agents-view-now-honours-settings-managed-setti","heading":"claude agents view now honours --settings, --managed-settings and setting sources","line":"`claude agents` now applies `--settings`, `--managed-settings` and `--setting-sources`","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"setting-sources-forwarded-to-child-processes","heading":"--setting-sources forwarded to child processes","line":"Claude Code can now turn its active setting sources back into a `--setting-sources=` argument","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.281","anchor":"managed-settings-is-carried-through-to-spawned-sessions","heading":"--managed-settings is carried through to spawned sessions; --setting-sources is accepted and discarded by one argument parser","line":"--managed-settings is now passed on to sessions Claude Code starts itself, while one parser reads --setting-sources and throws the value away","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"new-cli-internal-update-settings-tool-for-host-uis","heading":"New CLI-internal \"update_settings\" tool for host UIs","line":"A CLI-internal update_settings tool lets host UIs write settings the way \/config does, for now only outputStyle in project local settings.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text, named in this entry"}],"entries_total":18,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"agent-teams","title":"Orchestrate teams of Claude Code sessions","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"debug-your-config","title":"Debug your configuration","documented":false},{"source":"claude-code","path":"fullscreen","title":"Fullscreen rendering","documented":false},{"source":"claude-code","path":"mcp","title":"Connect Claude Code to tools via MCP","documented":false},{"source":"claude-code","path":"memory","title":"How Claude remembers your project","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"permissions","title":"Configure permissions","documented":false},{"source":"claude-code","path":"plugins\/loading","title":"Plugin loading reference","documented":false}],"docs_total":13,"gates":[],"related":[{"name":"--settings","slug":"settings","description":"Path to a settings JSON file or an inline JSON string. Values you set here override the same keys in your `settings.json` files for this session. Keys you omit keep their file-based values. The file must be a regular file no larger than 2 MiB. See [settings precedence](\/docs\/en\/settings#settings-precedence)"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/setting-sources","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}