规范文件

Claude Code 设置：用户、项目与单会话覆盖怎样排查

按设置来源定位实际值，分清本地覆盖、团队共享和 managed 配置，再判断该改哪个文件。

AI Nav City撰写 / 更新 2026年11月4日

修改 settings 后行为没变，常见原因是改错范围或有更高层设置。本文依据当前官方文档整理来源和排查顺序，目标是为一个设置写清当前值、来源与预期范围。适用于本机 Claude Code，不把终端规则推广到云会话。

核验日期: 2026年11月4日 · 未实测
适用于: Claude Code 适用于本机 Claude Code；官方页面未给统一版本门槛，以 2026-11-04 核验与实际界面为准。[1]
涉及工具: Claude Code

文件位置

路径	适用范围	读取方式
`./.claude/settings.local.json`	当前项目的个人覆盖；手工创建时检查 .gitignore。	项目本地设置优先于共享项目和用户设置，但低于 managed 与单会话 --settings。[1]

什么时候用

同一设置出现在多个文件，或个人试验影响了团队配置。[1]

什么时候不用

希望通过个人配置绕过 managed 限制，或需要云会话设置规则。[1]

先决定影响谁

用户级 ~/.claude/settings.json 影响本机各项目；共享 .claude/settings.json 适合提交给团队；.claude/settings.local.json 只用于个人当前项目。官方说明 Claude Code 自行创建本地文件时会排除 Git；手工创建时应自行检查 .gitignore。不要将凭据或个人机器路径写入团队共享文件。[1]

从最高层向下追来源

普通单值 key 的官方顺序为 managed、单会话 --settings、项目本地、共享项目、用户设置；列表通常合并，部分 key 有专属规则。CLI 其他 flags 与环境变量不应简单塞进这张顺序表，应逐键核对。managed 值通常优先，但官方列出少数例外：更严格的低层安全设置可能被采纳。先查该键的 Scope 和例外表，不用通用顺序推断所有权限规则。[1]

用合成配置做排查记录

原创练习：用户文件为某个普通 key 写 user-value，共享项目写 team-value，本地项目写 local-value。先列出三个来源，再核对是否还有单会话或 managed 来源；无更高层时预期本地值优先。此演算只说明 key 的来源关系，不替代实际 key 的 schema、合并或 flags 规则。[1]

改动后怎样确认

先确认 JSON 可解析、设置键存在于官方 reference，再按该键要求重新读取或启动会话，观察实际值。发现 managed 限制、未知键或意外共享范围时停止修改并核对。本文离线演算了三层普通 key 的优先顺序，没有读取私人设置、改文件、启动 Claude Code 或发起模型请求。[1]

来源

以下均为官方页面，核验日期见各条；链接指向核验时的版本。

Anthropic · Settings files and precedence
2026年11月4日

发现错误？告诉我们 →