Claude Code 配置出错常见原因不是 JSON 语法，而是写错作用域。个人、项目和本地设置解决的是不同的共享范围：用户级影响本机所有项目，项目级供仓库协作者共享，本地级只影响你在当前仓库的使用。
先选作用域
| 文件 | 适合内容 | 是否提交 |
|---|---|---|
~/.claude/settings.json |
个人通用偏好 | 否 |
.claude/settings.json |
团队共同权限、插件和环境约定 | 通常是 |
.claude/settings.local.json |
当前用户在当前仓库的覆盖 | 否 |
先决定配置是否要共享给团队，再选择 settings.json 或 settings.local.json。
从最小 JSON 开始
{
"env": {
"APP_ENV": "development"
}
}保存前用 JSON 校验器检查逗号和引号。同一个键出现多次时，应先找更高优先级来源；组织管理策略还可能覆盖用户或项目设置。
确认实际生效值
保存后重开会话，用 /status 或 /config 查看实际值，并核对目标设置文件的 git 状态。项目级文件应出现在预期 diff 中，本地文件应保持不提交。若界面值与文件不同，逐层搜索同名键，不要同时改三处。
安全边界
不要把 API 密钥直接提交进项目设置文件。敏感值用操作系统环境变量、受控密钥系统或组织管理配置；提交前运行 git diff --cached 再看一遍。
资料与适用范围
设置范围和优先级参考 官方设置文档与设置字段参考。不同 Claude Code 版本支持的键可能变化；本文示例未在你的组织策略下验证。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/30869.html
