Settings 层级速查表

配置文件优先级

最高 ─→ 企业 managed settings
  │     Windows: C:\Program Files\ClaudeCode\managed-settings.json
  │     macOS:   /Library/Application Support/ClaudeCode/managed-settings.json
  │
  ├──→ CLI 参数
  │     claude --permission-mode auto
  │
  ├──→ 项目 .claude/settings.json
  │     （提交到 Git，团队共享）
  │
  └──→ 用户 ~/.claude/settings.json
最低     （个人偏好）

CLAUDE.md 层级

最高 ─→ 项目根目录 CLAUDE.md        （团队规范）
  │
  ├──→ 项目根目录 CLAUDE.local.md   （个人设置，gitignored）
  │
  ├──→ ~/.claude/CLAUDE.md          （跨项目偏好）
  │
  └──→ .claude/rules/*.md           （路径特定规则）
最低

settings.json 结构

{
  "permissions": {
    "allow": ["Bash(npm *)"],
    "deny": ["Bash(rm -rf *)"]
  },
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...],
    "Stop": [...]
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"]
    }
  }
}

.claude/rules/ frontmatter

---
paths:
  - "src/api/**/*.ts"    # glob 模式匹配
---

只在匹配路径的文件操作时加载这些规则。