# settingSources Option

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

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** settingSources, setting_sources, Agent SDK settings isolation, Claude Agent SDK settingSources

## Think of it like

It is like picking which books a helper may read.

## 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

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

## Example code

```typescript
settingSources: []
```

Read no settings from disk.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [--setting-sources Flag](https://learn.benibix.com/term/ai/setting-sources-flag)
- [Claude Code Settings Precedence](https://learn.benibix.com/term/ai/settings-precedence)
- [CLAUDE.md](https://learn.benibix.com/term/ai/claude-md)
- [systemPrompt Option](https://learn.benibix.com/term/ai/system-prompt-option)

![What settingSources loads: left out, the agent reads user, project and local settings with CLAUDE.md and skills; set to an empty list, it reads none of them.](https://learn.benibix.com/diagrams/agent-sdk-setting-sources.svg)

---

Source: https://learn.benibix.com/term/ai/setting-sources-option
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-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
