Settings
概述
Claude Code 的设置系统,通过多层级配置文件实现灵活的系统配置管理,包括用户级、项目级和本地级设置。
关键内容
- 四层配置结构:
- 企业策略层:企业管理员托管配置,影响所有用户、所有项目
- 用户全局层(~/.claude/settings.json):当前用户的所有项目范围
- 项目共享层(./.claude/settings.json):当前项目的所有成员(提交到 Git)
-
项目本地层(./.claude/settings.local.json):仅当前用户在此项目(加入 .gitignore)
-
优先级规则:
- 从高到低:项目本地层 > 项目共享层 > 用户全局层 > 企业策略层
-
项目级设置可以补充但不覆盖用户级设置
-
配置类型:
- 个人偏好和常用工具白名单(用户全局层)
- 团队级权限、项目级 Hooks、共享 MCP(项目共享层)
-
个人实验配置、临时覆盖(项目本地层)
-
版本控制考虑:
- 项目共享层设置提交到 Git,供团队共享
- 项目本地层设置加入 .gitignore,避免污染团队配置
来源
- 05_to_08_combined.md — 06 · 配置 & 权限系统
相关
- Configuration — relates_to
- Environment Variables — relates_to
- MCP — relates_to
- Claude Code — relates_to