# --setting-sources Flag

> It picks which settings files Claude Code reads.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --setting-sources

## Think of it like

It is like you pick which books to take to class.

## Definition

--setting-sources picks which settings files Claude Code reads: user, project, local, or a mix with commas. A CI job can skip a person's own user settings. Then each run acts the same. Sessions this one starts, such as background sessions and teammates, keep the same list.

## Example

Jack's CI should act the same on every runner. It uses --setting-sources project, so only the settings in the repo count.

## Example code

```bash
claude -p "Run the checks" --setting-sources project
```

Read only the project's shared settings.

## Why it matters

Runs stop depending on what one person put in their own settings.

## Common mistake

Thinking it turns off your admin's settings. It picks from user, project and local, and that is all.

## Three principles

- **user, project, local.** Pick any.
- **Same every run.** Good for CI.
- **Passed on.** To sessions it starts.

## Related terms

- [--settings Flag](https://learn.benibix.com/term/ai/settings-flag)
- [/config Command](https://learn.benibix.com/term/ai/config-command)

## Told apart from

- [--settings vs --setting-sources](https://learn.benibix.com/compare/settings-flag-vs-setting-sources-flag): People think --settings and --setting-sources do one job, and they do not. --settings adds one more layer of settings from a file or a string, and its values win over your files. --setting-sources picks which of your own files load at all: user, project or local. A CI run often uses both.

## Taught in

- [Tool and Settings Flags](https://learn.benibix.com/learn/ai-claude-code-commands/tool-and-settings-flags): Claude Code Commands, 15/17

![Settings in layers: managed on top, then --settings, then local, project and user.](https://learn.benibix.com/diagrams/flag-settings-layers.svg)

---

Source: https://learn.benibix.com/term/ai/setting-sources-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
