跳转到内容

配置概览

Claude Code 的配置按优先级从高到低合并:

Claude Code settings.json 从企业、命令行、本地、项目到用户的优先级示意图
越靠上的配置优先级越高;权限规则决定工具是否自动允许、需要询问或被阻止。
级别位置谁控制
Managed组织下发IT / 管理员
Command line启动参数当前命令
Local.claude/settings.local.json你本人(勿提交)
Project.claude/settings.json团队(可进 Git)
User~/.claude/settings.json你本人

冲突时:Managed 覆盖一切,其次是命令行参数、本地覆盖、项目配置、用户配置。具体字段仍以官方 Configuration 文档为准。

claude 会话中输入:

/config

可图形化查看与修改部分选项。

如果你想确认当前会话到底加载了哪些配置来源,使用:

/status

Status 面板会显示本轮会话读取到的 settings 来源,例如 User settings、Project settings 或 Managed settings。

我想…看哪里
统一团队权限Project settings.json
个人默认模型User settings
本机临时覆盖Local settings
企业强制策略Managed settings
本次命令临时指定行为CLI flags

.claude/settings.json

{
"permissions": {
"allow": ["Read", "Grep", "Glob"],
"deny": ["WebFetch"]
}
}

字段以官方 schema 为准,升级后可能有新增项。

  • User:你的个人偏好,例如默认行为、常用工具规则。
  • Project:团队希望每个人共享的规则,例如禁止修改某些目录、统一允许测试命令。
  • Local:只适合你这台机器的内容,例如本地路径、临时实验、不能提交的覆盖项。
  • Managed:组织级强制策略,通常由管理员维护。

不要把密钥写进 Project settings。项目级配置会进入 Git,适合共享规则,不适合共享凭据。