🧩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
Example code
typescript
settingSources: []Common mistake
Key takeaways
- 1user, project, local. The three sources.
- 2Left out loads all. Like the CLI.
- 3Empty list isolates. Policy still applies.