Enum SettingSource 

pub enum SettingSource {
    User,
    Project,
    Local,
}

Controls which filesystem-based configuration sources the SDK loads settings from.

When setting_sources is omitted or None in ClaudeAgentOptions, the SDK does not load any filesystem settings, providing isolation for SDK applications.

Variants

• User — Global user settings (~/.claude/settings.json).
• Project — Shared project settings (.claude/settings.json), version controlled. Must be included to load CLAUDE.md files.
• Local — Local project settings (.claude/settings.local.json), typically gitignored.

Precedence

When multiple sources are loaded, settings merge with this precedence (highest first):

1. Local settings
2. Project settings
3. User settings

Programmatic options (e.g., agents, allowed_tools) always override filesystem settings.

Variants

User

Load user-level settings from the home directory.

Project

Load project-level shared settings.

Local

Load local project settings (typically not committed).

Trait Implementations

impl Clone for SettingSource

fn clone(&self) -> SettingSource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SettingSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SettingSource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SettingSource

fn eq(&self, other: &SettingSource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SettingSource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SettingSource

impl StructuralPartialEq for SettingSource