最近在梳理 Claude Code 的配置体系时，最容易被低估的文件之一就是.claude/settings.local.json。它不像CLAUDE.md那样负责给模型提供项目背景，也不像.claude/settings.json那样适合提交到仓库、统一团队行为。它更像一个贴在本机开发环境旁边的小控制台，专门处理个人偏好、机器差异、临时实验、局部权限放行这些不适合进入团队默认配置的东西。Claude Code 官方文档把配置分成多个 scope，User放在~/.claude/，作用于所有项目，Project放在仓库.claude/，会跟团队共享，Local则是.claude/settings.local.json，只影响当前仓库里的当前开发者，并且在 Claude Code 创建该文件时会被 Git 忽略。这个定位很关键，settings.local.json不是团队规则，而是个人覆盖层。官方也明确写到，Local scope 适合个人项目覆盖、共享前的配置测试、只在某台机器上成立的设置。(Claude)它不是另一个 settings.json，而是团队默认值上