[DOCS] autoApproveTools merge behaviors
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_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗