[DOCS] autoApproveTools merge behaviors

Resolved 💬 3 comments Opened Nov 6, 2025 by atkinsonm Closed Jan 12, 2026

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/settings#settings-precedence

Section/Topic

Settings files (JSON)

Current Documentation

Precedence: Higher-level configurations (Enterprise) override lower-level ones (User/Project)
Inheritance: Settings are merged, with more specific settings adding to or overriding broader ones

What's Wrong or Missing?

The documentation is somewhat ambiguous about whether user-level settings override or merge with project-level settings. Specifically, my experience on Claude Code v2.0.34 is that project-level permissions.allow completely overrides user-level autoApproveTools, meaning it is often necessary to allowlist the same commands for every project.

Suggested Improvement

Clarify the behaviors where settings are overwritten versus merged with higher levels of precedence

Impact

Low - Minor confusion or inconvenience

Additional Context

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗