Type: concept
Confidence: 0.80
Created: 2026-04-25
Updated: 2026-04-25
Tags: configurationsettingsmanagementAI工程

Settings

概述

Claude Code 的设置系统,通过多层级配置文件实现灵活的系统配置管理,包括用户级、项目级和本地级设置。

关键内容

  1. 四层配置结构
  2. 企业策略层:企业管理员托管配置,影响所有用户、所有项目
  3. 用户全局层(~/.claude/settings.json):当前用户的所有项目范围
  4. 项目共享层(./.claude/settings.json):当前项目的所有成员(提交到 Git)
  5. 项目本地层(./.claude/settings.local.json):仅当前用户在此项目(加入 .gitignore)

  6. 优先级规则

  7. 从高到低:项目本地层 > 项目共享层 > 用户全局层 > 企业策略层
  8. 项目级设置可以补充但不覆盖用户级设置

  9. 配置类型

  10. 个人偏好和常用工具白名单(用户全局层)
  11. 团队级权限、项目级 Hooks、共享 MCP(项目共享层)
  12. 个人实验配置、临时覆盖(项目本地层)

  13. 版本控制考虑

  14. 项目共享层设置提交到 Git,供团队共享
  15. 项目本地层设置加入 .gitignore,避免污染团队配置

来源

相关