Skip to content
BENIBIX Learn

settingSources Option

Also known as settingSources, setting_sources, Agent SDK settings isolation, Claude Agent SDK settingSources

The option that picks which settings the agent reads from disk.

Think of it like

It is like picking which books a helper may read.

Example

Mia's server runs agents for many customers. She passes an empty settingSources so no stray CLAUDE.md on the box changes them.

Why it matters

An agent that reads a stray file on the machine can act in ways you never set.

Definition

settingSources is the Agent SDK option that picks which settings on disk the agent loads. In Python it is setting_sources. The sources are user, project and local. Left out, the agent loads all three, with CLAUDE.md files, skills, hooks and subagents, the same as the CLI. An empty list loads none of them, though managed policy still applies.

Example code

typescript
settingSources: []
Read no settings from disk.
What the option loads, left out and empty.

Common mistake

Thinking the SDK loads nothing by default. Left out, it loads all three sources.

Key takeaways

  1. 1
    user, project, local. The three sources.
  2. 2
    Left out loads all. Like the CLI.
  3. 3
    Empty list isolates. Policy still applies.