设置层级(Settings layers)
合并各个设置文件的顺序。用图和例子讲清它是什么、怎么运作、怎么用，以及要注意什么。
它是什么
可能在好几个地方找到同一个设置，所以需要固定的顺序来决定哪个值生效。从高到低，各层依次是设置、--settings 、.claude/settings.local.json、.claude/settings.json 和 ~/.claude/settings.json。两层设置了同一个单一值（比如名）时，上层的生效。两层设置了同一个列表（比如 permissions.allow）时，Claude Code 会把列表合并，这样每个文件都能添加条目，又不会删掉别人的。这让组织、团队和每个人都能说上话，而不用抢同一个文件。
它怎么工作
-
Claude Code 读取所有设置文件
-
单一值以上层为准
-
各层的列表合并
-
用 /status 查看已加载文件
怎么使用
-
~/.claude/settings.json你在所有项目里的个人默认值。它是最低的一层。
-
.claude/settings.json到 的团队文件。在那个项目里它比你的用户文件优先。
-
.claude/settings.local.json你在一个项目里自己的覆盖设置。它比团队文件优先，也不会进你的提交。
-
claude --settings '{"spinnerTipsEnabled": true}'只为这一个会话设置一个键，优先于除托管设置之外的所有文件。
注意
环境变量不算一层。比如 里的 ANTHROPIC_MODEL 比任何文件里的 model 键都优先。少数安全相关的键，即使托管设置另有规定，也会接受下层更严格的值；还有少数列表键，比如 fallbackModel，是整个取用而不是合并。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准：如果两者不同，请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: Settings files and precedence — Settings precedence(在新窗口中打开)
- Anthropic — Claude Code docs: Settings files and precedence — Lists merge instead of overriding(在新窗口中打开)
- Anthropic — Claude Code docs: Settings files and precedence — Settings files and who they affect(在新窗口中打开)
- Anthropic — Settings — Where settings live(在新窗口中打开)