Skip to content
BENIBIX Learn

--setting-sources Flag

Also known as claude --setting-sources

It picks which settings files Claude Code reads.

Think of it like

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

Example

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

Why it matters

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

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 code

bash
claude -p "Run the checks" --setting-sources project
Read only the project's shared settings.
--setting-sources picks which of the bottom three layers load.

Common mistake

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

Key takeaways

  1. 1
    user, project, local. Pick any.
  2. 2
    Same every run. Good for CI.
  3. 3
    Passed on. To sessions it starts.

Compare

Learn it properly